Guía de FACE AUTH

FACE AUTH es un servicio complementario (add-on) que verifica de forma inmediata si un usuario es la misma persona comparando la selfie (Referencia) de un Submission ID obtenido del eKYC existente con la selfie más reciente del usuario (Objetivo). Puede completar la reautenticación con una sola selfie sin un proceso complejo adicional.

Casos de uso representativos

Como la identidad puede reverificarse con una sola selfie sin contraseña ni código de autenticación, puede reforzar la seguridad y reducir la fricción del usuario al mismo tiempo.

Cambio de dispositivo

Usado por instituciones financieras como medio de reautenticación para reducir el riesgo de robo de cuentas durante el cambio de dispositivo o número.

Reautenticación ante detección de anomalías

Prevención de ATO - Aplique políticas de bloqueo/desbloqueo de acceso con autenticación facial adicional cuando se detecten inicios de sesión de alto riesgo, acceso desde el extranjero o intentos masivos.

Reverificación periódica de identidad

KYC Refresh periódico - Utilizado como procedimiento de verificación periódica de la misma persona en servicios de alto valor o industrias reguladas.

Pérdida de contraseña / Cambio de información

Inserte como paso de verificación de identidad antes de cambios importantes en la cuenta, como restablecimiento de contraseña, cambio de método de pago o de contacto.

Método de operación (3 pasos)

Prerrequisito

Debe existir un Submission aprobado de eKYC. (Referencia)

Proceso

Llame a la URL del Add-On (incluyendo pid + Submission ID) → Tome la selfie

Al acceder desde escritorio, se muestra un QR → Continúe la captura en el móvil.

Evaluación/Almacenamiento

Comparación automática de registrado vs verificado → Los resultados se almacenan en el dashboard como Auth ID (submission).

Verificaciones clave

Debe existir un Submission ID aprobado. (Referencia)
La URL de FACE AUTH debe estar cifrada por seguridad al usarse.
Las políticas de threshold, liveness y occlusion (mascarilla/casco/gorro, etc.) pueden controlarse a través de las opciones del proyecto.

Beneficios de FACE AUTH

Beneficio	Descripción
Reautenticación rápida	Complete con una sola selfie sin volver a fotografiar el ID
Refuerzo de seguridad	Proteja cuentas como factor adicional junto con contraseña y OTP
Flexibilidad de políticas	Ajustes detallados por situación como threshold de coincidencia facial, liveness, bloqueo por occlusion
Integración sencilla	Opera como add-on dependiente del proyecto eKYC existente, manteniendo consistencia operativa

Creación y configuración del proyecto

Para usar FACE AUTH, primero cree un proyecto Add-On en el dashboard y configure las políticas (threshold, liveness, occlusion).

Paso 1: Crear proyecto Add-On

Seleccione menú Add-On → ‘Create Project’ en el dashboard para crear un nuevo proyecto FACE AUTH. La conexión de dependencia con el proyecto eKYC se forma inmediatamente tras la creación, y la URL del Add-On y la API key se mapean automáticamente.

Path: Dashboard > Add-On > Create Project

Pantalla de creación de proyecto Add-On — Pantalla antes de crear el proyecto

Paso 2: Configuración de información del proyecto

Especifique el nombre y logo del proyecto en la pantalla de configuración, y establezca el botón/URL para redirigir después de completar el envío de autenticación.

Elemento de configuración	Descripción
Project Name	Se muestra como título en la pantalla de inicio de autenticación
Project Status	Service (operación normal) / Closed (autenticación desactivada)
Add on Logo	Se muestra en la parte superior de la primera pantalla de autenticación (se muestra el logo de ARGOS si no se configura)
Return URL	URL donde se redirige al usuario después de completar la autenticación

Paso 3: Configuración de políticas (Threshold)

Los thresholds son más permisivos cuando son más bajos, más estrictos cuando son más altos. Ajuste paso a paso para adaptarse a los objetivos de riesgo y UX del servicio.

Elemento de política	Descripción	Valor recomendado
Face Authentication Threshold	Criterio para determinar si es la misma persona que la cara del usuario aprobado en eKYC	98 puntos
Liveness	Determina si la selfie tomada es de una persona real viva (Passive/Active)	70 puntos
Face Occlusion	Comprueba si el rostro no está ocluido por otros objetos durante la autenticación	-

Face occlusion y face occlusion threshold no pueden usarse simultáneamente.

Opciones para entornos especiales:

Head Occlusion Threshold: Entornos que requieren casco de seguridad (moto, obra, etc.)
Face Occlusion Threshold: Entornos que requieren mascarilla (hospital, obra, etc.)

Paso 4: Parámetros de URL del Add-On y configuración de cifrado

Se deben registrar los parámetros requeridos para usar la URL de FACE AUTH. Parámetros requeridos:

Parámetro	Descripción
`pid`	ID del proyecto Add-On (incluido en la ruta/parámetros de la URL)
`sid`	Submission ID de eKYC (la autenticación Add-On solo es posible en estado aprobado, se requiere cifrado)

Parámetros opcionales:

Parámetro	Descripción
`authUserId`	ID de usuario a asignar a este usuario (puede ser el ID de usuario de su propio servicio o el mismo `userId` usado en eKYC)
`authCf1`	Campo personalizado para información adicional (por ejemplo, una dirección de correo)
`authCf2`	Campo personalizado para información adicional
`authCf3`	Campo personalizado para información adicional
`token`	Token ID para una URL de un solo uso (activo cuando Configuración de condiciones de expiración de Token está habilitado)
`lang`	Idioma de visualización de la pantalla FACE AUTH (código ISO 639-1 en minúsculas, p. ej. `en`). No está sujeto a cifrado — añádalo en texto plano fuera de `encrypted`. Si se omite, en móvil se usa el idioma del dispositivo y en PC el del navegador

Los parámetros opcionales también deben enviarse dentro de encrypted. Para la definición detallada de cada parámetro, consulte Comenzar con FaceAuth — Definición de parámetros de solicitud.

Ejemplo de patrón de URL:

...?pid={ADDON_PID}&encrypted={encrypted}

El texto plano detrás de encrypted es un objeto JSON serializado. Incluya el Submission ID en la clave sid y el Token ID en token. Si cifra una carga con formato de cadena de consulta (sid=...&token=...), los valores no se reconocen.

Texto plano que se cifra

{ "sid": "{Submission ID aprobado de eKYC}", "token": "{tokenId}" }

Codifique para URL el resultado en Base64 antes de añadirlo a la URL. Para el procedimiento completo, consulte Comenzar con FaceAuth — QueryString para acceder a FaceAuth.

Configuración de condiciones de expiración de Token

Puede configurar un control de acceso limitado a través del Token ID.

Condición de expiración	Descripción
Usage-based Expiration	Expira el Token ID cuando el token se usa una vez
Time-based Expiration	Mide el tiempo desde que el token se usa una vez y expira el Token ID

La condición de activación de la expiración es cuando se hace clic en el botón “Start” en la primera pantalla de FACE AUTH.

Configuración de la URL de retorno

La tarjeta AddOn Return URL define a dónde vuelve el usuario tras la autenticación y qué campos se envían con él. Los campos seleccionados se añaden a la consulta de la URL de retorno en el orden siguiente.

Ajuste	Parámetro de consulta	Valor
Authentication Result	`authStatus`	Resultado de autenticación (`approved` / `rejected`)
Authentication ID	`authId`	Clave del envío de FaceAuth, usada por las API de consulta, imagen y eliminación
User ID	`authUserId`	ID de usuario enviado en la entrada
Custom Field #1–#3	`authCf1` – `authCf3`	Campos personalizados enviados en la entrada

Ejemplo de URL de retorno final

https://yourapp.com/callback?authStatus={authStatus}&authId={authId}&authUserId={authUserId}&authCf1={authCf1}&authCf3={authCf3}

Conmutador	Comportamiento
Skip Result Page	Envía al usuario directamente a la URL de retorno sin mostrar la pantalla de resultado de FaceAuth. No tiene efecto si no hay URL de retorno configurada.
Encryption	Agrupa los campos seleccionados en un único parámetro `encrypted`. Descífrelo con AES-256-ECB, el mismo esquema que la URL de retorno de ID Check.

Los parámetros de la URL de retorno pasan por el navegador del usuario y pueden manipularse. No apruebe basándose solo en authStatus: vuelva a comprobarlo en el servidor llamando a la API de consulta individual con authId, o use el webhook de FaceAuth.

La URL de retorno de ID Check (Liveform) se gestiona por separado en Información de integración > URL de retorno del proyecto principal y envía parámetros distintos. Ambas configuraciones son independientes. → Guía de URL de retorno

Provisión a usuarios

FACE AUTH puede proporcionarse de dos formas.

A. URL del Add-On (recomendado)
B. Integración basada en API

