Inizia a utilizzare

1. Installare il pacchetto

   bun add @capgo/capacitor-intune

2. Sincronizza progetti nativi

   bunx cap sync

3. Completa la configurazione nativa di Intune Segui la guida dedicata Configurazione iOS e Configurazione Android pages. Intune richiede ancora una configurazione nativa dell'app host per l'autenticazione brokerata, URIs di reindirizzamento, manifesti, autorizzazioni e configurazione MSAL.

Requisiti

• Capacitor 8+
• Android con Intune Android SDK 12.0.3
• iOS with Intune iOS SDK 21.5.1
• I documenti di Intune di Ionic attualmente indicano un taglio del 19 gennaio 2026 per le app costruite con Xcode 26, richiedendo Intune iOS __CAPGO_KEEP_0__ 17.0+

Ionic’s Intune docs currently call out a January 19, 2026 cutoff for apps built with Xcode 26, requiring Intune iOS SDK 21.1.0+Utilizzo base 21.5.1.

Sezione intitolata “Utilizzo 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 });

Flussi comuni

Accesso interattivo e registrazione

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

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

Rinnovo del token in silenzio

const token = await IntuneMAM.acquireTokenSilent({
  accountId: 'AAD_OBJECT_ID',
  scopes: ['https://graph.microsoft.com/.default'],
  forceRefresh: true,
});

Leggi l'account attualmente iscritto

const user = await IntuneMAM.enrolledAccount();

Disconnetti o cancella selezionatamente

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

API Summary

• acquireToken(options): Inizia l'accesso Microsoft e restituisci token e metadati dell'account.
• acquireTokenSilent(options): Leggi un token memorizzato per un account esistente.
• registerAndEnrollAccount(options): Registra l'account MSAL con Intune e attiva l'iscrizione.
• loginAndEnrollAccount(): Lascia che Intune guidi il flusso di accesso e iscrizione.
• appConfig(user): Leggi i valori di configurazione dell'app Intune per l'account.
• getPolicy(user): Leggi la politica di protezione dell'app Intune corrente per l'account.
• groupName(user): Leggi il valore comune GroupName config helper quando presente.
• sdkVersion(): Verifica le versioni di Intune e MSAL incorporate.

Note sulla piattaforma

• Non è supportato il web.
• Sia iOS che Android richiedono una configurazione del progetto nativo oltre a cap sync.
• La tua registrazione di Azure, l'assegnazione della politica di Intune, gli URI di reindirizzamento e le autorizzazioni rimangono specifiche dell'app.