Utilizza @capgo/capacitor-biometria-nativa
Questo plugin fornisce accesso alle API di biometria native per Android e iOS.
Installa
bun add @capgo/capacitor-native-biometric
bunx cap sync
bunx cap sync copia il code nativo del plugin nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.
Importa
import { NativeBiometric } from '@capgo/capacitor-native-biometric';
API in un colpo solo
| Metodo | Descrizione |
|---|---|
isAvailable |
Verifica se l'hardware di autenticazione biometrica è disponibile. |
verifyIdentity |
Sollecita l'utente a autenticarsi con i biometri. |
getCredentials |
Recupera le credenziali memorizzate per un server specifico. |
setCredentials |
Memorizza le credenziali fornite per un server specifico. |
deleteCredentials |
Elimina 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 le credenziali sono già salvate per un server specifico. |
setData |
Memorizza un valore di stringa arbitrario sotto la chiave specificata. I valori sono crittografati in modo persistente utilizzando il backend di archiviazione sicuro della piattaforma (Android Keystore + SharedPreferences, iOS Keychain). |
getData |
Ottiene un valore precedentemente memorizzato per la chiave specificata. Restituisce solo i valori memorizzati senza biometrico. accessControl. |
getSecureData |
Ottiene un valore protetto da biometria per la chiave specificata. Il valore deve essere stato memorizzato con accessControl impostalo su BIOMETRY_CURRENT_SET o BIOMETRY_ANY. |
deleteData |
Elimina il valore memorizzato per la chiave specificata (protetto e non protetto). |
isDataSaved |
Verifica se un valore è già stato salvato per la chiave specificata. |
Esempi
isAvailable()
Verifica se sono disponibili dispositivi di autenticazione biometrica.
import { NativeBiometric } from '@capgo/capacitor-native-biometric';
const result = await NativeBiometric.isAvailable();
console.log(result);
verifyIdentity()
Richiede all'utente di autenticarsi con i dati biometrici.
import { NativeBiometric } from '@capgo/capacitor-native-biometric';
await NativeBiometric.verifyIdentity();
getCredentials()
Recupera le credenziali memorizzate per un server specifico.
import { NativeBiometric } from '@capgo/capacitor-native-biometric';
const result = await NativeBiometric.getCredentials({ server: 'example.com' });
// The result holds sensitive values: use it without logging it.
setCredentials()
Memorizza le credenziali specificate per un server specifico.
import { NativeBiometric } from '@capgo/capacitor-native-biometric';
await NativeBiometric.setCredentials({
username: 'username',
password: 'password',
server: 'example.com',
});
deleteCredentials()
Cancella le credenziali memorizzate per un server specifico.
import { NativeBiometric } from '@capgo/capacitor-native-biometric';
await NativeBiometric.deleteCredentials({ server: 'example.com' });
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.
import { NativeBiometric } from '@capgo/capacitor-native-biometric';
const result = await NativeBiometric.getSecureCredentials({ server: 'example.com' });
// The result holds sensitive values: use it without logging it.
I metodi elencati nella tabella sopra sono 12. I listener e gli aiuti di versione, nonché il contratto completo di ogni metodo, sono documentati nel repository GitHub.
Ascolta gli eventi
addListener restituisce un handle. Chiamalo handle.remove() quando lo schermo viene smontato.
Riferimento completo
Continua da Utilizzo di @capgo/capacitor-native-biometric
Se stai utilizzando Utilizzo di @capgo/capacitor-native-biometric per pianificare l'autenticazione e le flussi di account, connettilo con @capgo/capacitor-native-biometric per i dettagli di implementazione in @capgo/capacitor-native-biometric Getting Started per i dettagli di implementazione in Getting Started, @capgo/capacitor-login sociale per i dettagli di implementazione in @capgo/capacitor-login sociale, @capgo/capacitor-chiave passiva per i dettagli di implementazione in @capgo/capacitor-chiave passiva, e Autenticazione a due fattori per i dettagli di implementazione in Autenticazione a due fattori.