Migrer d'Ionic Identity Vault

Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet pour ce plugin.

Native Biometric remplace intégralement la partie « secure credential-vault » d'Ionic Identity Vault. Il fait bien plus que demander une authentification biométrique : il enregistre, vérifie, récupère et supprime les identifiants avec la protection native de Keychain ou Keystore. Avec le contrôle d'accès biométrique activé, les lectures protégées exigent Face ID, Touch ID ou la biométrie Android avant que votre app ne reçoive l'identifiant.

Utilisez directement Native Biometric pour vos flux de tokens et de credential-vault. Votre app décide quand demander une lecture protégée pour appliquer sa politique de timeout et de cycle de vie. Si vous avez aussi besoin d'une base de données chiffrée étendue pour des données autres que les identifiants, ajoutez SQL rapide ou Stockage de données SQLite; c'est facultatif pour une migration de credential-vault.

Les verrouillages automatiques liés au timeout et les écrans de confidentialité en arrière-plan relèvent de la politique applicative ; préservez-les ou recréez-les dans votre app. Les modes de coffre-fort avec code d'accès personnalisé ou en mémoire uniquement ne sont pas pris en charge par Native Biometric ; utilisez une architecture de stockage et de chiffrement applicative distincte si vous en avez besoin.

Aperçu des remplacements Capgo

Plugin d'entreprise Ionic	Remplacement Capgo	Guide de migration
Stockage sécurisé	@capgo/capacitor-fast-sql ou @capgo/capacitor-data-storage-sqlite	Migration de Secure Storage
Connexion d'authentification	@capgo/capacitor-social-login	Migration d'Auth Connect
Flux du credential vault d'Identity Vault	@capgo/capacitor-native-biometric — remplacement direct	Vous êtes ici

Ce que couvre Native Biometric

Coffre-fort de credentials sécurisé : enregistrer, récupérer, vérifier et supprimer des credentials pour un serveur ou un compte.
Déverrouillage par biométrie : getSecureCredentials affiche le prompt biométrique natif avant que les credentials protégés ne puissent être lus.
Politique de verrouillage gérée par l'app : appelez la lecture protégée lors de la reprise de l'app, après un timeout ou avant une action sensible.
Prompt d'identité séparé : verifyIdentity prend en charge le repli sur le code de l'appareil sur iOS ; la lecture des identifiants protégés reste limitée à la biométrie.
Options de contrôle d'accès : choisissez si l'invalidation de l'enrôlement biométrique doit invalider les identifiants protégés.

Étapes de migration

Installer Native Biometric et synchroniser le code natif.

npm install @capgo/capacitor-native-biometric
npx cap sync

Sauvegardez les tokens d'accès et de refresh ou autres identifiants avec le contrôle d'accès biométrique activé.
Utiliser getSecureCredentials pour déverrouiller des identifiants protégés lorsque l'application reprend, après un délai d'inactivité ou avant une action sensible.
Conservez la gestion des timeouts et de privacy-screen dans votre couche applicative. Les modes passcode personnalisé et mémoire uniquement ne sont pas supportés par Native Biometric ; utilisez un design de stockage et de chiffrement distinct si nécessaire.
Utiliser isCredentialsSaved et deleteCredentials pour l'onboarding, l'état verrouillé et les flux de déconnexion.
Migrer les secrets stockés au premier lancement en les lisant depuis Identity Vault pour les écrire avec Native Biometric.
Supprimer Ionic Identity Vault de vos dépendances et de votre configuration native.

Étapes suivantes

Continuer après la migration d'Ionic Identity Vault

Si vous utilisez Migrer d'Ionic Identity Vault pour planifier la sécurité et la conformité, connectez-l’à Chiffrement pour les détails d'implémentation du chiffrement, Conformité pour les détails d'implémentation de la conformité, Scanner de sécurité Capgo pour le workflow produit dans Capgo Security Scanner, Capgo et la sécurité pour le workflow produit dans Capgo Security, et Capgo Centre de confiance pour le workflow produit dans Capgo Trust Center.