Preguntas frecuentes

Respuestas breves para equipos que desarrollan con la autenticación facial de FACEIO, ID Match y Meeting Shield. Consulta notas prácticas sobre fio.js, enroll(), authenticate(), Facial IDs, webhooks, uso de la REST API, detección de deepfakes en reuniones y configuración de FACEIO Console.

Conéctate a FACEIO Console para crear aplicaciones, gestionar APIs y configurar webhooks para eventos de registro, autenticación y Facial ID.

Encuentra el punto de partida adecuado

Usa estas preguntas frecuentes para aclarar un punto concreto de la implementación. Después, consulta la guía de configuración, la referencia de integración de fio.js, la documentación del backend o FACEIO Console ↗ según lo que vayas a desarrollar.

Icono de primeros pasos

Primeros pasos

Crea tu primera aplicación FACEIO, copia tu Public ID y añade autenticación facial a un flujo web.

Comenzar
Icono de configuración de integración

Integración de fio.js

Usa enroll(), authenticate(), y la gestión de sesiones para sustituir el inicio de sesión basado solo en contraseña por autenticación facial.

Ver la referencia de la API

Primeros pasos

¿Qué es FACEIO?

FACEIO es un framework de autenticación facial para aplicaciones web y móviles. Los desarrolladores lo utilizan para añadir inicio de sesión con reconocimiento facial, autenticación sin contraseña y reautenticación de cuentas sin construir su propia infraestructura de reconocimiento.

La integración comienza con fio.js, la biblioteca JavaScript que se ejecuta en el navegador y está documentada en la Guía de integración de FACEIO. Los usuarios se registran y autentican mediante un widget alojado que funciona con una webcam o la cámara frontal del móvil.

¿Quién creó y mantiene FACEIO?

FACEIO está desarrollado y mantenido por PixLab ↗, que forma parte de Symisc Systems ↗. FACEIO ofrece autenticación facial compatible con distintos navegadores, el widget ID Match para comparar una selfie con el retrato de un documento y Meeting Shield para reuniones compatibles en el navegador. Son productos separados con finalidades diferentes.

Para conocer las prácticas de privacidad, seguridad y operación, empieza por el Centro de confianza, guía de buenas prácticas de privacidad y guía de buenas prácticas de seguridad.

¿Cómo añado autenticación facial a mi aplicación web?
  1. Crea una aplicación en FACEIO Console ↗.
  2. Copia el Public ID de tu aplicación.
  3. Añade fio.js a tu sitio web o aplicación web.
  4. Llama a enroll() para registrar usuarios y authenticate() para el inicio de sesión de usuarios recurrentes.

La ruta más rápida es la guía de primeros pasos. Para código de producción, continúa con la referencia de la API y guía de integración de fio.js.

¿FACEIO es una API, un SDK o un widget alojado?

FACEIO combina varios componentes: el fio.js SDK de JavaScript, un widget seguro para el navegador, servicios de autenticación facial en el backend, REST APIs opcionales y eventos de webhook para tu servidor.

La mayoría de las integraciones de autenticación facial comienzan con el widget alojado porque gestiona la captura de cámara, las comprobaciones de vivacidad, la comparación facial y la compatibilidad con el navegador. El widget presenta el flujo de consentimiento configurado, mientras el propietario sigue siendo responsable de los avisos y del consentimiento. Después pueden conectarse webhooks, endpoints de la REST API y flujos de Facial ID.

¿FACEIO funciona en navegadores móviles?

Sí. FACEIO está diseñado para navegadores modernos de escritorio y móviles que pueden acceder a una webcam o cámara frontal. Utiliza el mismo patrón fio.js para los flujos web de escritorio y móviles, y después prueba los permisos de cámara y el comportamiento del navegador antes del lanzamiento.

Para consultar notas sobre navegadores y frameworks, revisa el Centro para desarrolladores y la guía de integración.

Integración y documentación de la API

