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 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 à la plateforme ci-dessous.

1. Installer le package

   bun add @capgo/capacitor-intune

2. Synchroniser les projets natifs

   bunx cap sync

3. Terminer la configuration native Intune Suivre la documentation dédiée Configuration iOS et Configuration Android La configuration de l'application hôte native est toujours requise 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 signalent actuellement un seuil de janvier 19, 2026 pour les applications construites avec Xcode 26, nécessitant Intune iOS SDK 21.1.0+. Cette 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électionnellement

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

API Résumé

• acquireToken(options): Start Microsoft sign-in and return token plus account metadata.
• acquireTokenSilent(options): Lire un jeton en cache pour un compte existant.
• registerAndEnrollAccount(options): Enregistrer le compte MSAL avec Intune et déclencher l'enregistrement.
• loginAndEnrollAccount(): Laisser Intune piloter 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): Lisez les informations communes GroupName config helper value when present.
• sdkVersion(): Inspectez les versions Intune et MSAL embarquées.

Remarques sur la plateforme

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

Continuez d'où vous en êtes avec Getting Started

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