Guia de implementação para desenvolvedores
Use este checklist antes de levar a autenticação facial para produção
Este guia é destinado a equipes de engenharia e produto que precisam de um plano prático para implementar autenticação biométrica em uma aplicação web. Para a visão comercial, os modelos de implantação e o posicionamento do produto, consulte a página de autenticação biométrica para aplicações web.
1. Defina a função da autenticação
Antes de escrever código, defina onde a autenticação facial entra na jornada do usuário. Essa decisão evita ambiguidades no produto e simplifica a arquitetura técnica de autenticação.
Login principal
Use o FACEIO como método principal de autenticação sem senha após o cadastro facial do usuário.
Segundo fator
Mantenha o login atual e adicione autenticação facial para reforçar a proteção da conta.
Verificação adicional
Solicite uma leitura facial antes de ações sensíveis, como pagamentos, alterações administrativas ou acesso a dados protegidos.
2. Prepare o fluxo de autenticação web
Um fluxo biométrico de produção exige mais do que solicitar acesso à câmera. Trate o widget no navegador, o backend e a camada de sessão como limites de confiança independentes.
- Crie uma aplicação FACEIO no FACEIO Console e armazene o App ID público separadamente da chave privada da REST API.
- Carregue o SDK fio.js somente nas páginas que exigem cadastro, autenticação ou verificação adicional.
- Chame
enroll()apenas depois que o usuário aceitar o aviso de consentimento biométrico. - Chame
authenticate()para login, segundo fator ou uma verificação adicional definida pela sua política. - Valide o evento de autenticação no servidor antes de criar ou elevar uma sessão. Consulte a REST API e a documentação de webhooks para implementar o backend.
3. Trate a detecção de vivacidade, o anti-spoofing e a recuperação
A autenticação facial deve avaliar uma nova captura e os indicadores de vivacidade sem criar impasses para o suporte. A FACEIO fornece resultados de autenticação e anti-spoofing, enquanto sua aplicação define tentativas, acesso alternativo e decisões de risco.
Lógica de novas tentativas
Explique com clareza erros de câmera, iluminação e permissão. Evite repetir capturas com falha sem oferecer uma forma de recuperação.
Acesso alternativo
Defina como o usuário recuperará o acesso se a câmera não estiver disponível, o cadastro biométrico precisar ser redefinido ou uma revisão manual for necessária.
Tratamento por risco
Em fintechs, marketplaces e fluxos que exigem verificações adicionais, combine a autenticação biométrica com seus próprios controles de risco. Consulte o guia de fintech e eKYC, o ID Match e as boas práticas de segurança para padrões de correspondência facial e autenticação.
4. Confirme as regras de privacidade, consentimento e retenção
A autenticação biométrica exige um nível de confiança maior do que uma senha. As equipes de produto, jurídico e engenharia devem alinhar os avisos de consentimento, os procedimentos de exclusão e o suporte antes da implantação.
- Mostre um aviso claro de consentimento biométrico antes do cadastro.
- Explique para que a autenticação facial será usada e como o usuário pode recusá-la quando aplicável.
- Documente a exclusão da conta, do Facial ID e do hash biométrico por meio do endpoint DELETEFACIALID da REST API.
- Revise a implementação com a Central de Confiança da FACEIO, a Política de Privacidade, as boas práticas de privacidade e as boas práticas de segurança.
5. Implante em etapas
Uma implantação gradual gera métricas mais claras e reduz ocorrências inesperadas no suporte. Comece com um grupo limitado e expanda quando o cadastro, a taxa de autenticação, as novas tentativas e os chamados estiverem estáveis.
Projeto piloto
Ative primeiro a autenticação biométrica para funcionários, usuários beta ou um segmento de baixo risco.
Produção
Expanda a implantação quando o monitoramento, os procedimentos de suporte e a validação no backend estiverem confirmados.
6. Verificação no backend e vinculação da sessão
Um erro comum é confiar no resultado recebido pelo cliente. O navegador não é um limite confiável: os valores podem ser alterados ou reproduzidos. O backend deve verificar cada evento de autenticação antes de emitir uma sessão.
- Verifique o resultado da autenticação no servidor com a chave privada da REST API e o Facial ID retornado.
- Vincule a sessão ao Facial ID verificado, não a um identificador fornecido pelo cliente.
- Rejeite resultados cuja validação do PIN Code, horário, origem da solicitação ou associação do usuário não corresponda aos seus registros.
- Registre o evento para auditoria sem incluir capturas, mídia de verificação ou hashes biométricos nos logs da aplicação.
As boas práticas de segurança, a página da API de autenticação facial e o checklist da API explicam esses padrões em detalhes.
Recursos para implementar autenticação biométrica
Use esta documentação do FACEIO para manter alinhados a configuração, a integração frontend, a validação no backend e os ajustes no console.
Perguntas frequentes
Qual é a diferença entre este checklist e a página comercial de autenticação biométrica?
Este é um checklist técnico de implementação. A página principal de autenticação biométrica apresenta o produto, os modelos de implantação e seu uso empresarial.
Posso usar autenticação facial como segundo fator sem substituir as senhas?
Sim. O FACEIO pode ser o login principal, um segundo fator ou uma verificação adicional. Para fluxos de maior risco, consulte o guia de prevenção de fraudes no comércio eletrônico.
O que acontece se a câmera do usuário não estiver disponível?
Ofereça uma opção alternativa, como senha, OTP, recuperação da conta ou suporte, para que um problema de câmera, dispositivo ou acessibilidade não bloqueie o usuário.
Preciso validar o resultado da autenticação no backend?
Sim. Não conceda uma sessão com base no resultado do cliente. O backend deve validá-lo com a chave privada da REST API, conforme descrito nas boas práticas de segurança.
Guias relacionados
Implemente autenticação biométrica sobre uma base sólida
Use este checklist com a documentação de integração e associe cada evento de autenticação a uma decisão de sessão no servidor. Para conhecer o produto e suas opções de implantação, consulte a página de autenticação biométrica. Crie uma aplicação FACEIO no console, copie o App ID público e comece a integrar o fio.js.