FaceGuard

O Surt FaceGuard permite integrar a verificação facial para login seguro na sua aplicação web ou móvel. Os utilizadores completam uma verificação facial rápida que é comparada com a foto base registada, tudo dentro da sua aplicação.

1

Obter credenciais

Chave API + ID de fluxo do seu painel

2

Gerar token

Chamada do lado do servidor para criar um token de portal

3

Integrar o FaceGuard

SDK, iframe ou WebView no seu frontend

Como funciona

1. O seu backend solicita um token de portal à API da Surt
2. O seu frontend abre o FaceGuard (SDK, iframe ou WebView) com esse token
3. O seu utilizador completa a verificação facial (captura automática quando o rosto é detetado)
4. A Surt envia o resultado através de eventos postMessage

Métodos de integração

Método	Plataforma	Ideal para
Pacote NPM	Web (React, Vue, etc.)	Integração mais rápida, deteta automaticamente móvel/desktop
iFrame	Web	Controlo total sobre dimensionamento e layout
React Native	iOS, Android via RN	Apps móveis com React Native
iOS nativo	iOS (Swift)	Apps iOS nativas
Android nativo	Android (Kotlin)	Apps Android nativas

Comportamento por dispositivo

O FaceGuard adapta-se automaticamente ao dispositivo:

• Móvel / Tablet: Abre diretamente o fluxo de câmara para verificação facial
• Desktop: Mostra um código QR para transferência para o telemóvel, com alternativa "Verificar aqui" para webcam

Comunicação

Todos os métodos de integração usam postMessage para comunicação em tempo real. Os eventos incluem:

• surt:ready: FaceGuard está carregado e pronto
• close com motivo: approved, rejected, canceled, bypass_active, no_base_photo ou error

Links rápidos

• Início rápido: em funcionamento em 5 minutos
• Autenticação: obtenha as suas credenciais de API
• Pacote NPM: integração web recomendada
• Referência de API: endpoints do backend
• Códigos de erro: códigos de estado e motivos de fecho