Guíe a los usuarios para abrir la URL del Add-On y proceder con la reautenticación mediante captura de selfie en la pantalla web.Parámetros requeridos:

pid={AddOn Project ID} — incluido en el query string de la URL en texto plano
encrypted={...} — el JSON {"sid": "{Submission ID aprobado de eKYC}"} cifrado con AES-256 y luego codificado para URL (consulte Paso 4)

Patrón de URL

https://form.argosidentity.com/face-auth?pid={ADDON_PID}&encrypted={encrypted}

Transición Escritorio → Móvil: Al abrirlo en PC, se muestra un código QR para que los usuarios lo escaneen con su teléfono y continúen la captura.

Lista de verificación

✅ Conecte la URL del Add-On a un enlace/botón
✅ Verifique que sid no falte y que la submission de eKYC esté en estado approved
✅ Los parámetros sensibles como sid deben incluirse dentro de encrypted — nunca expuestos en texto plano
✅ Si el tráfico de escritorio es alto, coloque texto guía de transición QR en posición fija superior

Verificación de operación (Smoke Test)

Si aparece la pantalla de autenticación cuando se llama a la URL del Add-On con un submissionId aprobado
Si la visualización del QR y la transición al móvil son naturales al acceder desde PC
Si los resultados se almacenan y consultan como submission del Add-On (Auth ID) después de la captura

AUTH ID - Verificación de resultado de autenticación

Auth ID se refiere a un resultado (submission) de FACE AUTH (add-on). Se registran juntos la evaluación de misma persona comparando la copia registrada (cara aprobada previamente de eKYC) con esta selfie (copia verificada), el snapshot de la política aplicada y la línea de tiempo del procesamiento.

Ver resultados en el dashboard

Dashboard > Proyecto Add-On (FACE AUTH) > Lista de Submissions (Auth ID) > Vista de detalle

Información visible en la pantalla de lista:

Hora
AUTH ID (TARGET)
Submission ID (Reference)
Estado

Información visible en la pantalla de detalle:

Snapshot de política
Puntuación/threshold
Resultados de liveness y occlusion
Imágenes de comparación
Logs

Dashboard de Auth ID del proyecto Add-On

Información detallada de Auth ID

Campo	Descripción
Authentication ID	Identificador único del submission
Submission ID	Submission aprobado previamente referenciado como objetivo de comparación durante el submission
Status	Muestra el resultado de autenticación como Approved, Rejected
Policy	Opciones del proyecto aplicadas cuando se procesó el submission
FACE Similarity	Similitud entre imágenes de selfie medida durante la autenticación
Liveness	Puntuación de liveness de la selfie enviada
Face Occluded	Resultado que evalúa si el rostro está ocluido como Pass / Fail

La información de referencia prioriza la comparación de Selfie, y si la Selfie no está disponible, utiliza el retrato del ID como secundario para la comparación.

Integración en tiempo real vía Webhook

Cuando FACE AUTH finaliza y los resultados finales están disponibles, los resultados se envían automáticamente a la URL de Webhook registrada en el proyecto de ID Check existente. Tipo de trigger: "faceAuth"

{
  "webhook_trigger": "faceAuth",
  "Authentication_id": "AUTH_...",
  "data": {
    "Submission_id": "SUB_...",
    "Auth_Status": "approved | rejected",
    "Create_Time": "UTC+0",
    "User_id": "optional",
    "cf1": "optional",
    "cf2": "optional",
    "cf3": "optional",
    "reference": {
      "userid": "optional",
      "email": "optional",
      "cf": { "cf1": "optional", "cf2": "optional", "cf3": "optional" }
    }
  }
}

Lista de verificación de implementación

✅ Registre la URL de Webhook (por unidad de proyecto) y confirme la recepción con respuesta 2xx
✅ Prevención de recepción duplicada: Verifique duplicados basándose en Authentication_id
✅ Procesamiento de zona horaria: Create_Time(UTC+0) → Convierta a hora estándar interna si es necesario
✅ Mapeo de claves: Mapee a usuarios/solicitudes internos con Submission_id, User_id, cf1~3
✅ Registro de auditoría: Almacene el payload original y los resultados de enrutamiento juntos

Los administradores pueden consultar de forma operativa a través del dashboard, y los equipos de desarrollo pueden automatizar sistemas vía webhook simultáneamente. Consulte de forma consistente estado, puntuación, política y línea de tiempo por unidad de Auth ID, y conecte inmediatamente al flujo del sistema interno usando Authentication_id/Submission_id del webhook.

Lista de verificación para adopción rápida

