Aller au contenu

Prise en main

GitHub

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 :

Fenêtre de terminal
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 :

  1. Installer le package

    Fenêtre de terminal
    bun add @capgo/capacitor-intune
  2. Synchroniser les projets natifs

    Fenêtre de terminal
    bunx cap sync
  3. Finaliser la configuration native d'Intune Suivez les pages dédiées Configuration iOS et Configuration Android Intune nécessite toujours une configuration native de l’app hôte pour l’authentification déléguée, les URI de redirection, les manifests, les entitlements et la configuration MSAL.

import { IntuneMAM } from '@capgo/capacitor-intune';
const result = await IntuneMAM.acquireToken({ scopes: ['openid'] });
// The result holds sensitive values: use it without logging it.
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.
import { IntuneMAM } from '@capgo/capacitor-intune';
await IntuneMAM.registerAndEnrollAccount({ accountId: 'account-id-123' });
  • É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.
  • Capacitor 8+
  • Android avec Intune Android SDK 12.0.3
  • iOS avec Intune iOS SDK 21.5.1
  • Cible de déploiement iOS 17.0+

La doc Intune d'Ionic mentionne une date limite au 19 janvier 2026 pour les apps compilées avec Xcode 26, qui exigent Intune iOS SDK 21.1.0+. Ce plugin utilise déjà 21.5.1.

import { IntuneMAM } from '@capgo/capacitor-intune';
await IntuneMAM.addListener('appConfigChange', (result) => {
console.log('App config changed', result.accountId);
});
await IntuneMAM.addListener('policyChange', (result) => {
console.log('Policy changed', result.accountId);
});
const auth = await IntuneMAM.acquireToken({
scopes: ['https://graph.microsoft.com/.default'],
loginHint: 'alex@example.com',
});
await IntuneMAM.registerAndEnrollAccount({
accountId: auth.accountId,
});
const appConfig = await IntuneMAM.appConfig({
accountId: auth.accountId,
});
const policy = await IntuneMAM.getPolicy({
accountId: auth.accountId,
});
console.log({ auth, appConfig, policy });
const auth = await IntuneMAM.acquireToken({
scopes: ['https://graph.microsoft.com/.default'],
});
await IntuneMAM.registerAndEnrollAccount({
accountId: auth.accountId,
});

Rafraîchissement silencieux du token

Section intitulée « Silent token refresh »
const token = await IntuneMAM.acquireTokenSilent({
accountId: 'AAD_OBJECT_ID',
scopes: ['https://graph.microsoft.com/.default'],
forceRefresh: true,
});
const user = await IntuneMAM.enrolledAccount();
await IntuneMAM.logoutOfAccount({ accountId: 'AAD_OBJECT_ID' });
await IntuneMAM.deRegisterAndUnenrollAccount({ accountId: 'AAD_OBJECT_ID' });
  • acquireToken(options): Lancer la connexion Microsoft et renvoyer le token ainsi que les métadonnées du compte.
  • acquireTokenSilent(options): Lire un token mis en cache pour un compte existant.
  • registerAndEnrollAccount(options): Enregistrer le compte MSAL auprès d'Intune et déclencher l'inscription.
  • loginAndEnrollAccount(): Laisser Intune gérer le flux de connexion et d'inscription.
  • appConfig(user): Lire les valeurs de configuration d'application Intune pour le compte.
  • getPolicy(user): Lire la politique de protection d'application Intune actuelle pour le compte.
  • groupName(user): Lire les problèmes courants GroupName configuration lorsqu'elle est présente.
  • sdkVersion(): Inspectez les versions d'Intune et de MSAL du bundle.
  • Le Web n'est pas pris en charge.
  • iOS et Android nécessitent tous deux une configuration du projet natif au-delà de cap sync.
  • Votre enregistrement Azure, l'attribution de la politique Intune, les URI de redirection et les droits restent spécifiques à l'application.

Si vous utilisez Prise en main pour planifier la migration et les opérations d'entreprise, connectez-l’à Utiliser @capgo/capacitor-intune pour la fonctionnalité native dans l'utilisation de @capgo/capacitor-intune, Capgo Entreprise pour le workflow produit dans Capgo Enterprise, Alternatives aux plugins Ionic Enterprise pour le workflow produit dans les alternatives aux plugins Ionic Enterprise, Alternatives Capgo pour le workflow produit dans les alternatives Capgo, et Conseil Capgo pour le workflow produit chez Capgo Consulting.