Saltare al contenuto principale
@capgo/capacitor-persona Autenticazione & Sicurezza Sorgente aperta

Persona plugin Capacitor

Lancia le 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 utilizzare Persona in Capacitor

Utilizza @capgo/capacitor-intune

Capacitor plugin per l'iscrizione a Microsoft Intune MAM, politiche di protezione degli app, configurazione degli app e autenticazione MSAL.

Installa

bun add @capgo/capacitor-intune
bunx cap sync

bunx cap sync copia il plugin's nativo code nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.

Importa

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

API in un colpo di occhio

Metodo Descrizione
acquireToken Presenta il flusso di accesso a Microsoft e restituisce un token di accesso più i metadati dell'account.
acquireTokenSilent Acquisisci un token dal cache MSAL per un utente precedentemente iscritto.
registerAndEnrollAccount Registra un account precedentemente autenticato con Intune e avvia l'iscrizione.
loginAndEnrollAccount Chiedi a Intune di autenticare e iscrivere l'utente senza richiedere prima un token dell'applicazione.
enrolledAccount Restituisci l'account Intune attualmente iscritto, se disponibile.
deRegisterAndUnenrollAccount Disiscrivi l'account da Intune e attiva la cancellazione selettiva quando applicabile.
logoutOfAccount Effettua il logout dell'utente da MSAL senza disiscrivere l'account Intune.
appConfig Estrai la configurazione dell'applicazione remota Intune per un account gestito.
getPolicy Estrai la politica di protezione dell'applicazione Intune attualmente efficace 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 parte di questo plugin.
displayDiagnosticConsole Mostra l'interfaccia utente diagnostica nativa di Intune.

Examples

acquireToken()

Presenta il flusso di accesso di Microsoft e restituisci 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 di MSAL per un utente precedentemente accreditato.

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 un utente senza richiedere prima un token dell'applicazione.

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

await IntuneMAM.loginAndEnrollAccount();

enrolledAccount()

Restituisci l'account Intune correntemente iscritto, se 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' });

I metodi elencati nella tabella sopra sono 12. I listener e gli aiuti per la versione, nonché il contratto completo di ogni metodo, sono documentati nel repository GitHub.

Ascolta gli eventi

addListener restituisce un handle. Chiama handle.remove() quando lo schermo viene smontato, o IntuneMAM.removeAllListeners() per cancellare tutti gli ascoltatori.

Riferimento completo

Continua con l'uso di @capgo/capacitor-intune

Se stai utilizzando Utilizza @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 Avvio @capgo/capacitor-login-sociale Per i dettagli di implementazione in @capgo/capacitor-login-sociale @capgo/capacitor-chiave di accesso per il dettaglio di implementazione in @capgo/capacitor-passkey, e @capgo/capacitor-nativo-biometrico per il dettaglio di implementazione in @capgo/capacitor-native-biometric.

FAQ

Domande frequenti del plugin Persona

Come posso installare il plugin Persona in un'app Capacitor?

Esegui "bun add @capgo/capacitor-persona" (o "npm install @capgo/capacitor-persona"), quindi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino il code nativo. Importalo da "@capgo/capacitor-persona" nella tua app code.

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

Sì. Persona è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Qual è la versione di Capacitor supportata da @capgo/capacitor-persona?

Il plugin Capgo segue la versione maggiore di Capacitor: utilizza la versione del plugin maggiore che corrisponde alla tua versione maggiore di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README del GitHub elenca le versioni mantenute.

È gratuito e open source @capgo/capacitor-persona?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-persona/ e il pacchetto è gratuito da installare da npm. I segnalazioni di bug e pull request sono benvenuti.

Posso aggiornare code che utilizza Persona senza una revisione dell'App Store?

Il plugin viene installato o aggiornato, il codice nativo code viene modificato, quindi è necessario un nuovo build per la store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere distribuite immediatamente con gli aggiornamenti Capgo in tempo reale.

Invia modifiche a Persona senza attendere la revisione dell'app

Una volta che il plugin è presente nella tua build di store, Capgo aggiorna in tempo reale i cambiamenti JavaScript, HTML e CSS dei tuoi utenti in pochi minuti.

Inizia con Capgo