Sauter au contenu

@capgo/capacitor-native-biometric

Ce plugin donne accès aux API biométriques natives pour Android et iOS.

Ce plugin donne accès aux API biométriques natives pour Android et iOS.

  • isAvailable - Vérifie si le matériel d'authentification biométrique est disponible.
  • verifyIdentity - Demande à l'utilisateur de s'authentifier avec des biométriques.
  • getCredentials - Récupère les informations de connexion stockées pour un serveur donné.
  • setCredentials - Stocke les informations de connexion données pour un serveur donné.
MéthodeDescription
isAvailableVérifie si le matériel d'authentification biométrique est disponible.
addListenerAjoute un écouteur qui est appelé lorsque l'application reprend en arrière-plan. Cela est utile pour détecter si la disponibilité de la biométrie a changé pendant que l'application était en arrière-plan (par exemple, utilisateur inscrit/désinscrit des biométries).
verifyIdentityInvite l'utilisateur à s'authentifier avec des biométries.
getCredentialsRécupère les informations d'identification stockées pour un serveur donné.
setCredentialsStocke les informations d'identification données pour un serveur donné.
deleteCredentialsSupprime les informations d'identification stockées pour un serveur donné.
getSecureCredentialsRécupère les informations d'identification stockées pour un serveur donné, en exigeant une authentification biométrique. Les informations d'identification doivent avoir été stockées avec accessControl défini sur BIOMETRY_CURRENT_SET ou BIOMETRY_ANY.
isCredentialsSavedVérifie si des informations d'identification sont déjà enregistrées pour un serveur donné.
getPluginVersionObtient la version native du plugin Capacitor.

Utilisez ces valeurs lors du traitement des biometricError résultats provenant de authenticate.

ValeurCodePlateformeSignification
UNKNOWN_ERROR0Android, iOSUne erreur inconnue s'est produite.
BIOMETRICS_UNAVAILABLE1Android, iOSLes biométriques sont indisponibles en raison d'un matériel manquant ou indisponible.
USER_LOCKOUT2Android, iOSL'utilisateur est bloqué après trop d'essais ratés.
BIOMETRICS_NOT_ENROLLED3Android, iOSAucune biométrique n'est enregistrée sur le dispositif.
USER_TEMPORARY_LOCKOUT4AndroidL'utilisateur est temporairement bloqué, généralement pendant 30 secondes.
AUTHENTICATION_FAILED10Android, iOSL'authentification a échoué.
APP_CANCEL11iOSL'application a annulé la progression d'authentification.
INVALID_CONTEXT12iOSLe contexte d'authentification est invalide.
NOT_INTERACTIVE13iOSL'authentification n'a pas été interactive.
PASSCODE_NOT_SET14Android, iOSLe code d'accès du dispositif, le PIN ou le mot de passe de secours n'est pas configuré.
SYSTEM_CANCEL15Android, iOSLe système a annulé l'authentification, par exemple après verrouillage de l'écran.
USER_CANCEL16Android, iOSL'utilisateur a annulé l'authentification.
USER_FALLBACK17Android, iOSL'utilisateur a choisi l'authentification de secours.

Cette référence est synchronisée à partir de src/definitions.ts en capacitor-biométrique-native.

Continuez à partir de @capgo/capacitor-biométrique-native

Section intitulée « Continuez à partir de @capgo/capacitor-biométrique-native »

Si vous utilisez @capgo/capacitor-biométrique-native pour planifier l'authentification et les flux de compte, connectez-le avec En utilisant @capgo/capacitor-biométrique-native pour la capacité native dans En utilisant @capgo/capacitor-biométrique-native, @capgo/capacitor-connexion-social pour les détails d'implémentation dans @capgo/capacitor-connexion sociale @capgo/capacitor-passkey pour les détails d'implémentation dans @capgo/capacitor-passkey Authentification à deux facteurs pour les détails d'implémentation dans l'authentification à deux facteurs, et SSO (Entreprise) pour les détails d'implémentation dans SSO (Entreprise).