FaceGuard

Surt FaceGuard te permite integrar la verificación facial para el inicio de sesión seguro en tu aplicación web o móvil. Los usuarios completan un escaneo facial rápido que se compara con su foto base registrada, todo dentro de tu aplicación.

1

Obtener credenciales

Clave API + ID de flujo desde tu panel

2

Generar token

Llamada del lado del servidor para crear un token de portal

3

Integrar FaceGuard

SDK, iframe o WebView en tu frontend

Cómo funciona

1. Tu backend solicita un token de portal a la API de Surt
2. Tu frontend abre FaceGuard (SDK, iframe o WebView) con ese token
3. Tu usuario completa el escaneo facial (se captura automáticamente cuando se detecta el rostro)
4. Surt envía el resultado mediante eventos postMessage

Métodos de integración

Método	Plataforma	Ideal para
Paquete NPM	Web (React, Vue, etc.)	Integración más rápida, detecta móvil/escritorio automáticamente
iFrame	Web	Control total sobre el tamaño y el diseño
React Native	iOS, Android vía RN	Apps móviles con React Native
iOS nativo	iOS (Swift)	Apps iOS nativas
Android nativo	Android (Kotlin)	Apps Android nativas

Comportamiento según dispositivo

FaceGuard se adapta automáticamente al dispositivo:

• Móvil / Tablet: Abre el flujo de cámara directamente para el escaneo facial
• Escritorio: Muestra un código QR para transferir al teléfono, con un botón alternativo "Verificar aquí" para cámara web

Comunicación

Todos los métodos de integración usan postMessage para la comunicación en tiempo real. Los eventos incluyen:

• surt:ready: FaceGuard está cargado y listo
• close con motivo: approved, rejected, canceled, bypass_active, no_base_photo o error

Enlaces rápidos

• Inicio rápido: en funcionamiento en 5 minutos
• Autenticación: obtén tus credenciales de API
• Paquete NPM: integración web recomendada
• Referencia de API: endpoints del backend
• Códigos de error: códigos de estado y motivos de cierre