Getting Started

Installazione

Puoi utilizzare la nostra configurazione assistita dall'IA per installare il plugin. Aggiungi le Capgo competenze al tuo strumento di AI utilizzando il seguente comando:

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

Poi utilizza la seguente richiesta:

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

Se preferisci l'installazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche per la piattaforma riportate di seguito:

1. Installa il pacchetto

   bun add @capgo/capacitor-intune

2. Sincronizza progetti nativi

   bunx cap sync

3. Completa la configurazione nativa di Intune Segui le istruzioni dedicate iOS setup e Configurazione Android pagine. Intune richiede ancora una configurazione nativa dell'app host per l'autenticazione brokerata, gli URI di reindirizzamento, i manifesti, le autorizzazioni e la configurazione di MSAL.

Requisiti

• Capacitor 8+
• Android con Intune Android SDK 12.0.3
• iOS con Intune iOS SDK 21.5.1
• Obiettivo di distribuzione iOS 17.0+

I documenti Intune di Ionic attualmente indicano un limite di gennaio 19, 2026 per le app costruite con Xcode 26, richiedono un iOS Intune SDK 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 interattivo e iscrizione

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

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

Aggiornamento del token in modalità silenziosa

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 Sommario

• acquireToken(options): Inizia l'accesso con 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 del helper di configurazione quando presente.
• sdkVersion(): Ispeziona le versioni Intune e MSAL incorporate.

Nota della piattaforma

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

Keep going from Getting Started

Se stai utilizzando Getting Started per pianificare la migrazione e le operazioni aziendali, connettilo con Utilizza @capgo/capacitor-intune per la capacità nativa in Utilizza @capgo/capacitor-intune, Capgo per l'acquisto d'azienda per il workflow del prodotto in Capgo Enterprise, Alternative per l'plugin Ionic Enterprise per il workflow del prodotto in Alternative per l'plugin Ionic Enterprise, Alternative per Capgo per il workflow del prodotto in Alternative per Capgo, e Consultazione per Capgo per il workflow del prodotto in Consultazione per Capgo.