Migrar de Ionic Identity Vault

Native Biometric proporciona un reemplazo completo para la parte de bóveda segura de credenciales de Ionic Identity Vault. Hace más que pedir 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 de bóveda de credenciales. Tu app decide cuándo solicitar una lectura protegida para aplicar su política de timeout y ciclo de vida. Si además necesitas una base de datos cifrada amplia para datos que no sean credenciales, añade SQL rápido o Almacenamiento de datos con SQLite; eso es opcional para una migración de bóveda de credenciales.

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 consérvalos o recréalos en tu app. Native Biometric no admite modos de bóveda con código de acceso personalizado o solo en memoria; usa un diseño separado de almacenamiento y cifrado de la aplicación si los necesitas.

Reemplazos de Capgo de un vistazo

Plugin de Ionic Enterprise	Sustituto 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 Auth	@capgo/capacitor-social-login	Migración de Auth Connect
Flujos de la bóveda de Identity Vault	@capgo/capacitor-native-biometric — reemplazo directo	Estás aquí

Qué cubre Native Biometric

• Bóveda de credenciales segura: guarda, recupera, comprueba y elimina credenciales de un servidor o cuenta.
• Desbloqueo protegido por biometría: getSecureCredentials muestra el prompt biométrico nativo antes de que se puedan leer las credenciales protegidas.
• Política de bloqueo controlada por la app: invoca la lectura protegida cuando la app se reanuda, tras un timeout o antes de una acción sensible.
• Prompt de identidad separado: verifyIdentity soporta el fallback de passcode del dispositivo en iOS; la lectura de credenciales protegidas sigue 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. Instalar Native Biometric y sincroniza el code nativo.

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

2. Guarda los tokens de acceso y refresco 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 timeout de inactividad o antes de una acción sensible.
4. Mantén la lógica de timeout y privacy-screen en tu capa de aplicación. Native Biometric no soporta 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 flujos de onboarding, estado bloqueado y logout.
6. Migra los secretos almacenados en el primer inicio leyéndolos de Identity Vault y escribiéndolos con Native Biometric.
7. Eliminar 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 Cifrado, Cumplimiento para los detalles de implementación en Cumplimiento, 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.