Démarrage

Installation

Vous pouvez utiliser notre configuration assistée par l'IA pour installer le plugin. Ajoutez les Capgo compétences à votre outil d'IA en utilisant la commande suivante :

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

Ensuite, utilisez la prompt suivante :

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 la configuration manuelle, installez le plugin en exécutant les commandes suivantes et suivez les instructions spécifiques au plateforme ci-dessous :

1. Installez le package

   bun add @capgo/capacitor-intune

2. Synchroniser les projets natifs

   bunx cap sync

3. Completer la configuration native d'Intune Suivre les pages dédiées Configuration iOS et Configuration Android Les pages d'Intune nécessitent toujours une configuration d'application-hôte native pour l'authentification brokerée, les URIs de redirection, les manifestes, les autorisations et la configuration MSAL.

Exigences

• 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+

Les documents d'Intune d'Ionic indiquent actuellement une limite de janvier 2026 pour les applications construites avec Xcode 26, nécessitant Intune iOS SDK 21.1.0+ Cette extension utilise déjà 21.5.1.

Utilisation de base

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 });

Flux courants

Connexion interactive et inscription

const auth = await IntuneMAM.acquireToken({
  scopes: ['https://graph.microsoft.com/.default'],
});

await IntuneMAM.registerAndEnrollAccount({
  accountId: auth.accountId,
});

Rafraîchissement de jeton silencieux

const token = await IntuneMAM.acquireTokenSilent({
  accountId: 'AAD_OBJECT_ID',
  scopes: ['https://graph.microsoft.com/.default'],
  forceRefresh: true,
});

Lire le compte actuellement inscrit

const user = await IntuneMAM.enrolledAccount();

Se déconnecter ou effacer sélectivement

await IntuneMAM.logoutOfAccount({ accountId: 'AAD_OBJECT_ID' });
await IntuneMAM.deRegisterAndUnenrollAccount({ accountId: 'AAD_OBJECT_ID' });

API Résumé

• acquireToken(options): Demander l'authentification Microsoft et retourner le jeton ainsi que les métadonnées du compte.
• acquireTokenSilent(options): Lire un jeton en cache pour un compte existant.
• registerAndEnrollAccount(options): S'inscrire le compte MSAL avec Intune et déclencher l'enregistrement.
• loginAndEnrollAccount(): Laisser Intune diriger la flux d'authentification et d'enregistrement.
• appConfig(user): Lire les valeurs de configuration de l'application Intune pour le compte.
• getPolicy(user): Lire la politique de protection de l'application Intune actuelle pour le compte.
• groupName(user): Lire la valeur de l'aide au config commun lorsque présente. GroupName : Examiner les versions intégrées de Intune et de MSAL.
• sdkVersion()Remarques sur la plateforme

protectedTokens

• Le web n'est pas pris en charge.
• Les deux iOS et Android nécessitent une configuration de projet natif au-delà de cap sync.
• Votre inscription Azure, votre affectation de politique Intune, vos URIs de redirection et vos autorisations restent spécifiques à l'application.

Continuez de « Getting Started »

Si vous utilisez Getting Started pour planifier la migration et les opérations d'entreprise, connectez-le avec Utilisation de @capgo/capacitor-intune pour la capacité native dans Utilisation de @capgo/capacitor-intune, Capgo Entreprise pour le flux de produit dans Capgo Enterprise, Alternatives du plugin Ionic Enterprise pour le flux de produit dans Alternatives du plugin Ionic Enterprise, Capgo Alternatives pour le flux de produit dans Capgo Alternatives, et Capgo Consulting pour le flux de produit dans Capgo Consulting.