@capgo/capacitor-biometrica nativa

Panoramica

Native Biometric è un deposito sicuro di credenziali per iOS e Android. Memorizza le credenziali nel Keychain o Keystore nativo e richiede l'autenticazione biometrica prima di restituire valori sensibili. È una sostituzione diretta per le flussi di deposito di credenziali di Ionic Identity Vault; l'applicazione mantiene il controllo dei timeout, del ciclo di vita, dello schermo di privacy e delle politiche di passcode personalizzate.

Funzionalità fondamentali

• setCredentials e getCredentials - Memorizza e recupera in modo sicuro le credenziali per un server specifico.
• getSecureCredentials - Memorizza e recupera sicuramente le credenziali per un server specifico.
• isCredentialsSaved e deleteCredentials - Leggi le credenziali solo dopo un controllo biometrico nativo.
• isAvailable e verifyIdentity - Costruisci flussi di onboarding, stato bloccato e logout.

Publico API

Metodo	Descrizione
isAvailable	Verifica se sono disponibili dispositivi di autenticazione biometrica.
addListener	Aggiunge un ascoltatore che viene chiamato quando l'applicazione riprende dallo sfondo. Questo è utile per rilevare se la disponibilità delle biometrie è cambiata mentre l'applicazione era in background (ad esempio, l'utente si è iscritto/desiscritto alle biometrie).
verifyIdentity	Sollecita l'utente ad autenticarsi con le biometrie.
getCredentials	Recupera le credenziali memorizzate per un server specifico.
setCredentials	Memorizza le credenziali specificate per un server specifico.
deleteCredentials	Cancella le credenziali memorizzate per un server specifico.
getSecureCredentials	Recupera le credenziali memorizzate per un server specifico, richiedendo l'autenticazione biometrica. Le credenziali devono essere state memorizzate con accessControl impostato su BIOMETRY_CURRENT_SET o BIOMETRY_ANY.
isCredentialsSaved	Verifica se sono già memorizzate le credenziali per un server specifico.
getPluginVersion	Ottieni la versione del plugin nativo Capacitor.

Valori di Riferimento

Usa questi valori quando gestisci biometricError risultati da authenticate.

Errori di Autenticazione Biometrica

Valore	Code	Piattaforma	Significato
UNKNOWN_ERROR	0	Android, iOS	Si è verificato un errore sconosciuto.
BIOMETRICS_UNAVAILABLE	1	Android, iOS	La biometria non è disponibile a causa di hardware mancante o non disponibile.
USER_LOCKOUT	2	Android, iOS	L'utente è bloccato dopo troppi tentativi falliti.
BIOMETRICS_NOT_ENROLLED	3	Android, iOS	Non sono registrati biometri sul dispositivo.
USER_TEMPORARY_LOCKOUT	4	Android	L'utente è temporaneamente bloccato, tipicamente per 30 secondi.
AUTHENTICATION_FAILED	10	Android, iOS	Autenticazione fallita.
APP_CANCEL	11	iOS	L'app ha annullato il flusso di autenticazione.
INVALID_CONTEXT	12	iOS	Il contesto di autenticazione è invalido.
NOT_INTERACTIVE	13	iOS	L'autenticazione non è stata interattiva.
PASSCODE_NOT_SET	14	Android, iOS	Il codice di dispositivo, PIN o credenziale di fallback non è impostato.
SYSTEM_CANCEL	15	Android, iOS	Il sistema ha annullato l'autenticazione, ad esempio dopo il blocco dello schermo.
USER_CANCEL	16	Android, iOS	L'utente ha annullato l'autenticazione.
USER_FALLBACK	17	Android, iOS	L'utente ha scelto l'autenticazione di fallback.

Fonte di Verità

Questa referenza è sincronizzata da src/definitions.ts in capacitor-biometrica nativa.

Continua da @capgo/capacitor-biometrica nativa

Se stai utilizzando @capgo/capacitor-biometrica nativa per pianificare l'autenticazione e le flussi di account, connettilo con Utilizza @capgo/capacitor-biometrica nativa per la capacità nativa in Utilizzo di @capgo/capacitor-native-biometric, @capgo/capacitor-login sociale per il dettaglio di implementazione in @capgo/capacitor-social-login, @capgo/capacitor-chiave di accesso per il dettaglio di implementazione in @capgo/capacitor-passkey, Autenticazione a due fattori per il dettaglio di implementazione in Autenticazione a due fattori, e Autenticazione Single Sign-On (Enterprise) per il dettaglio di implementazione in SSO (Enterprise).