Migrazione da Ionic Identity Vault

Native Biometric sostituisce completamente la parte secure credential-vault di Ionic Identity Vault. Fa molto più di un semplice prompt biometrico: salva, controlla, recupera ed elimina le credenziali con la protezione nativa di Keychain o Keystore. Con il controllo di accesso biometrico abilitato, le letture protette richiedono Face ID, Touch ID o la biometria Android prima che l'app riceva la credenziale.

Usa Native Biometric direttamente per i flussi di token e credential-vault. La tua app decide quando richiedere una lettura protetta per applicare la propria policy di timeout e lifecycle. Se hai bisogno anche di un database crittografato esteso per dati diversi dalle credenziali, aggiungi SQL veloce o Storage dati con SQLite; è opzionale per la migrazione del credential-vault.

I lock automatici per timeout e le privacy screen in background sono policy a livello applicativo, quindi vanno mantenuti o ricreati nella tua app. Native Biometric non supporta le modalità custom-passcode e memory-only vault; se ti servono, usa un design separato per lo storage e la crittografia dell'app.

Sostituzioni Capgo a colpo d'occhio

Plugin Ionic Enterprise	Sostituzione di Capgo	Guida alla migrazione
Archiviazione sicura	@capgo/capacitor-fast-sql o @capgo/capacitor-data-storage-sqlite	Migrazione Secure Storage
Connessione Auth	@capgo/capacitor-social-login	Migrazione Auth Connect
Flussi del credential vault di Identity Vault	@capgo/capacitor-native-biometric — sostituzione diretta	You are here

Cosa copre Native Biometric

• Vault sicuro per le credenziali: salva, recupera, verifica e cancella le credenziali di un server o di un account.
• Sblocco tramite biometria: getSecureCredentials mostra il prompt biometrico nativo prima di poter leggere le credenziali protette.
• Policy di blocco gestita dall'app: esegui la lettura protetta quando l'app torna in primo piano, dopo un timeout o prima di un'azione sensibile.
• Prompt di identità separato: verifyIdentity supporta il fallback con codice di sblocco su iOS; la lettura delle credenziali protette resta limitata alla biometria.
• Opzioni di controllo accessi: scegli se le modifiche all'impostazione del biometrico invalidano le credenziali protette.

Passaggi per la migrazione

1. Installa Native Biometric e sincronizza code nativo.

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

2. Salva gli access e refresh token o altre credenziali con il controllo accessi biometrico abilitato.
3. Usa getSecureCredentials per sbloccare le credenziali protette quando l'app torna in primo piano, dopo un timeout di inattività o prima di un'azione sensibile.
4. Mantieni la gestione di timeout e privacy-screen nel layer della tua app. Native Biometric non supporta le modalità custom-passcode e memory-only; se necessario, usa un design separato per storage e crittografia.
5. Usa isCredentialsSaved e deleteCredentials per i flussi di onboarding, stato bloccato e logout.
6. Migra i segreti salvati al primo avvio leggendoli da Identity Vault e scrivendoli con Native Biometric.
7. Rimuovi Ionic Identity Vault dalle tue dipendenze e dalla configurazione nativa.

Prossimi passi

• Guida rapida a Native Biometric
• Migrazione Secure Storage
• Migrazione Auth Connect

Continua da Migrate from Ionic Identity Vault

Se stai usando Migrazione da Ionic Identity Vault per pianificare sicurezza e compliance, collegalo a Crittografia per i dettagli di implementazione della crittografia, Conformità per i dettagli di implementazione in Compliance, Security Scanner di Capgo per il workflow del prodotto in Capgo Security Scanner, Sicurezza Capgo per il workflow del prodotto in Capgo Security, e Trust Center di Capgo per il workflow del prodotto in Capgo Trust Center.