Guida
Come utilizzare Intune in Capacitor
Utilizzo di @capgo/capacitor-intune
Plugin Capacitor per l'iscrizione MAM di Microsoft Intune, politiche di protezione delle app, configurazione delle app e autenticazione MSAL.
Installa
bun add @capgo/capacitor-intune
bunx cap sync
bunx cap sync Copia il plugin nativo code nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.
Importa
import { IntuneMAM } from '@capgo/capacitor-intune';
API in sintesi
| Metodo | Descrizione |
|---|---|
acquireToken |
Presentare il flusso di accesso Microsoft e restituire un token di accesso più i metadati dell'account. |
acquireTokenSilent |
Acquisire un token dal cache MSAL per un utente già registrato. |
registerAndEnrollAccount |
Registrare un account già autenticato con Intune e avviare l'iscrizione. |
loginAndEnrollAccount |
Chiedere a Intune di autenticare e iscrivere l'utente senza richiedere prima un token di app. |
enrolledAccount |
Restituisci l'account Intune attualmente iscritto, se ne esiste uno disponibile. |
deRegisterAndUnenrollAccount |
Deregistri l'account da Intune e attiva la cancellazione selettiva quando necessario. |
logoutOfAccount |
Deregistrare l'account da Intune e attivare la pulizia selettiva quando applicabile. |
appConfig |
Disconnettere l'utente da MSAL senza disiscrivere l'account Intune. |
getPolicy |
Estrarre la configurazione dell'app Intune remota per un account gestito. |
groupName |
Aiuto di convenienza che risolve il GroupName valore di configurazione dell'app quando presente. |
sdkVersion |
Restituisci le versioni native di Intune e MSAL SDK bundle da questo plugin. |
displayDiagnosticConsole |
Mostra l'interfaccia di diagnostica nativa Intune. |
Esempi
acquireToken()
Presenta il flusso di accesso Microsoft e ritorna un token di accesso più i metadati dell'account.
import { IntuneMAM } from '@capgo/capacitor-intune';
const result = await IntuneMAM.acquireToken({ scopes: ['openid'] });
// The result holds sensitive values: use it without logging it.
acquireTokenSilent()
Acquisisci un token dal cache MSAL per un utente precedentemente autenticato.
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.
registerAndEnrollAccount()
Registra un account precedentemente autenticato con Intune e avvia l'iscrizione.
import { IntuneMAM } from '@capgo/capacitor-intune';
await IntuneMAM.registerAndEnrollAccount({ accountId: 'account-id-123' });
loginAndEnrollAccount()
Chiedi a Intune di autenticare e iscrivere l'utente senza richiedere prima un token dell'applicazione.
import { IntuneMAM } from '@capgo/capacitor-intune';
await IntuneMAM.loginAndEnrollAccount();
enrolledAccount()
Ritorna l'account Intune attualmente iscritto, se ne esiste uno disponibile.
import { IntuneMAM } from '@capgo/capacitor-intune';
const result = await IntuneMAM.enrolledAccount();
console.log(result);
deRegisterAndUnenrollAccount()
Deregistra l'account da Intune e attiva la cancellazione selettiva quando applicabile.
import { IntuneMAM } from '@capgo/capacitor-intune';
await IntuneMAM.deRegisterAndUnenrollAccount({ accountId: 'account-id-123' });
La tabella sopra elenca le 12 metodologie di base. I listener e gli aiuti di versione, nonché il contratto completo di ogni metodo, sono documentati nella GitHub repository.
Ascolta gli eventi
addListener restituisce un riferimento. Chiamalo handle.remove() quando lo schermo viene smontato, o IntuneMAM.removeAllListeners() per cancellare ogni ascoltatore.
Riferimento completo
Continua da Utilizzo di @capgo/capacitor-intune
Se stai utilizzando Utilizzo di @capgo/capacitor-intune per pianificare l'autenticazione e le flussi di account, connettilo con @capgo/capacitor-intune per i dettagli di implementazione in @capgo/capacitor-intune Getting Started per i dettagli di implementazione in Iniziare @capgo/capacitor-login con social media per i dettagli di implementazione in @capgo/capacitor-social-login @capgo/capacitor-chiave di accesso per i dettagli di implementazione in @capgo/capacitor-passkey, e @capgo/capacitor-biometrica nativa per i dettagli di implementazione in @capgo/capacitor-native-biometric