API de autenticación facial para aplicaciones web

Construir autenticación facial desde cero implica gestionar comprobaciones de vivacidad, protección contra spoofing, comportamiento del motor de reconocimiento, calidad de coincidencia y captura de cámara entre navegadores antes de publicar el flujo real del producto. Es trabajo de infraestructura con consecuencias de seguridad y privacidad.

FACEIO reúne esas capas en una API gestionada y un SDK para navegador. Tu aplicación recibe un Facial ID y el resultado de autenticación, mientras tu backend sigue siendo responsable de la asignación del usuario, creación de sesiones, autorización y política de recuperación de cuentas. Los equipos suelen combinarlo con el servicio gestionado de autenticación facial para acelerar el despliegue.

La API de FACEIO y el fio.js SDK exponen dos métodos principales que cubren todo el ciclo de autenticación. Para controles por endpoint, consulta la referencia de la REST API.

• enroll()

  Inicia el flujo de registro en el widget de FACEIO. Después del consentimiento explícito del usuario, el motor de reconocimiento facial configurado crea el hash biométrico no reversible o la entrada del índice de la aplicación, y FACEIO devuelve un Facial ID. Tu backend almacena ese Facial ID asociado al registro del usuario.

• authenticate()

  Inicia un flujo de autenticación, comprueba la vivacidad y devuelve el Facial ID con cualquier payload asociado tras una coincidencia correcta. Tu backend puede validar el resultado y crear una sesión, incluidos los flujos de inicio de sesión sin contraseña descritos en Inicio de sesión biométrico para aplicaciones web.

La integración frontend es deliberadamente pequeña. El widget del SDK gestiona los permisos de cámara, la interfaz de captura y las comprobaciones de vivacidad, por lo que tu aplicación no tiene que implementar esas capas.

// Paso 1 - inserta el SDK en tu página
<script src="https://cdn.faceio.net/fio.js"></script>

// Paso 2 - inicializa con tu Public ID
const faceio = new faceIO('YOUR_APP_ID');

// Paso 3 - registra un usuario nuevo
faceio.enroll({ locale: 'auto', payload: { userId: 'abc123' } });

// Paso 4 - autentica en visitas posteriores
faceio.authenticate({ locale: 'auto' })
  .then((data) => sendToBackend(data.facialId, data.payload))
  .catch((err) => handleError(err));

Tras una llamada correcta de authenticate() , envía el facialId y el payload a tu servidor para crear una sesión de confianza. Para ver el recorrido completo, consulta la guía de integración, documentación de webhooks, y buenas prácticas de seguridad.

La API de FACEIO aplica una capa completa de seguridad en cada evento de autenticación. Estos controles están habilitados de forma predeterminada y no requieren configuración adicional. Para conocer la postura de la plataforma, consulta el Centro de confianza.

• Vivacidad y protección contra spoofing

  Cada captura se comprueba para confirmar la presencia humana real y está diseñada para rechazar ataques de presentación comunes, como fotos, imágenes impresas, vídeos pregrabados, repeticiones de pantalla, medios sintéticos e intentos con máscaras.

• Validación de la clave privada de la API

  Tu backend valida los eventos de autenticación con tu clave privada de la REST API. Mantén esa clave en el servidor para que las respuestas falsificadas o repetidas del frontend no se acepten como sesiones válidas.

• Facial IDs aislados por aplicación

  Cada aplicación FACEIO está aislada. Los Facial IDs, payloads e índices del motor de reconocimiento están delimitados por aplicación, mientras que los límites de frecuencia de la plataforma ayudan a reducir los intentos de fuerza bruta.

La mayoría de las integraciones con FACEIO utilizan uno de dos patrones, según los requisitos de confianza y cumplimiento: