Guía de referencia del Facial ID
Entiende el Facial ID de FACEIO, también llamado Index ID: cómo fio.js lo devuelve, cómo se asocia con los usuarios registrados, cómo aparece en los eventos de webhook y cómo eliminarlo mediante la REST API.
Conéctate a FACEIO Console para crear aplicaciones, gestionar APIs y configurar webhooks para eventos de registro, autenticación y Facial ID.
¿Qué es un Facial ID de FACEIO?
El identificador de un usuario registrado, válido únicamente dentro de tu aplicación FACEIO.
El Facial ID, también llamado Index ID, es el identificador único asignado a un usuario después de una operación de FACEIO enroll() correcta. Tu aplicación recibe este valor como facialId y puede utilizarlo para asignar un registro de FACEIO a una cuenta local.
Un Facial ID no es el correo electrónico, la contraseña, el nombre de usuario ni la clave primaria de la base de datos. Es el identificador que FACEIO devuelve para que tu aplicación reconozca al mismo usuario registrado en futuras llamadas de authenticate() y eventos de webhook relacionados.
Si esta es tu primera implementación de FACEIO, empieza con la guía de primeros pasos para crear una aplicación y obtener su Public ID. Después, utiliza la Guía de integración para conectar enroll(), authenticate() y la gestión del Facial ID con tu aplicación web.
Se crea durante el registro
Devuelto por enroll() después de que el usuario completa el flujo de registro de FACEIO.
Se devuelve durante el inicio de sesión
Devuelto por authenticate() para que tu aplicación identifique al usuario registrado y autenticado.
Se elimina cuando se solicita
Se elimina mediante el endpoint /deletefacialid de la REST API cuando un usuario desactiva la autenticación facial o solicita la eliminación.
Trata el Facial ID como un dato de seguridad de la cuenta. Guárdalo en el servidor cuando necesites vincular la autenticación de FACEIO a una cuenta local, evita exponerlo en registros públicos o analíticas y ofrece una vía de eliminación que cumpla tus obligaciones de privacidad y las Buenas prácticas de privacidad de FACEIO.
Cómo fio.js devuelve el Facial ID
FACEIO expone el Facial ID mediante la Promise resuelta que devuelven los métodos del lado del cliente fio.js . El objeto exacto contiene más campos, pero el valor importante para vincular la cuenta es facialId.
userInfo.facialIduserData.facialIdfacialIdSi pasas un payload durante el enroll(), FACEIO puede devolver ese payload durante futuras autenticaciones. Limita el payload a los valores que necesita tu aplicación y no utilices datos del payload del cliente como única comprobación de autorización.
Ciclo de vida del Facial ID
- 1. Crea una aplicación FACEIO. Usa la guía de primeros pasos y FACEIO Console ↗ para configurar tu aplicación, los ajustes del widget y las opciones de seguridad.
-
2. Registra al usuario. Sigue la Guía de integración, y después llama a
enroll()cuando el usuario decida activar la autenticación facial y conceda los permisos necesarios del navegador. -
3. Guarda el
facialId. Guárdalo en tu backend si necesitas asignar la autenticación de FACEIO a tu modelo de cuenta local. -
4. Autentica a los usuarios que regresan. Llama a
authenticate()y compara elfacialIdcon la cuenta o sesión que espera tu aplicación. - 5. Mantén el backend sincronizado. Usa webhooks cuando los eventos de registro, autenticación o eliminación del Facial ID deban actualizar el estado de la cuenta, los registros de auditoría o los controles de riesgo.
-
6. Elimina cuando sea necesario. Usa
/deletefacialidcuando un usuario retire su consentimiento, elimine su cuenta, desactive el inicio de sesión biométrico o solicite la eliminación.
El motor de reconocimiento facial
El motor de reconocimiento facial seleccionado transforma el rostro de un usuario registrado en un vector matemático de características que se utiliza para futuras comparaciones. FACEIO devuelve el Facial ID para que tu aplicación pueda referenciar el registro dentro de su propio flujo de cuentas.
FACEIO, incluidos fio.js, el widget integrado, la REST API y FACEIO Console, no almacena, gestiona ni tiene acceso a hashes biométricos. El motor de reconocimiento facial elegido por el propietario de la aplicación gestiona esos hashes según el motor, la región, el flujo de consentimiento y la política de eliminación configurados.
Motores de reconocimiento disponibles
Cuando creas una nueva aplicación ↗, FACEIO te permite elegir un motor de reconocimiento para esa aplicación. La elección del motor determina cómo se gestionan el registro y la comparación detrás del widget de FACEIO.
PixLab Insight
PredeterminadoEl motor predeterminado desarrollado por PixLab ↗ para las aplicaciones de FACEIO.
AWS Rekognition
Una opción de motor alternativa respaldada por la infraestructura de Amazon Web Services.
Usa FACEIO Console ↗ para crear una aplicación de prueba y validar qué motor y ajustes de seguridad se adaptan a tu experiencia de usuario, flujo de cuentas y requisitos de despliegue.
Vectores faciales y hashes biométricos
Un vector facial, también llamado hash biométrico, es un array de valores de punto flotante producido por el motor de reconocimiento seleccionado durante el registro. FACEIO no expone ese hash biométrico a tu aplicación mediante fio.js; tu aplicación recibe el Facial ID y los campos relacionados de la respuesta.
No trates un Facial ID como un identificador de perfil público ni lo expongas en registros del navegador, eventos analíticos, foros públicos de soporte o URL. Si lo almacenas localmente, guárdalo en el servidor con el mismo cuidado que aplicas a los datos de cuenta relacionados con la autenticación.
Para planificar la privacidad, combina esta referencia con las Buenas prácticas de privacidad, Buenas prácticas de seguridad, y Centro de confianza.
Cómo deben gestionar los desarrolladores los Facial IDs
- Guárdalo con los datos de la cuenta. Guarda el
facialIden tu backend cuando necesites vincular FACEIO a un registro de usuario local. - Realiza comprobaciones en el servidor. Utiliza el Facial ID devuelto como entrada para tu lógica de autorización, no como una concesión de sesión independiente.
- Mantén los payloads al mínimo. Si adjuntas un
payloaddurante el registro, incluye solo los datos que tu flujo de autenticación necesita realmente. - Sincroniza con webhooks. Usa eventos de webhook cuando los cambios en el estado del registro o la eliminación deban llegar a tu backend.
- Ofrece controles al usuario. Ofrece a los usuarios registrados una forma de desactivar el inicio de sesión biométrico o solicitar la eliminación del Facial ID.
- Documenta la conservación. Define cuándo se conservan, eliminan o desvinculan los Facial IDs en tu producto y en tus avisos de privacidad.
Eliminar Facial IDs con la REST API
La eliminación del Facial ID se realiza mediante el endpoint /deletefacialid de la REST API de FACEIO. Proporciona el Facial ID que deseas eliminar de la aplicación de destino mediante el formato de solicitud documentado en la
referencia de la REST API.
Tras una eliminación correcta, ese Facial ID registrado ya no podrá utilizarse para autenticar al usuario. Si el mismo usuario decide registrarse de nuevo, FACEIO crea un nuevo registro y devuelve un nuevo Facial ID.
Cuándo eliminar un Facial ID
- El usuario desactiva el inicio de sesión biométrico o retira su consentimiento para la autenticación facial.
- El usuario elimina su cuenta o solicita eliminar su registro de inscripción.
- Tu política de conservación indica que el registro ya no es necesario.
- Tu equipo de soporte o seguridad necesita desvincular al usuario del Facial ID actual y exigir un nuevo registro.
Para obtener orientación sobre producto y privacidad relacionada con la eliminación de usuarios, la retirada del consentimiento y la conservación, lee la Guía de buenas prácticas de privacidad. Para la gestión de eventos del backend, lee la referencia de Webhooks de FACEIO . Para conocer los controles de seguridad relacionados con la eliminación y la recuperación de cuentas, consulta las Buenas prácticas de seguridad.
Notas de privacidad y seguridad
Los Facial IDs se encuentran en la intersección entre autenticación, privacidad, recuperación de cuentas y consentimiento del usuario. Trátalos como identificadores sensibles para la seguridad, aunque no sean hashes biométricos. FACEIO no almacena, gestiona ni tiene acceso a hashes biométricos; el motor de reconocimiento seleccionado los gestiona mientras tu aplicación recibe el facialId para asociarlo a una cuenta.
Buenas prácticas de privacidad
Planifica el consentimiento del usuario, la eliminación del Facial ID, la conservación y los controles de privacidad de la cuenta antes del lanzamiento.
Ver la guía de privacidadBuenas prácticas de seguridad
Revisa las restricciones de dominio, la política de PIN, las comprobaciones de vivacidad, la validación de webhooks y la autorización del backend.
Ver la guía de seguridadEliminación mediante la REST API
Utiliza la REST API cuando un usuario desactive la autenticación facial, retire su consentimiento o solicite eliminar un Facial ID registrado.
Ver el endpoint de eliminaciónEventos de webhook
Utiliza webhooks para mantener tu backend sincronizado cuando los eventos de registro, autenticación o eliminación cambien el estado de la cuenta.
Ver webhooksEmpieza una integración de autenticación facial de 5 minutos...
Crea una aplicación FACEIO, implementa fio.js, guarda el facialId de forma segura y conecta los flujos de eliminación o webhook cuando tu backend los necesite.