Getting Started

Installation

You can use our AI-Assisted Setup to install the plugin. Add the Capgo skills to your AI tool using the following command:

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 les instructions dédiées iOS setup et Android setup pages. Intune nécessite encore une configuration native de l'application hôte pour l'authentification par intermédiaire, les URIs de redirection, les manifestes, les autorisations et la configuration MSAL.

Requis

• 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 construites avec Xcode 26, nécessitant Intune iOS SDK 21.1.0+. 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 et inscription interactifs

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

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

Rafraîchissement silencieux du jeton

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

Déconnecter ou effacer sélection

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): Enregistrer le compte MSAL avec Intune et déclencher l'inscription.
• loginAndEnrollAccount(): Laisser Intune piloter le flux de connexion et d'inscription.
• appConfig(user): Lire les valeurs de configuration de l'application Intune pour le compte.
• getPolicy(user): Lisez la politique de protection d'application Intune actuelle pour le compte.
• groupName(user): Lire la valeur de l'assistant de configuration commune lorsque celle-ci est présente. GroupName : Inspectez les versions de Intune et MSAL embarquées.
• sdkVersion()Remarques de plateforme

Sous-section intitulée « Remarques de plateforme »

• iOS et Android nécessitent toutes deux 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.
• Continuez de la section « Getting Started »

Sous-section intitulée « Continuez de la section « Getting Started » »

If you are using Démarrage pour planifier la migration et les opérations d'entreprise, connectez-le à En utilisant @capgo/capacitor-intune pour la capacité native dans En utilisant @capgo/capacitor-intune, Capgo Entreprise pour le flux de travail du produit dans Capgo Entreprise, Alternatives d'extension d'entreprise d'Ionic pour le flux de travail du produit dans Alternatives d'extension d'entreprise d'Ionic, Capgo Alternatives pour le flux de travail du produit dans Capgo Alternatives, et Consultation de Capgo pour le flux de travail du produit dans Consultation de Capgo.