Getting Started

Installation

Vous pouvez utiliser notre configuration assistée par l'IA pour installer le plugin. Ajoutez les Capgo compétences à votre outil IA à l'aide de 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 à la plateforme ci-dessous :

1. Installer le package

   bun add @capgo/capacitor-intune

2. Synchroniser les projets natifs

   bunx cap sync

3. Completer la configuration native Intune Suivre la documentation dédiée Configuration iOS et Configuration Android Les pages. Intune nécessite encore une configuration d'application-hôte native pour l'autorisation 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 Intune d'Ionic indiquent actuellement une limite de janvier 2026 pour les applications créées avec Xcode 26, nécessitant un SDK iOS Intune 21.1.0+Cela. Ce plugin 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): Enregistrez le compte MSAL avec Intune et déclenchez l'inscription.
• loginAndEnrollAccount(): Laissez Intune gérer le flux de connexion et d'inscription.
• appConfig(user): Lisez les valeurs de configuration de l'application Intune pour le compte.
• getPolicy(user): Lisez la politique de protection de l'application Intune actuelle pour le compte.
• groupName(user): Lisez la valeur de l'assistant de configuration commune lorsqu'elle est présente. GroupName : Inspectez les versions bundlées d'Intune et de MSAL.
• sdkVersion()Remarques sur la plateforme

Section intitulée « Remarques sur la plateforme »

• Les deux iOS et Android nécessitent une configuration de projet native au-delà de
• Votre inscription Azure, votre affectation de politique Intune, vos URIs de redirection et vos autorisations restent spécifiques à l'application. cap sync.
• Platform Notes

Continuez de là

Si vous utilisez Getting Started pour planifier la migration et les opérations d'entreprise, connectez-l’à Utilisation de @capgo/capacitor-intune pour la capacité native dans Utilisation de @capgo/capacitor-intune, Capgo Entreprise for the product workflow in Capgo Enterprise, pour le flux de travail du produit dans __CAPGO_KEEP_0__ Entreprise, Alternatives de plugin d'entreprise Ionic Capgo Alternatives pour le flux de travail du produit dans Capgo Alternatives, et Capgo Consulting pour le flux de travail du produit dans Capgo Consulting.