Salta al contenuto principale
@capgo/capacitor-intune Autenticazione e sicurezza Open source

Intune Plugin Capacitor

Microsoft Intune MAM, app protection policy, app config e autenticazione MSAL per Capacitor

Installa

bun add @capgo/capacitor-intune bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-intune
  • pnpm add @capgo/capacitor-intune
  • yarn add @capgo/capacitor-intune

Guida

Come usare Intune in Capacitor

Utilizzo di @capgo/capacitor-intune

Plugin Capacitor per l'enrollment MAM di Microsoft Intune, app protection policies, app config e autenticazione MSAL.

Installa

bun add @capgo/capacitor-intune
bunx cap sync

bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.

Importa

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

API in breve

Metodo Descrizione
acquireToken Presenta il flusso di login di Microsoft e restituisce un access token e i metadati dell'account.
acquireTokenSilent Acquisisce un token dalla cache MSAL per un utente già autenticato.
registerAndEnrollAccount Registra un account precedentemente autenticato con Intune e avvia l'enrollment.
loginAndEnrollAccount Chiedi a Intune di autenticare e registrare un utente senza richiedere prima un token dell'app.
enrolledAccount Restituisce l'account Intune attualmente registrato, se disponibile.
deRegisterAndUnenrollAccount Rimuovi l'account da Intune e avvia il wipe selettivo, se applicabile.
logoutOfAccount Effettua il logout dell'utente da MSAL senza rimuovere l'account Intune.
appConfig Recupera la configurazione remota dell'app Intune per un account gestito.
getPolicy Recupera la policy di protezione app Intune attualmente in vigore per un account gestito.
groupName Helper di utilità che risolve il GroupName valore di configurazione dell'app, se presente.
sdkVersion Restituisce le versioni native di Intune e MSAL SDK incluse in questo plugin.
displayDiagnosticConsole Mostra l'interfaccia diagnostica nativa di Intune.

Esempi

acquireToken()

Avvia il flusso di login Microsoft e restituisce l'access token e 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()

Acquisisce un token dalla cache MSAL per un utente già 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'enrollment.

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

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

loginAndEnrollAccount()

Chiedi a Intune di autenticare e registrare un utente senza richiedere prima un token dell'app.

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

await IntuneMAM.loginAndEnrollAccount();

enrolledAccount()

Restituisce l'account Intune attualmente registrato, se disponibile.

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

const result = await IntuneMAM.enrolledAccount();
console.log(result);

deRegisterAndUnenrollAccount()

Rimuovi l'account da Intune e avvia il wipe selettivo, se applicabile.

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

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

La tabella sopra elenca i 12 metodi principali. Gli helper per listener e versione e il contratto completo di ogni metodo sono documentati in repository GitHub.

Ascolta gli eventi

addListener restituisce un handle. Chiama handle.remove() quando la schermata viene smontata, o IntuneMAM.removeAllListeners() per rimuovere tutti i listener.

Riferimento completo

Continua da Using @capgo/capacitor-intune

Se stai usando Utilizzo di @capgo/capacitor-intune per pianificare i flussi di autenticazione e account, collegandolo a @capgo/capacitor-intune per i dettagli di implementazione in @capgo/capacitor-intune, Per iniziare per i dettagli di implementazione nella guida introduttiva, @capgo/capacitor-social-login per i dettagli di implementazione in @capgo/capacitor-social-login, @capgo/capacitor-passkey per i dettagli di implementazione in @capgo/capacitor-passkey, e @capgo/capacitor-native-biometric per i dettagli di implementazione in @capgo/capacitor-native-biometric.

FAQ

FAQ sul plugin Intune

Come installo il plugin Intune in un'app Capacitor?

Esegui "bun add @capgo/capacitor-intune" (o "npm install @capgo/capacitor-intune"), poi lancia "bunx cap sync" in modo che i progetti iOS e Android rilevino il code nativo. Importalo da "@capgo/capacitor-intune" nel code della tua app.

@capgo/capacitor-intune funziona con React, Vue e Angular?

Sì. Intune è un pacchetto Capacitor, quindi funziona con qualsiasi web framework in esecuzione dentro Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-intune?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-intune è gratuito e open source?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-intune/ e il pacchetto si può installare gratuitamente da npm. Bug report e pull request sono benvenuti.

Posso aggiornare code che usa Intune senza la revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Distribuisci le modifiche di Intune senza attendere la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo