@capgo/capacitor-native-biometrique

Stockage sécurisé des informations et accès contrôlé par reconnaissance biométrique pour Android et iOS.

Vue d'ensemble

Native Biometric est une boîte de sécurité des informations d'identification pour iOS et Android. Il stocke les informations d'identification dans le cléchain ou le clésafe natif et peut exiger une authentification biométrique avant de retourner des valeurs sensibles. Il s'agit d'une remplacement direct des flux de sécurité d'identité Ionic Identity Vault ; votre application conserve le contrôle du temps d'attente, du cycle de vie, de l'écran de confidentialité et des politiques de passeword personnalisées.

Capacités de base

setCredentials et getCredentials - Stocker de manière sécurisée et récupérer des informations d'identification pour un serveur donné.
getSecureCredentials - Lire les informations d'identification uniquement après une vérification biométrique native.
isCredentialsSaved et deleteCredentials - Construire des flux d'inscription, d'état verrouillé et de déconnexion.
isAvailable et verifyIdentity - Vérifier la disponibilité de l'authentification biométrique et inviter l'utilisateur lorsque cela est nécessaire.

Public API

Méthode	Description
`isAvailable`	Vérifie si le matériel d'authentification biométrique est disponible.
`addListener`	Ajoute un écouteur qui est appelé lorsque l'application reprend du service en arrière-plan. Cela est utile pour détecter si la disponibilité des biométries a changé pendant que l'application était en arrière-plan (par exemple, l'utilisateur s'est inscrit/désinscrit des biométries).
`verifyIdentity`	Invite l'utilisateur à s'authentifier avec des biométries.
`getCredentials`	Obtient les informations d'identification stockées pour un serveur donné.
`setCredentials`	Stocke les informations d'identification données pour un serveur donné.
`deleteCredentials`	Supprime les informations d'identification stockées pour un serveur donné.
`getSecureCredentials`	Obtient 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.
`isCredentialsSaved`	Vérifie si les informations d'identification sont déjà enregistrées pour un serveur donné.
`getPluginVersion`	Obtient la version native du plugin Capacitor.

Valeurs de référence

Utilisez ces valeurs lors de la gestion biometricError des résultats provenant de authenticate.

Erreurs d'authentification biométrique

Valeur	Code	Plateforme	Signification
`UNKNOWN_ERROR`	`0`	Android, iOS	Une erreur inconnue s'est produite.
`BIOMETRICS_UNAVAILABLE`	`1`	Android, iOS	Les biométriques sont indisponibles car le matériel est manquant ou indisponible.
`USER_LOCKOUT`	`2`	Android, iOS	L'utilisateur est bloqué après trop d'essais ratés.
`BIOMETRICS_NOT_ENROLLED`	`3`	Android, iOS	Aucune donnée biométrique n'est enregistrée sur le dispositif.
`USER_TEMPORARY_LOCKOUT`	`4`	Android	L'utilisateur est temporairement bloqué, généralement pendant 30 secondes.
`AUTHENTICATION_FAILED`	`10`	Android, iOS	L'authentification a échoué.
`APP_CANCEL`	`11`	iOS	L'application a annulé le flux d'authentification.
`INVALID_CONTEXT`	`12`	iOS	Le contexte d'authentification est invalide.
`NOT_INTERACTIVE`	`13`	iOS	L'authentification n'était pas interactive.
`PASSCODE_NOT_SET`	`14`	Android, iOS	Le code d'accès, le PIN ou le mot de passe de secours n'est pas configuré.
`SYSTEM_CANCEL`	`15`	Android, iOS	L'authentification a été annulée par le système, par exemple après verrouillage d'écran.
`USER_CANCEL`	`16`	Android, iOS	L'utilisateur a annulé l'authentification.
`USER_FALLBACK`	`17`	Android, iOS	L'utilisateur a choisi l'authentification de secours.

Source De Vérité

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

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-l’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 le détail d'implémentation dans @capgo/capacitor-connexion-social, @capgo/capacitor-passkey pour le détail d'implémentation dans @capgo/capacitor-passkey, Authentification à deux facteurs pour les détails d'implémentation dans Authentification à deux facteurs, et SSO (Entreprise) pour les détails d'implémentation dans SSO (Entreprise).