¿Dónde pueden encontrar los desarrolladores la documentación oficial de FACEIO?
  • Primeros pasos para la primera aplicación y una configuración rápida.
  • Guía de integración para fio.js, enroll(), authenticate(), gestión de errores y sesiones.
  • Centro para desarrolladores para ejemplos de frameworks, REST APIs, webhooks, privacidad, seguridad y referencias de producción.
  • Webhooks y los Facial ID para sincronizar el backend y gestionar el ciclo de vida de los usuarios registrados.
¿Qué frameworks de JavaScript admite FACEIO?

FACEIO no depende de un framework concreto. Puedes cargar fio.js desde HTML puro, React, Vue, Next.js, Angular, jQuery o cualquier frontend que pueda ejecutar JavaScript en el navegador y solicitar permiso para la cámara.

Tu backend puede estar escrito en Node.js, PHP, Python, Go, Rust, Java, .NET o cualquier stack capaz de recibir webhooks y realizar solicitudes HTTPS a la REST API. Comienza por el Centro para desarrolladores y la guía de integración.

¿Puede FACEIO sustituir el inicio de sesión con contraseña?

Sí. FACEIO puede utilizarse como una capa de inicio de sesión facial sin contraseña, un paso de verificación de segundo factor o una etapa de reautenticación antes de acciones sensibles. El patrón adecuado depende de tu modelo de sesión, flujo de recuperación de cuenta y requisitos de consentimiento del usuario.

Para planificar, compara la guía de autenticación sin contraseña, la guía de inicio de sesión facial y la documentación de buenas prácticas de seguridad.

¿FACEIO admite webhooks?

Sí. Los webhooks permiten que tu backend reciba eventos de registro de usuarios, autenticación correcta y eliminación de Facial IDs. Esto resulta útil cuando el servidor debe sincronizar el estado de la cuenta, escribir registros de auditoría o activar flujos de la aplicación.

Valida el WWW-Authenticate token bearer y los identificadores esperados de la aplicación antes de confiar en el payload de un webhook.

¿Qué es un Facial ID de FACEIO?

Un Facial ID, también llamado Index ID, es el identificador de FACEIO asociado al registro de autenticación facial de un usuario registrado. Ayuda a los desarrolladores a gestionar el estado de autenticación, las solicitudes de eliminación y la vinculación de cuentas sin exponer imágenes faciales sin procesar, vectores faciales ni hashes biométricos a la aplicación.

¿Cómo utilizo la REST API de FACEIO?

La REST API se utiliza para operaciones privadas del backend, como gestionar datos de la aplicación, trabajar con Facial IDs y eliminar registros de usuarios. Es independiente de la instanciación del widget mediante fio.js, que se ejecuta en el navegador del usuario.

Obtén tu clave de API desde el Application Manager de FACEIO Console ↗, guárdala en el servidor y revisa la documentación de la REST API antes de realizar llamadas en producción.

¿Qué es un Facial ID y cómo lo elimino?

Un Facial ID es un identificador único anónimo, similar en propósito a un UUID ↗, asignado por el motor de reconocimiento facial a cada usuario registrado en tu aplicación FACEIO después de obtener su consentimiento explícito. Permite que el backend relacione la autenticación facial con sus propios registros de cuenta y mantenga los datos visibles para el usuario separados del índice del motor de reconocimiento facial.

El registro facial se crea con una sola llamada a enroll() desde fio.js, la biblioteca de widgets JavaScript implementada en tu sitio web o aplicación web.

Para eliminar un Facial ID, realiza una llamada a la REST API desde tu backend privado al endpoint DELETEFACIALID. Una llamada correcta elimina por completo el Facial ID, los datos del payload asociados y el hash biométrico de esa aplicación FACEIO. El endpoint está documentado en la referencia de la REST API.

Hay un ejemplo en Python para eliminarlo desde el backend en forma de GitHub Gist ↗. Para consultar las prácticas de privacidad y cumplimiento, visita el Centro de confianza de FACEIO.

¿Puedo personalizar el widget de FACEIO?

Sí. El Application Manager te permite ajustar la apariencia del widget, añadir tu logotipo, configurar enlaces legales y establecer opciones de seguridad para cada aplicación FACEIO. Mantén claros el consentimiento y los enlaces legales porque forman parte del flujo de autenticación que ve el usuario.

Crea o actualiza la configuración del widget desde FACEIO Console ↗, y después prueba el flujo en los navegadores y dispositivos que utilizan tus usuarios.

Productos y verificación

¿Qué motor de reconocimiento facial debo elegir?

El motor de reconocimiento facial transforma el rostro de un usuario registrado en un vector matemático de características, que normalmente se gestiona como un hash biométrico dentro de un índice de aplicación aislado. FACEIO admite PixLab Insight y AWS Rekognition; el propietario de la aplicación configura el motor, la región y el modelo de despliegue.

Elige en función de la residencia de datos, los requisitos del proveedor cloud, las necesidades on-premise y tu revisión legal y de seguridad. Utiliza la referencia de Facial ID, guía de buenas prácticas de privacidad, guía de buenas prácticas de seguridad y la FACEIO Console ↗ para probar la configuración.

¿Puede FACEIO ejecutarse on-premise?

FACEIO admite motores de reconocimiento facial en la nube y una opción on-premises con PixLab Insight dentro de la infraestructura controlada por el cliente. El propietario selecciona y configura el motor, la región, las credenciales y el modelo de despliegue. Contacta con el equipo mediante el canal de soporte de FACEIO Console ↗ para planificarlo.

¿Qué es FACEIO Meeting Shield?

FACEIO Meeting Shield es una extensión de Chrome que evalúa señales de riesgo de deepfakes y vídeo sintético en reuniones compatibles basadas en el navegador. Es independiente de la autenticación facial con fio.js y no garantiza detectar todos los vídeos manipulados.

¿Qué es FACEIO ID Match?

FACEIO ID Match es un widget integrable que captura una selfie en vivo y un documento, comprueba la vivacidad y compara la selfie con el retrato del documento. Los integradores llaman a idmatch() para abrir el flujo en el navegador.

FACEIO proporciona detección facial, vivacidad y comparación 1:1. El endpoint DOCSCAN API ↗ de PixLab escanea el documento y puede extraer campos opcionales. ID Match no autentica el documento, no establece la identidad legal, no completa controles KYC o AML y no toma decisiones de aprobación.

¿En qué se diferencia ID Match de la autenticación facial estándar?

La autenticación facial estándar de FACEIO registra a un usuario y posteriormente autentica a ese usuario recurrente contra su registro. ID Match no registra ni autentica a la persona: realiza una comparación puntual 1:1 entre una selfie en vivo y el retrato del documento presentado y puede devolver campos extraídos.

La implementación sigue el mismo patrón de integración de fio.js descrito en la guía de integración, pero el flujo de verificación llama a idmatch() en lugar de enroll() o authenticate().

Precios y cuenta

¿Dónde gestiono las aplicaciones y la facturación?

Utiliza FACEIO Console ↗ para crear aplicaciones, copiar Public IDs, configurar la apariencia del widget, gestionar opciones de seguridad, revisar el uso, abrir solicitudes de soporte y gestionar la facturación.

Para consultar los detalles de los planes públicos, visita la página de precios de FACEIO.

¿Hay un plan gratuito para probar FACEIO?

FACEIO ofrece planes adecuados para prototipos, MVP y aplicaciones en producción. Consulta la página de precios para conocer los límites, funciones y opciones de actualización actuales. Después, crea o actualiza tu aplicación desde FACEIO Console ↗.

¿Cómo creo mi primera aplicación FACEIO?

Inicia sesión en FACEIO Console ↗, selecciona Nueva aplicación, sigue el asistente y utiliza el Public ID generado en tu integración con fio.js.

La guía de primeros pasos explica el mismo proceso con el código mínimo necesario para registrar y autenticar a tu primer usuario.

¿Cómo creo o cierro una cuenta de FACEIO?

Crea una cuenta desde la página de registro de FACEIO Console ↗ y después crea tu primera aplicación desde el panel. Los pasos de verificación se realizan en FACEIO Console durante la configuración de la aplicación.

Para cerrar una cuenta, elimina las aplicaciones que ya no necesites, resuelve las suscripciones activas y utiliza los controles de cuenta o el canal de soporte privado de FACEIO Console ↗. La eliminación de la cuenta es permanente, así que exporta todo lo que necesites antes de solicitar el cierre.

¿Dónde se almacena la información de facturación?

FACEIO no almacena los datos completos de la tarjeta de crédito en FACEIO Console. Cuando corresponde, los pagos y las suscripciones son gestionados por el comerciante o procesador de pagos que se muestra durante el proceso de pago.

Para cambios de plan, facturas y preguntas privadas sobre facturación, utiliza el canal de soporte de FACEIO Console ↗.

Privacidad y seguridad

¿Quién es responsable de utilizar FACEIO de forma segura en producción?

El propietario de la aplicación es responsable de cómo se utiliza FACEIO en su producto. Esto incluye cuándo se muestra el widget, qué se comunica a los usuarios, cómo se obtiene el consentimiento, qué motor de reconocimiento se selecciona, qué opciones de seguridad se activan y qué sucede después de que FACEIO devuelve un resultado de autenticación.

FACEIO es un framework de autenticación facial preparado para producción, desplegado desde 2022, con más de 9 millones de instancias del widget servidas y miles de clientes en todo el mundo. Esta experiencia no sustituye tus responsabilidades de seguridad, privacidad, aspectos legales y consentimiento en el nivel de tu aplicación.

FACEIO proporciona el widget para el navegador, APIs, webhooks y orientación de implementación. No es responsable del uso indebido de una aplicación, la falta de avisos a los usuarios, una recuperación de cuenta débil, una gestión insegura de sesiones ni las decisiones posteriores tomadas por la aplicación. Antes del lanzamiento, revisa la guía de buenas prácticas de seguridad, guía de buenas prácticas de privacidad y Centro de confianza.

¿FACEIO almacena imágenes faciales sin procesar o hashes biométricos?

No. FACEIO, incluidos fio.js, el widget integrado, la REST API y FACEIO Console, no conserva imágenes faciales sin procesar ni almacena o expone hashes biométricos. Tu aplicación recibe identificadores y resultados de autenticación, no imágenes faciales sin procesar, vectores faciales ni hashes biométricos.

El motor de reconocimiento facial seleccionado gestiona los vectores faciales o firmas hash según la configuración, la región, el flujo de consentimiento y la política de eliminación del propietario de la aplicación. Los propietarios son responsables de seleccionar el motor, explicar el flujo a los usuarios y ofrecer opciones de eliminación o exclusión. Lee la referencia de Facial ID, guía de buenas prácticas de privacidad y Centro de confianza.

¿FACEIO almacena hashes biométricos sin el consentimiento del usuario?

No. FACEIO no almacena hashes biométricos. El motor de reconocimiento facial seleccionado crea y gestiona un hash biométrico únicamente mediante el flujo de registro después del consentimiento explícito del usuario. El hash es un vector matemático, no una imagen facial sin procesar, y no se devuelve a tu frontend.

Cada aplicación FACEIO utiliza su propio índice aislado. No existe una base de datos centralizada de hashes biométricos de los clientes, y los flujos de eliminación se gestionan mediante las Facial ID y los REST API documentados. Los propietarios de las aplicaciones siguen siendo responsables de los avisos legales, el consentimiento, las decisiones de conservación y las solicitudes de eliminación de los usuarios.

¿Las comprobaciones de vivacidad y anti-spoofing garantizan el bloqueo de todos los ataques?

No. Las comprobaciones de vivacidad y anti-spoofing de FACEIO forman parte del flujo de autenticación facial, pero ningún sistema de detección puede garantizar que se bloquee todo ataque de presentación, intento de repetición, automatización o patrón de abuso de cuenta.

