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

Persona Plugin Capacitor

Avvia richieste di verifica dell'identità Persona con gli SDK nativi iOS e Android

Installa

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

Guida

Come usare Persona in Capacitor

Utilizzo di @capgo/capacitor-intune

Plugin Capacitor per l'enrollment Microsoft Intune MAM, policy di protezione app, configurazione app 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 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 pratico per gestire 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()

Mostra il flusso di accesso Microsoft e restituisce un 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()

Recupera 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 ed eseguire l'enrollment di un utente senza richiedere prima un token dell'app.

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

await IntuneMAM.loginAndEnrollAccount();

enrolledAccount()

Restituisce l'account Intune attualmente in enrollment, 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 Persona

Come installo il plugin Persona in un'app Capacitor?

Esegui "bun add @capgo/capacitor-persona" (o "npm install @capgo/capacitor-persona"), poi lancia "bunx cap sync" così i progetti iOS e Android rilevano il code nativo. Importalo da "@capgo/capacitor-persona" nel code della tua app.

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

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

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

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-persona è gratuito e open source?

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

Posso aggiornare code che usa Persona 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.

Rilascia le modifiche a Persona senza aspettare 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