Guía de implementación para desarrolladores
Utiliza esta lista antes de llevar la autenticación facial a producción
Esta guía está dirigida a equipos de ingeniería y producto que necesitan un plan práctico para implementar autenticación biométrica en una aplicación web. Para consultar la presentación comercial, los modelos de despliegue y el posicionamiento del producto, visita la página principal de autenticación biométrica para aplicaciones web.
1. Define la función de la autenticación
Antes de escribir código, decide en qué punto del recorrido del usuario se utilizará la autenticación facial. Esta decisión evita ambigüedades en el producto y simplifica el diseño técnico del sistema de autenticación.
Inicio de sesión principal
Utiliza FACEIO como método principal de autenticación sin contraseña después del registro facial del usuario.
Segundo factor
Conserva el inicio de sesión actual y añade autenticación facial para reforzar la protección de la cuenta.
Verificación adicional
Solicita un escaneo facial antes de acciones sensibles, como pagos, cambios administrativos o acceso a datos protegidos.
2. Prepara el flujo de autenticación web
Un flujo biométrico de producción requiere más que solicitar acceso a la cámara. Trata el widget del navegador, el backend y la capa de sesión como límites de confianza independientes.
- Crea una aplicación FACEIO en FACEIO Console y guarda el App ID público por separado de la clave privada de la REST API.
- Carga el SDK fio.js únicamente en las páginas donde se necesite registro, autenticación o una verificación adicional.
- Llama a
enroll()solo después de que el usuario acepte el aviso de consentimiento biométrico. - Llama a
authenticate()para iniciar sesión, verificar un segundo factor o aplicar una comprobación adicional definida por tu política. - Valida el evento de autenticación en el servidor antes de crear o ampliar una sesión. Consulta la REST API y la documentación de webhooks para implementar el backend.
3. Gestiona la detección de vida, el anti-spoofing y la recuperación
La autenticación facial debe evaluar una captura nueva y los indicadores de vivacidad sin crear callejones sin salida para el soporte. FACEIO proporciona resultados de autenticación y anti-spoofing, mientras que tu aplicación controla los reintentos, el acceso alternativo y las decisiones de riesgo.
Lógica de reintentos
Explica con claridad los errores de cámara, iluminación y permisos. Evita repetir capturas fallidas sin ofrecer una vía de recuperación.
Acceso alternativo
Define cómo recuperará el acceso un usuario si la cámara no está disponible, debe reiniciar su registro biométrico o necesita una revisión manual.
Tratamiento según el riesgo
En fintech, marketplaces y otros flujos que requieren comprobaciones adicionales, combina la autenticación biométrica con tus propios controles de riesgo. Consulta la guía de fintech y eKYC, ID Match y las buenas prácticas de seguridad para patrones de comparación facial y autenticación.
4. Confirma las reglas de privacidad, consentimiento y retención
La autenticación biométrica exige un nivel de confianza mayor que una contraseña. Los equipos de producto, legal e ingeniería deben acordar los avisos de consentimiento, los procedimientos de eliminación y el soporte antes del despliegue.
- Muestra un aviso claro de consentimiento biométrico antes del registro.
- Explica para qué se utiliza la autenticación facial y cómo puede rechazarla el usuario cuando corresponda.
- Documenta la eliminación de la cuenta, del Facial ID y del hash biométrico mediante el endpoint DELETEFACIALID de la REST API.
- Revisa la implementación con el Centro de confianza de FACEIO, la Política de privacidad, las buenas prácticas de privacidad y las buenas prácticas de seguridad.
5. Despliega por etapas
Un despliegue gradual permite obtener métricas más claras y reducir incidencias de soporte. Empieza con un grupo limitado y amplía el acceso cuando el registro, la tasa de autenticación, los reintentos y las solicitudes de soporte sean estables.
Prueba piloto
Activa primero la autenticación biométrica para empleados, usuarios beta o un segmento de bajo riesgo.
Producción
Amplía el despliegue cuando hayas confirmado la supervisión, los procedimientos de soporte y la validación en el backend.
6. Verificación en el backend y vinculación de sesión
Un error habitual es confiar en el resultado recibido por el cliente. El navegador no es un límite de confianza: los valores pueden modificarse o reproducirse. El backend debe verificar cada evento de autenticación antes de emitir una sesión.
- Verifica el resultado de autenticación en el servidor con la clave privada de la REST API y el Facial ID devuelto.
- Vincula la sesión al Facial ID verificado, no a un identificador proporcionado por el cliente.
- Rechaza resultados cuya validación del PIN Code, marca de tiempo, origen o correspondencia de usuario no coincida con tus registros.
- Registra el evento para auditoría sin incluir capturas, medios de verificación ni hashes biométricos en los logs de la aplicación.
Las buenas prácticas de seguridad, la página de la API de autenticación facial y la lista de verificación de la API explican estos patrones en detalle.
Recursos para implementar autenticación biométrica
Utiliza esta documentación de FACEIO para mantener alineadas la configuración, la integración frontend, la validación en el backend y las opciones de la consola.
Preguntas frecuentes
¿En qué se diferencia esta lista de la página comercial de autenticación biométrica?
Esta es una lista técnica para la implementación. La página principal de autenticación biométrica presenta el producto, los modelos de despliegue y su uso empresarial.
¿Puedo utilizar la autenticación facial como segundo factor sin sustituir las contraseñas?
Sí. FACEIO puede funcionar como inicio de sesión principal, segundo factor o verificación adicional. Para flujos de mayor riesgo, consulta la guía de prevención del fraude en comercio electrónico.
¿Qué ocurre si la cámara del usuario no está disponible?
Ofrece una vía alternativa, como contraseña, OTP, recuperación de cuenta o soporte, para que un problema de cámara, dispositivo o accesibilidad no bloquee al usuario.
¿Debo validar el resultado de autenticación en el backend?
Sí. No concedas una sesión a partir del resultado del cliente. El backend debe validarlo con la clave privada de la REST API, como se explica en las buenas prácticas de seguridad.
Guías relacionadas
Implementa la autenticación biométrica con una base sólida
Utiliza esta lista junto con la documentación de integración y vincula cada evento de autenticación con una decisión de sesión en el servidor. Para consultar el producto y sus opciones de implementación, visita la página de autenticación biométrica. Crea una aplicación FACEIO en la consola, copia el App ID público y empieza a integrar fio.js.