Démarrage

1. Installez le package

   bun add @capgo/capacitor-intune

2. Synchroniser les projets natifs

   bunx cap sync

3. Configuration native Intune complète Suivez les pages dédiées Configuration iOS et Configuration Android à la page. Intune nécessite encore 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
• Objectif de déploiement iOS 17.0+

Les documents Intune d'Ionic indiquent actuellement une date limite du 19 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 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();

Se déconnecter ou effacer de manière sélective

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

API Résumé

• acquireToken(options): Demander le signe de 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'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 d'aide de configuration commune lorsque celle-ci est présente. GroupName : Inspectez les versions bundlées d'Intune et de MSAL.
• sdkVersion()Notes de plateforme

Section intitulée « Notes de plateforme »

• Les versions iOS et Android nécessitent une configuration de projet native au-delà
• 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 »

: Laissez Intune gérer le flux de connexion et d'inscription.

Si vous utilisez Démarrage 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 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 Capgo Conseil pour le flux de travail du produit dans Capgo Conseil.