Migrar de Ionic Identity Vault

Native Biometric es el reemplazo completo para la parte de almacén de credenciales seguras de Ionic Identity Vault. Hace más que solo solicitar biometría: guarda, verifica, recupera y elimina credenciales con protección nativa de Keychain o Keystore. Con el control de acceso biométrico activado, las lecturas protegidas requieren Face ID, Touch ID o biometría de Android antes de que tu app reciba la credencial.

Usa Native Biometric directamente para flujos de tokens y credential-vault. Tu app decide cuándo solicitar una lectura protegida para aplicar su política de timeout y ciclo de vida. Si también necesitas una base de datos cifrada amplia para datos distintos a las credenciales, añade SQL rápido o Almacenamiento de datos con SQLite; eso es opcional para una migración de credential-vault.

Los bloqueos automáticos por timeout y las pantallas de privacidad en segundo plano son políticas de la capa de aplicación, así que debes preservarlas o recrearlas en tu app. Native Biometric no soporta modos de passcode personalizado o vault en memoria; usa un diseño de cifrado y almacenamiento de aplicación separado si los necesitas.

Resumen de reemplazos de Capgo

Plugin de Ionic Enterprise	Reemplazo de Capgo	Guía de migración
Almacenamiento seguro	@capgo/capacitor-fast-sql o @capgo/capacitor-data-storage-sqlite	Migración de Secure Storage
Conexión de autenticación	@capgo/capacitor-social-login	Migración de Auth Connect
Flujos de credential-vault de Identity Vault	@capgo/capacitor-native-biometric — reemplazo directo	Estás aquí

Qué cubre Native Biometric

• Bóveda de credenciales segura: guarda, recupera, verifica y elimina credenciales de un servidor o cuenta.
• Desbloqueo mediante biometría: getSecureCredentials muestra el prompt biométrico nativo antes de leer las credenciales protegidas.
• Política de bloqueo controlada por la app: ejecuta la lectura protegida al reanudar la app, tras un timeout o antes de una acción sensible.
• Prompt de identidad independiente: verifyIdentity soporta el respaldo con código de dispositivo en iOS; la lectura de credenciales protegidas seguirá siendo solo biométrica.
• Opciones de control de acceso: elige si los cambios en el registro biométrico invalidan las credenciales protegidas.

Pasos de migración

1. Instala Native Biometric y sincroniza el code nativo.

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

2. Guarda los access y refresh tokens u otras credenciales con el control de acceso biométrico habilitado.
3. Usa getSecureCredentials para desbloquear credenciales protegidas cuando la app se reanuda, tras un tiempo de inactividad o antes de una acción sensible.
4. Mantén el comportamiento de timeout y privacy-screen en tu capa de aplicación. Native Biometric no admite modos de passcode personalizado o solo en memoria; usa un diseño de cifrado y almacenamiento aparte si es necesario.
5. Usa isCredentialsSaved y deleteCredentials para los flujos de onboarding, estado bloqueado y logout.
6. Migra los secretos almacenados en el primer inicio leyéndolos desde Identity Vault y escribiéndolos con Native Biometric.
7. Elimina Ionic Identity Vault de tus dependencias y configuración nativa.

Próximos pasos

• Primeros pasos con Native Biometric
• Migración de Secure Storage
• Migración de Auth Connect

Continuar desde Migrar desde Ionic Identity Vault

Si estás usando Migrar de Ionic Identity Vault para planificar la seguridad y el cumplimiento, conéctalo con Cifrado para los detalles de implementación en Encryption, Cumplimiento para el detalle de implementación en Compliance, Escáner de seguridad de Capgo para el flujo de trabajo del producto en Capgo Security Scanner, Seguridad de Capgo para el flujo de trabajo del producto en Capgo Security, y Centro de confianza de Capgo para el flujo de trabajo del producto en Capgo Trust Center.