Prise en main

Installation

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 :

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

   bun add @capgo/capacitor-intune

2. Synchroniser les projets natifs

   bunx cap sync

3. Terminer la configuration native d'Intune Suivez la procédure dédiée Configuration iOS et Configuration Android les pages. Intune nécessite toujours une configuration native de l'application hôte pour l'authentification via broker, les URI de redirection, les manifests, les entitlements et la config MSAL.

Démarrage rapide

import { IntuneMAM } from '@capgo/capacitor-intune';

const result = await IntuneMAM.acquireToken({ scopes: ['openid'] });
// The result holds sensitive values: use it without logging it.

Exemple : acquireTokenSilent

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.

Exemple : registerAndEnrollAccount

import { IntuneMAM } from '@capgo/capacitor-intune';

await IntuneMAM.registerAndEnrollAccount({ accountId: 'account-id-123' });

Erreurs courantes

• É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.

Pré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+

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.

Usage 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 interactives

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

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

Rafraîchissement silencieux du token

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

Résumé API

• 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 de l'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 des bundles Intune et MSAL.

Notes de plateforme

• Le Web n'est pas supporté.
• 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.

Continuer depuis Getting Started

Si vous utilisez Prise en main pour planifier la migration et les opérations d'entreprise, connectez-l’à Utiliser @capgo/capacitor-intune pour la capacité native dans l'utilisation de @capgo/capacitor-intune, Capgo Enterprise 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.