Biometric Authentication API
Prompt fingerprint or face authentication with the native Android BiometricPrompt directly from your web app.
La API de autenticación biométrica solicita al usuario que se autentique mediante huella dactilar o rostro utilizando el BiometricPrompt nativo del dispositivo. Si el sistema operativo está configurado de esa manera, recurre al PIN o al patrón del dispositivo.
Cómo utilizarla:
Active el cuadro de diálogo del sistema desde un enlace HTML o desde JavaScript:
<a href="bioauth://">Unlock</a>
window.location.href = "bioauth://";
Casos de uso típicos:
- Restringir el acceso a una página de «cartera», «configuración» o «pedidos» dentro de su aplicación web.
- Exigir una nueva autenticación antes de un paso sensible del proceso de compra.
Comportamiento:
- El cuadro de diálogo del sistema lo dibuja la app; su aplicación web no necesita renderizar ninguna interfaz.
- Tras una autenticación correcta, la app se reanuda con normalidad para que su aplicación web pueda reaccionar (por ejemplo, navegando a la página protegida).
- En algunos dispositivos sin biometría, el sistema operativo puede mostrar un aviso de PIN en su lugar.
Configuración relacionada:
enableBioMetricAuth en Config.java activa el flujo integrado de bloqueo de la app, que requiere autenticación biométrica en cada inicio de la aplicación. bioauth:// es independiente de este indicador y puede activarse en cualquier momento desde JavaScript.
Notas de implementación estilo SDK
Trate esta función como una capacidad nativa expuesta a su capa web: mantenga su sitio web de producción o PWA como fuente de verdad y, a continuación, utilice los indicadores de configuración de WebViewGold, los comandos de URL y las llamadas del puente de JavaScript documentados para activar el comportamiento nativo de Android solo donde aporte valor. Este enfoque mantiene su código fácil de mantener, porque la misma aplicación web puede servir a los navegadores, a WebViewGold para Android y a las demás plataformas de WebViewGold con una lógica condicional mínima.
Para obtener resultados fiables, opte por puntos de conexión HTTPS, nombres de ruta estables, estados de éxito/error explícitos en su interfaz y pequeñas funciones auxiliares de JavaScript que envuelvan las llamadas nativas. Por ejemplo, una aplicación web creada con jQuery Mobile, Lovable, Base44, Bolt, WordPress, Bubble, una pila propia de React/Vue/Angular o HTML estático puede exponer un único botón o controlador de eventos que active la API nativa de WebViewGold y, aun así, muestre una alternativa elegante en el navegador.
- Patrón de integración recomendado: detecte el contexto de la app, llame a la API de WebViewGold y luego actualice su interfaz web tras la devolución de llamada nativa o el cambio de ruta.
- Lista de comprobación de pruebas: valide la función en un dispositivo real o en una compilación empaquetada, verifique los permisos y el texto de revisión de la tienda, y confirme que los usuarios que solo usan el navegador siguen recibiendo una alternativa útil.
- Ventaja para el SEO: mantenga las páginas de funciones, los títulos de ruta y el contenido estructurado indexables en su sitio web, mientras WebViewGold ofrece la carcasa nativa de la app para los usuarios de Android.