Prise en main

Installer

Vous pouvez utiliser notre configuration assistée par IA pour installer le plugin. Ajoutez les skills Capgo à votre outil d'IA avec la commande suivante :

bunx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Utilisez ensuite le prompt suivant :

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-intune` plugin in my project.

Si vous préférez une installation manuelle, installez le plugin en exécutant les commandes suivantes et suivez les instructions spécifiques à chaque plateforme ci-dessous :

bun add @capgo/capacitor-intune
bunx cap sync

Importer

import { IntuneMAM } from '@capgo/capacitor-intune';

Démarrage rapide

import { Persona } from '@capgo/capacitor-persona';

await Persona.startInquiry({});

Erreurs courantes

• Écouteurs: supprimez les handles lors du démontage des écrans.
• Sync native : exécuter bunx cap sync après les mises à jour du plugin.
• Source de vérité : fiez-vous src/definitions.ts au repo GitHub.

Aperçu de API

acquireToken

Lance le flux de connexion Microsoft et retourne un token d'accès ainsi que les métadonnées du compte.

import { IntuneMAM } from '@capgo/capacitor-intune';

const result = await IntuneMAM.acquireToken({ scopes: ['openid'] });
// The result holds sensitive values: use it without logging it.

acquireTokenSilent

Récupère un token depuis le cache MSAL pour un utilisateur déjà connecté.

import { IntuneMAM } from '@capgo/capacitor-intune';

const result = await IntuneMAM.acquireTokenSilent({
  scopes: ['openid'],
  accountId: 'acquireToken',
});
// The result holds sensitive values: use it without logging it.

registerAndEnrollAccount

Enregistre un compte précédemment authentifié auprès d'Intune et lance l'enrôlement.

import { IntuneMAM } from '@capgo/capacitor-intune';

await IntuneMAM.registerAndEnrollAccount({ accountId: 'account-id-123' });

loginAndEnrollAccount

Demander à Intune d'authentifier et d'enrôler un utilisateur sans demander de token d'application au préalable.

import { IntuneMAM } from '@capgo/capacitor-intune';

await IntuneMAM.loginAndEnrollAccount();

enrolledAccount

Retourne le compte Intune actuellement enrôlé, si disponible.

import { IntuneMAM } from '@capgo/capacitor-intune';

const result = await IntuneMAM.enrolledAccount();
console.log(result);

deRegisterAndUnenrollAccount

Désenregistrez le compte d'Intune et déclenchez un effacement sélectif le cas échéant.

import { IntuneMAM } from '@capgo/capacitor-intune';

await IntuneMAM.deRegisterAndUnenrollAccount({ accountId: 'account-id-123' });

logoutOfAccount

Déconnectez l'utilisateur de MSAL sans désinscrire le compte Intune.

import { IntuneMAM } from '@capgo/capacitor-intune';

await IntuneMAM.logoutOfAccount({ accountId: 'account-id-123' });

appConfig

Récupérez la configuration d'application Intune distante pour un compte géré.

import { IntuneMAM } from '@capgo/capacitor-intune';

const result = await IntuneMAM.appConfig({ accountId: 'account-id-123' });
console.log(result);

getPolicy

Récupère la politique de protection d'application Intune en vigueur pour un compte géré.

import { IntuneMAM } from '@capgo/capacitor-intune';

const result = await IntuneMAM.getPolicy({ accountId: 'account-id-123' });
console.log(result);

groupName

Fonction utilitaire qui résout la GroupName valeur de configuration de l'app si présente.

import { IntuneMAM } from '@capgo/capacitor-intune';

const result = await IntuneMAM.groupName({ accountId: 'account-id-123' });
console.log(result);

sdkVersion

Retourne les versions natives d'Intune et de MSAL SDK embarquées par ce plugin.

import { IntuneMAM } from '@capgo/capacitor-intune';

const result = await IntuneMAM.sdkVersion();
console.log(result);

displayDiagnosticConsole

Affiche l'interface de diagnostic native d'Intune.

import { IntuneMAM } from '@capgo/capacitor-intune';

await IntuneMAM.displayDiagnosticConsole();

Référence de type

AcquireTokenOptions

Options d’acquisition interactive de token.

export interface AcquireTokenOptions {
  /**
   * Scopes to request, for example `https://graph.microsoft.com/.default`.
   */
  scopes: string[];

  /**
   * When true, always show the Microsoft account picker or sign-in UI.
   *
   * @default false
   */
  forcePrompt?: boolean;

  /**
   * Optional login hint for the interactive sign-in flow.
   */
  loginHint?: string;
}

IntuneMAMAcquireToken

export interface IntuneMAMAcquireToken {
  accountId: string;
  accessToken: string;
  accountIdentifier: string;
  idToken?: string;
  username?: string;
  tenantId?: string;
  authority?: string;
}

AcquireTokenSilentOptions

Options d’acquisition silencieuse de token.

export interface AcquireTokenSilentOptions {
  /**
   * Scopes to request, for example `https://graph.microsoft.com/.default`.
   */
  scopes: string[];

  /**
   * Microsoft Entra object ID returned by `acquireToken` or `enrolledAccount`.
   */
  accountId: string;

  /**
   * When true, bypass the cached access token and request a fresh one.
   *
   * @default false
   */
  forceRefresh?: boolean;
}

RegisterAndEnrollAccountOptions

export interface RegisterAndEnrollAccountOptions {
  /**
   * Microsoft Entra object ID returned by `acquireToken`.
   */
  accountId: string;
}

IntuneMAMUser

export interface IntuneMAMUser {
  accountId: string;
  accountIdentifier?: string;
  username?: string;
  tenantId?: string;
  authority?: string;
}

IntuneMAMAppConfig

export interface IntuneMAMAppConfig {
  accountId: string;
  fullData: Record<string, string>[];
  values: Record<string, string>;
  conflicts: string[];
}

IntuneMAMPolicy

export interface IntuneMAMPolicy {
  accountId: string;
  isPinRequired?: boolean;
  isManagedBrowserRequired?: boolean;
  isScreenCaptureAllowed?: boolean;
  isContactSyncAllowed?: boolean;
  isAppSharingAllowed?: boolean;
  isFileEncryptionRequired?: boolean;
  notificationPolicy?: string;
}

IntuneMAMGroupName

export interface IntuneMAMGroupName {
  accountId: string;
  groupName?: string;
}

IntuneMAMVersionInfo

export interface IntuneMAMVersionInfo {
  platform: 'ios' | 'android';
  intuneSdkVersion: string;
  msalVersion?: string;
}

IntuneMAMChangeEvent

export interface IntuneMAMChangeEvent {
  accountId?: string;
}

Source de vérité

Cette page est générée à partir de src/definitions.ts. Relancez la synchronisation lorsque l’API public change en amont.

Continuer depuis Getting Started

Si vous utilisez Prise en main pour planifier les opérations du dashboard et de API, connectez-l’avec Utiliser @capgo/capacitor-intune pour la fonctionnalité native dans l'utilisation de @capgo/capacitor-intune, Aperçu de API pour les détails d'implémentation dans « Vue d'ensemble de API », Introduction pour les détails d'implémentation dans l'introduction, Clés API pour les détails d'implémentation dans « Clés API », et Appareils pour les détails d'implémentation dans Devices.