Guide
Comment utiliser Intune 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';
Aperçu de API
| Méthode | Description |
|---|---|
acquireToken |
Lance le flux de connexion Microsoft et retourne 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 |
Retourne le compte Intune actuellement enrôlé, si disponible. |
deRegisterAndUnenrollAccount |
Désenregistrez le compte d'Intune et déclenchez un effacement sélectif le cas échéant. |
logoutOfAccount |
Déconnectez l'utilisateur de MSAL sans désinscrire le compte Intune. |
appConfig |
Récupérez la configuration d'application Intune distante pour un compte géré. |
getPolicy |
Récupère la politique de protection d'application Intune en vigueur pour un compte géré. |
groupName |
Fonction utilitaire qui résout la GroupName valeur de configuration de l'app si présente. |
sdkVersion |
Retourne les versions natives d'Intune et de MSAL SDK embarquées par 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é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' });
Le tableau ci-dessus liste les 12 méthodes principales. Les helpers de listener et de version, 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() lors du démontage de l'écran, ou IntuneMAM.removeAllListeners() pour supprimer tous les listeners.
Référence complète
Continuer depuis « Utiliser @capgo/capacitor-intune »
Si vous utilisez Utiliser @capgo/capacitor-intune pour planifier les flux d'authentification et de compte, le connecter à @capgo/capacitor-intune pour les détails d'implémentation dans @capgo/capacitor-intune, Prise en main pour les détails d'implémentation dans Getting Started @capgo/capacitor-social-login pour les détails 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.