Los propietarios deben combinar FACEIO con la validación predeterminada por PIN Code, restricciones de dominio, límites de frecuencia, reglas de recuperación de cuenta, comprobaciones de autorización en el servidor, validación de webhooks y procesos de soporte adecuados. Utiliza la guía de buenas prácticas de seguridad para decidir qué controles corresponden a tu aplicación.

¿Cómo mejora la seguridad de FACEIO el PIN Code predeterminado?

FACEIO activa de forma predeterminada la validación mediante PIN Code. El PIN añade un secreto conocido por el usuario, por lo que el flujo configurado exige más que una coincidencia facial. Es un factor de autenticación adicional, no un detector de deepfakes, y debe combinarse con vivacidad y controles de seguridad de la aplicación.

Los propietarios pueden revisar los requisitos del PIN Code, el rechazo de PIN débiles, las restricciones de dominio y país y otros controles de seguridad desde el Application Manager de FACEIO Console ↗. La configuración recomendada está documentada en la guía de buenas prácticas de seguridad.

¿Puedo restringir FACEIO a dominios o países aprobados?

Sí. Los propietarios pueden restringir la instanciación del widget a nombres de dominio aprobados y, cuando se configura, a países aprobados. Estos controles ayudan a evitar que sitios no autorizados carguen tu aplicación FACEIO y reducen el tráfico no deseado de regiones a las que no prestas servicio.

Configura estas opciones en la pestaña SECURITY del Application Manager y verifica el comportamiento antes del despliegue en producción. Consulta la guía de buenas prácticas de seguridad para obtener orientación sobre el despliegue.

¿Por dónde debería comenzar la revisión de privacidad, aspectos legales y seguridad?

Comienza por el Centro de confianza, guía de buenas prácticas de privacidad y guía de buenas prácticas de seguridad. Los equipos de producto, legal e ingeniería también deben revisar la Política de privacidad y los Términos de uso antes de desplegar FACEIO para usuarios reales.

La documentación de FACEIO ayuda a los equipos a implementar la autenticación facial de forma responsable, pero no sustituye la revisión legal y de seguridad del propietario de la aplicación, los avisos a los usuarios, el flujo de consentimiento, el proceso de soporte ni las obligaciones de cumplimiento de los mercados donde opera la aplicación.

Soporte y comunidad

¿Dónde puedo hacer preguntas sobre la implementación?

Utiliza el Foro de la comunidad FACEIO ↗ para preguntas públicas de implementación, debates entre desarrolladores y temas específicos que pueden ayudar a otros equipos a integrar la autenticación facial.

Utiliza el canal de soporte de FACEIO Console ↗ para cuestiones privadas de cuenta, facturación, producción, seguridad o específicas de un cliente.

¿Cuándo debo utilizar el Foro de la comunidad en lugar del soporte?

Utiliza el foro para preguntas reutilizables, como ejemplos de frameworks, patrones de integración, gestión de webhooks, UX del inicio de sesión facial, implementación de ID Match y notas de solución de problemas que no expongan datos privados de la cuenta.

Utiliza el soporte privado cuando el problema incluya IDs de aplicaciones, datos de facturación, datos de usuarios, incidentes de producción o información de seguridad sensible.

¿Dónde puedo consultar el estado del servicio FACEIO?

Utiliza la página de estado de FACEIO ↗ para consultar la disponibilidad actual del servicio y las actualizaciones de incidentes. Para obtener ayuda con la implementación, utiliza la página de soporte o abre una solicitud privada desde FACEIO Console.

Crea, prueba y protege tu flujo de FACEIO

Crea una aplicación en FACEIO Console para probar fio.js, ID Match, webhooks, acceso a la REST API y controles de seguridad predeterminados como PIN Code. Utiliza el Foro de la comunidad para preguntas públicas de implementación que puedan ayudar a otros desarrolladores.