Crear proyecto

Cree el proyecto FACE AUTH en Dashboard → Add-On.

Establecer valores de política

Configure face match threshold / liveness / bloqueo por occlusion (ON/OFF).

Obtener Submission aprobado de eKYC

Se requiere un Submission de eKYC aprobado para usar como Referencia.

Diseñar la llamada

Incluya pid + Submission ID en la URL del Add-On (considere el flujo escritorio→QR→móvil)

Rutina de verificación de resultados

Monitorice el estado, política y resultados de comparación de Auth ID (submission) en el dashboard.

Consejos de operación

Comience con valores iniciales de política algo conservadores → Ajuste gradualmente los thresholds mientras revisa los datos reales del servicio
Métricas de monitoreo: Tasa de éxito de reautenticación, tasa de abandono, tiempo promedio de autenticación, tasa de bloqueo de eventos de riesgo, tasa de completación de restablecimiento/cambio
Diseño UX: Si la tasa de acceso desde escritorio es alta, guíe claramente el flujo de transición QR, y proporcione una guía de autenticación con texto mínimo para usuarios móviles

Documentación relacionada

Comenzar con FaceAuth

Consulte la descripción general completa del servicio Add-On.

API POST/Face Auth

Aprenda a integrar FACE AUTH vía API.

Webhook de FACE AUTH

Aprenda a recibir resultados de FACE AUTH vía webhook.

Guía de cifrado

Aprenda métodos de cifrado de URL.

Validación y manejo de errores de Face Auth URL

Consulte los códigos de error y los mensajes que ven los usuarios.

Complementos

FaceAuth

Casos de uso representativos

Cambio de dispositivo

Reautenticación ante detección de anomalías

Reverificación periódica de identidad

Pérdida de contraseña / Cambio de información

Método de operación (3 pasos)

Beneficios de FACE AUTH

Creación y configuración del proyecto

Paso 1: Crear proyecto Add-On

Paso 2: Configuración de información del proyecto

Paso 3: Configuración de políticas (Threshold)

Paso 4: Parámetros de URL del Add-On y configuración de cifrado

Configuración de condiciones de expiración de Token

Configuración de la URL de retorno

Provisión a usuarios

Documentación de la API POST/Face Auth

Verificación de operación (Smoke Test)

AUTH ID - Verificación de resultado de autenticación

Ver resultados en el dashboard

Información detallada de Auth ID

Integración en tiempo real vía Webhook

Lista de verificación para adopción rápida

Consejos de operación

Documentación relacionada

Comenzar con FaceAuth

API POST/Face Auth

Webhook de FACE AUTH

Guía de cifrado

Validación y manejo de errores de Face Auth URL

​Casos de uso representativos

Cambio de dispositivo

Reautenticación ante detección de anomalías

Reverificación periódica de identidad

Pérdida de contraseña / Cambio de información

​Método de operación (3 pasos)

​Beneficios de FACE AUTH

​Creación y configuración del proyecto

​Paso 1: Crear proyecto Add-On

​Paso 2: Configuración de información del proyecto

​Paso 3: Configuración de políticas (Threshold)

​Paso 4: Parámetros de URL del Add-On y configuración de cifrado

​Configuración de condiciones de expiración de Token

​Configuración de la URL de retorno

​Provisión a usuarios

Documentación de la API POST/Face Auth

​Verificación de operación (Smoke Test)

​AUTH ID - Verificación de resultado de autenticación

​Ver resultados en el dashboard

​Información detallada de Auth ID

​Integración en tiempo real vía Webhook

​Lista de verificación para adopción rápida

​Consejos de operación

​Documentación relacionada

Comenzar con FaceAuth

API POST/Face Auth

Webhook de FACE AUTH

Guía de cifrado

Validación y manejo de errores de Face Auth URL

Casos de uso representativos

Método de operación (3 pasos)

Beneficios de FACE AUTH

Creación y configuración del proyecto

Paso 1: Crear proyecto Add-On

Paso 2: Configuración de información del proyecto

Paso 3: Configuración de políticas (Threshold)

Paso 4: Parámetros de URL del Add-On y configuración de cifrado

Configuración de condiciones de expiración de Token

Configuración de la URL de retorno

Provisión a usuarios

Verificación de operación (Smoke Test)

AUTH ID - Verificación de resultado de autenticación

Ver resultados en el dashboard

Información detallada de Auth ID

Integración en tiempo real vía Webhook

Lista de verificación para adopción rápida

Consejos de operación

Documentación relacionada