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
Section intitulée « 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
Section intitulée « 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 :
getSecureCredentialsaffiche 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é :
verifyIdentityprend 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 les modifications de l'enregistrement biométrique invalident les identifiants protégés.
Étapes de migration
Section intitulée « Étapes de migration »- Installer Native Biometric et synchroniser le code natif.
npm install @capgo/capacitor-native-biometricnpx cap sync- Enregistrer les tokens d'accès et de refresh ou d'autres identifiants avec le contrôle d'accès biométrique activé.
- Utiliser
getSecureCredentialspour débloquer les identifiants protégés lorsque l’app revient au premier plan, après un délai d’inactivité, ou avant une action sensible. - Gérez le timeout et le comportement du privacy screen dans votre couche applicative. Les modes à code PIN personnalisé et en mémoire uniquement ne sont pas pris en charge par Native Biometric ; utilisez une conception distincte du stockage et du chiffrement si nécessaire.
- Utiliser
isCredentialsSavedetdeleteCredentialspour les flux d’onboarding, d’état verrouillé et de déconnexion. - Migrer les secrets stockés au premier lancement en les lisant depuis Identity Vault et en les écrivant avec Native Biometric.
- Supprimer Ionic Identity Vault de vos dépendances et de votre configuration native.
Prochaines étapes
Section intitulée « Prochaines étapes »Continuer la migration depuis Ionic Identity Vault
Section intitulée « Continuer depuis Migrer depuis 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.