API de autenticação facial para aplicativos web

Construir autenticação facial do zero significa lidar com verificações de vivacidade, proteção contra spoofing, comportamento do mecanismo de reconhecimento, qualidade da correspondência e captura de câmera entre navegadores antes de publicar o fluxo real do produto. É trabalho de infraestrutura com consequências de segurança e privacidade.

A FACEIO reúne essas camadas em uma API gerenciada e um SDK para navegador. Seu aplicativo recebe um Facial ID e o resultado da autenticação, enquanto seu backend continua responsável pelo mapeamento do usuário, criação da sessão, autorização e política de recuperação de conta. As equipes frequentemente combinam isso com o serviço gerenciado de autenticação facial para uma implantação mais rápida.

A API da FACEIO e a biblioteca fio.js expõem dois métodos principais que cobrem todo o ciclo de autenticação. Para controles por endpoint, consulte a referência da REST API.

• enroll()

  Inicia o fluxo de cadastro no widget da FACEIO. Após o consentimento explícito do usuário, o mecanismo de reconhecimento facial configurado cria o hash biométrico não reversível ou a entrada no índice do aplicativo, e a FACEIO retorna um Facial ID. Seu backend armazena esse Facial ID associado ao registro do usuário.

• authenticate()

  Inicia um fluxo de autenticação, verifica a vivacidade e retorna o Facial ID com qualquer payload associado após uma correspondência bem-sucedida. Seu backend pode validar o resultado e criar uma sessão, incluindo os fluxos de login sem senha descritos em Login biométrico para aplicativos web.

A integração no frontend é intencionalmente pequena. O widget do SDK gerencia permissões da câmera, interface de captura e verificações de vivacidade diretamente, para que seu aplicativo não precise implementar essas camadas.

// Etapa 1 - incorpore o SDK à sua página
<script src="https://cdn.faceio.net/fio.js"></script>

// Etapa 2 - inicialize com seu App ID público
const faceio = new faceIO('YOUR_APP_ID');

// Etapa 3 - cadastre um novo usuário
faceio.enroll({ locale: 'auto', payload: { userId: 'abc123' } });

// Etapa 4 - autentique em visitas futuras
faceio.authenticate({ locale: 'auto' })
  .then((data) => sendToBackend(data.facialId, data.payload))
  .catch((err) => handleError(err));

Após uma chamada authenticate() bem-sucedida, envie o facialId e o payload ao seu servidor para criar uma sessão confiável. Para o passo a passo completo, consulte o guia de integração, documentação de webhooks, e boas práticas de segurança.

A API da FACEIO aplica uma camada completa de segurança a cada evento de autenticação. Esses controles são ativados por padrão, sem configuração adicional. Para conhecer a postura da plataforma, consulte a Central de confiança.

• Vivacidade e proteção contra spoofing

  Cada captura é verificada para confirmar a presença humana ao vivo e foi projetada para rejeitar ataques comuns de apresentação, incluindo fotos, imagens impressas, vídeos pré-gravados, replays de tela, mídia sintética e tentativas com máscaras.

• Validação da chave privada da API

  Seu backend valida os eventos de autenticação usando sua chave privada da REST API. Mantenha essa chave no servidor para que respostas forjadas ou reproduzidas do frontend não sejam tratadas como sessões válidas.

• Facial IDs isolados por aplicativo

  Cada App ID é isolado. Facial IDs, payloads e índices do mecanismo de reconhecimento são limitados ao aplicativo, enquanto a limitação de taxa no nível da plataforma ajuda a reduzir tentativas de força bruta.

A maioria das integrações com a FACEIO usa um de dois padrões, dependendo dos requisitos de confiança e conformidade: