Per iniziare

Installazione

Puoi usare il nostro setup assistito dall'IA per installare il plugin. Aggiungi le skill Capgo al tuo strumento di IA usando il seguente comando:

bunx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Poi usa il seguente prompt:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-intune` plugin in my project.

Se preferisci la configurazione manuale, installa il plugin eseguendo questi comandi e segui le istruzioni specifiche per piattaforma qui sotto:

1. Installa il pacchetto

   bun add @capgo/capacitor-intune

2. Sincronizza i progetti nativi

   bunx cap sync

3. Configurazione nativa di Intune completata Segui le pagine Setup iOS e Configurazione Android dedicate. Intune richiede ancora la configurazione nativa dell'host-app per brokered auth, redirect URI, manifest, entitlements e configurazione MSAL.

Avvio rapido

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

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

Esempio: 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.

Esempio: registerAndEnrollAccount

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

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

Errori comuni

• Listener: rimuovi gli handle quando gli schermi vengono smontati.
• Sync nativo: esegui bunx cap sync dopo gli aggiornamenti dei plugin.
• Fonte di verità: fidati src/definitions.ts nel repo GitHub.

Requisiti

• Capacitor 8+
• Android con Intune Android SDK 12.0.3
• iOS con Intune iOS SDK 21.5.1
• Target di deployment iOS 17.0+

La documentazione Intune di Ionic indica una scadenza al 19 gennaio 2026 per le app buildate con Xcode 26, che richiede SDK iOS di Intune 21.1.0+. Questo plugin utilizza già 21.5.1.

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 e registrazione interattivi

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

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

Refresh silenzioso del token

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

Leggi l'account attualmente registrato

const user = await IntuneMAM.enrolledAccount();

Disconnetti o esegui il wipe selettivo

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

Riepilogo API

• acquireToken(options): Avvia il login Microsoft e restituisci il token e i metadati dell'account.
• acquireTokenSilent(options): Leggi un token in cache per un account esistente.
• registerAndEnrollAccount(options): Registra l'account MSAL con Intune e avvia l'enrollment.
• loginAndEnrollAccount(): Lascia che Intune gestisca il flusso di login e enrollment.
• appConfig(user): Leggi i valori di configurazione dell'app Intune per l'account.
• getPolicy(user): Leggi l'attuale policy di protezione dell'app Intune per l'account.
• groupName(user): Leggi il valore comune GroupName dell'helper di configurazione, se presente.
• sdkVersion(): Ispeziona le versioni di Intune e MSAL incluse nel bundle.

Note sulla piattaforma

• Il Web non è supportato.
• Sia iOS che Android richiedono una configurazione del progetto nativo oltre cap sync.
• La registrazione Azure, l'assegnazione della policy Intune, gli URI di redirect e gli entitlements rimangono specifici dell'app.

Continua da Getting Started

Se stai usando Per iniziare per pianificare la migrazione e le operazioni enterprise, collegalo a Utilizzo di @capgo/capacitor-intune per la funzionalità nativa in Usare @capgo/capacitor-intune, Capgo Enterprise per il workflow del prodotto in Capgo Enterprise, Alternative ai plugin Ionic Enterprise per il workflow del prodotto nelle alternative ai plugin Ionic Enterprise, Alternative a Capgo per il workflow di prodotto in Capgo Alternatives, e Consulenza Capgo per il workflow di prodotto in Capgo Consulting.