Aller au contenu

Migrer d'Ionic Identity Vault

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.

Plugin d'entreprise IonicRemplacement CapgoGuide de migration
Stockage sécurisé@capgo/capacitor-fast-sql ou @capgo/capacitor-data-storage-sqliteMigration de Secure Storage
Connexion d'authentification@capgo/capacitor-social-loginMigration d'Auth Connect
Flux du credential vault d'Identity Vault@capgo/capacitor-native-biometric — remplacement directVous êtes ici
  • 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 les modifications de l'enregistrement biométrique invalident les identifiants protégés.
  1. Installer Native Biometric et synchroniser le code natif.
Fenêtre de terminal
npm install @capgo/capacitor-native-biometric
npx cap sync
  1. Enregistrer les tokens d'accès et de refresh ou d'autres identifiants avec le contrôle d'accès biométrique activé.
  2. Utiliser getSecureCredentials pour 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.
  3. 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.
  4. Utiliser isCredentialsSaved et deleteCredentials pour les flux d’onboarding, d’état verrouillé et de déconnexion.
  5. Migrer les secrets stockés au premier lancement en les lisant depuis Identity Vault et en les écrivant avec Native Biometric.
  6. Supprimer Ionic Identity Vault de vos dépendances et de votre configuration native.

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.