Guide
Comment utiliser Persona dans Capacitor
Utiliser @capgo/capacitor-intune
Plugin Capacitor pour l'enrôlement Microsoft Intune MAM, les politiques de protection d'app, la configuration d'app et l'authentification MSAL.
Installer
bun add @capgo/capacitor-intune
bunx cap sync
bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.
Importer
import { IntuneMAM } from '@capgo/capacitor-intune';
API en un coup d'œil
| Méthode | Description |
|---|---|
acquireToken |
Présente le flux de connexion Microsoft et renvoie un token d'accès ainsi que les métadonnées du compte. |
acquireTokenSilent |
Récupère un token depuis le cache MSAL pour un utilisateur déjà connecté. |
registerAndEnrollAccount |
Enregistre un compte précédemment authentifié auprès d'Intune et lance l'enrôlement. |
loginAndEnrollAccount |
Demander à Intune d'authentifier et d'enrôler un utilisateur sans demander de token d'application au préalable. |
enrolledAccount |
Renvoie le compte Intune actuellement enrôlé, si disponible. |
deRegisterAndUnenrollAccount |
Désenregistre le compte d'Intune et déclenche un effacement sélectif le cas échéant. |
logoutOfAccount |
Déconnecte l'utilisateur de MSAL sans désenrôler le compte Intune. |
appConfig |
Récupère la configuration d'application Intune distante pour un compte géré. |
getPolicy |
Récupérez la politique de protection d'application Intune actuellement appliquée pour un compte géré. |
groupName |
Assistant pratique qui résout la GroupName valeur de configuration de l'app si elle est présente. |
sdkVersion |
Retourne les versions natives d'Intune et de MSAL SDK incluses dans ce plugin. |
displayDiagnosticConsole |
Affiche l'interface de diagnostic native d'Intune. |
Exemples
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ésenregistre le compte d'Intune et déclenche un effacement sélectif le cas échéant.
import { IntuneMAM } from '@capgo/capacitor-intune';
await IntuneMAM.deRegisterAndUnenrollAccount({ accountId: 'account-id-123' });
Le tableau ci-dessus liste les 12 méthodes principales. Les helpers de version et de listener, ainsi que le contrat complet de chaque méthode, sont documentés dans la dépôt GitHub.
Écouter les événements
addListener renvoie un handle. Appelez handle.remove() lorsque l'écran est démonté, ou IntuneMAM.removeAllListeners() pour supprimer chaque écouteur.
Référence complète
Continuer avec l'utilisation de @capgo/capacitor-intune
Si vous utilisez Utilisation de @capgo/capacitor-intune pour planifier l'authentification et les flux de comptes, connectez-l’à @capgo/capacitor-intune pour les détails d'implémentation dans @capgo/capacitor-intune, Premiers pas pour les détails d'implémentation dans Premiers pas, @capgo/capacitor-social-login pour le détail d'implémentation dans @capgo/capacitor-social-login, @capgo/capacitor-passkey pour les détails d'implémentation dans @capgo/capacitor-passkey, et @capgo/capacitor-native-biometric pour les détails d'implémentation dans @capgo/capacitor-native-biometric.