@capgo/capacitor-native-biometric

@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-biométrico-nativo

Almacenamiento seguro de credenciales y acceso controlado por biométrica para Android e iOS. GitHub

Resumen

Native Biometric es una caja de seguridad de credenciales segura para iOS y Android. Almacena credenciales en el Keychain nativo o Keystore y puede requerir autenticación biométrica antes de devolver valores sensibles. Es un reemplazo directo de las flujos de caja de seguridad de credenciales de Ionic Identity Vault; su aplicación mantiene el control de los plazos, el ciclo de vida, la pantalla de privacidad y las políticas de contraseña personalizada.

Capacidades básicas

setCredentials y getCredentials - Almacena y recupera credenciales de manera segura para un servidor determinado.
getSecureCredentials - Lee credenciales solo después de una verificación biométrica nativa.
isCredentialsSaved y deleteCredentials - Construye flujos de inicio de sesión, estado bloqueado y cierre de sesión.
isAvailable y verifyIdentity - Verifica la disponibilidad de la autenticación biométrica y solicita al usuario cuando sea necesario.

Public API

Método	Descripción
`isAvailable`	Verifica si el hardware de autenticación biométrica está disponible.
`addListener`	Agrega un oyente que se llama cuando la aplicación vuelve a funcionar desde el fondo. Esto es útil para detectar si la disponibilidad de biometría ha cambiado mientras la aplicación estaba en segundo plano (por ejemplo, el usuario se inscribió/desinscribió biometrías).
`verifyIdentity`	Pide al usuario que se autentique con biometrías.
`getCredentials`	Obtiene las credenciales almacenadas para un servidor dado.
`setCredentials`	Almacena las credenciales dadas para un servidor dado.
`deleteCredentials`	Elimina las credenciales almacenadas para un servidor dado.
`getSecureCredentials`	Obtiene las credenciales almacenadas para un servidor dado, requiriendo autenticación biométrica. Las credenciales deben haberse almacenado con accessControl configurado en BIOMETRY_CURRENT_SET o BIOMETRY_ANY.
`isCredentialsSaved`	Verifica si las credenciales ya están guardadas para un servidor dado.
`getPluginVersion`	Obtiene la versión del plugin nativo Capacitor.

Valores de referencia

Utiliza estos valores al manejar biometricError resultados de authenticate.

Errores de autenticación biométrica

Valor	Code	Plataforma	Significado
`UNKNOWN_ERROR`	`0`	Android, iOS	Ocurrió un error desconocido.
`BIOMETRICS_UNAVAILABLE`	`1`	Android, iOS	Los biometrios están deshabilitados porque el hardware está ausente o no está disponible.
`USER_LOCKOUT`	`2`	Android, iOS	El usuario está bloqueado después de demasiados intentos fallidos.
`BIOMETRICS_NOT_ENROLLED`	`3`	Android, iOS	No hay biométricas registradas en el dispositivo.
`USER_TEMPORARY_LOCKOUT`	`4`	Android	El usuario está temporalmente bloqueado, típicamente durante 30 segundos.
`AUTHENTICATION_FAILED`	`10`	Android, iOS	Falló la autenticación.
`APP_CANCEL`	`11`	iOS	La aplicación canceló el flujo de autenticación.
`INVALID_CONTEXT`	`12`	iOS	El contexto de autenticación es inválido.
`NOT_INTERACTIVE`	`13`	iOS	La autenticación no fue interactiva.
`PASSCODE_NOT_SET`	`14`	Android, iOS	No se ha configurado un código de acceso de dispositivo, PIN o credencial de respaldo.
`SYSTEM_CANCEL`	`15`	Android, iOS	La autenticación fue cancelada por el sistema, por ejemplo después de bloquear la pantalla.
`USER_CANCEL`	`16`	Android, iOS	El usuario canceló la autenticación.
`USER_FALLBACK`	`17`	Android, iOS	El usuario eligió la autenticación de respaldo.

Fuente de Verdad

Esta referencia está sincronizada desde src/definitions.ts en capacitor-biométrico nativo.

Continúa desde @capgo/capacitor-biométrico nativo

Si estás utilizando @capgo/capacitor-biométrico nativo para planificar la autenticación y los flujos de cuenta, conecta con Usando @capgo/capacitor-biométrico nativo para la capacidad nativa en Usando @capgo/capacitor-biométrico nativo, @capgo/capacitor-iniciación de sesión social para el detalle de implementación en @capgo/capacitor-iniciación de sesión social, @capgo/capacitor-clave de acceso para el detalle de implementación en @capgo/capacitor-clave de acceso, Autenticación de dos factores para el detalle de implementación en Autenticación de dos factores, y SSO (Empresas) para el detalle de implementación en SSO (Empresas).