Guia de referência do Facial ID

A FACEIO disponibiliza o Facial ID pela Promise resolvida retornada pelos métodos de fio.js no cliente. O objeto completo contém outros campos, mas o valor importante para associar a conta é facialId.

Se você enviar um payload durante o enroll(), a FACEIO poderá retornar esse payload em autenticações futuras. Limite o payload aos valores necessários para o aplicativo e não use dados de payload do lado do cliente como única verificação de autorização.

1. 1. Crie um aplicativo FACEIO. Use o guia de primeiros passos e o FACEIO Console ↗ para configurar seu aplicativo, as opções do widget e as configurações de segurança.
2. 2. Cadastre o usuário. Siga o Guia de integração, depois chame enroll() após o usuário escolher ativar a autenticação facial e conceder as permissões necessárias do navegador.
3. 3. Armazene o facialId. Salve-o no backend se precisar associar a autenticação da FACEIO ao modelo de conta local.
4. 4. Autentique usuários recorrentes. Chame authenticate() e compare o facialId com a conta ou sessão esperada pelo seu aplicativo.
5. 5. Mantenha o backend sincronizado. Use webhooks quando eventos de cadastro, autenticação ou exclusão do Facial ID precisarem atualizar o estado da conta, logs de auditoria ou controles de risco.
6. 6. Exclua quando necessário. Use /deletefacialid quando um usuário revogar o consentimento, excluir a conta, desativar o login biométrico ou solicitar a remoção.

O mecanismo de reconhecimento facial selecionado transforma o rosto de um usuário cadastrado em um vetor matemático de características usado em correspondências futuras. A FACEIO retorna o Facial ID para que seu aplicativo referencie o registro cadastrado dentro do próprio fluxo de contas.

A própria FACEIO, incluindo fio.js, o widget incorporado, a REST API e o Console, não armazena, trata nem tem acesso a hashes biométricos. O mecanismo de reconhecimento facial escolhido pelo proprietário do aplicativo gerencia esses hashes conforme o mecanismo, a região, o fluxo de consentimento e a política de exclusão configurados.

Use o FACEIO Console ↗ para criar um aplicativo de teste e validar quais mecanismos e configurações de segurança atendem à sua experiência do usuário, fluxo de contas e requisitos de implantação.

Um vetor facial, também chamado de hash biométrico, é um array de valores de ponto flutuante produzido pelo mecanismo de reconhecimento selecionado durante o cadastro. A FACEIO não expõe esse hash biométrico ao seu aplicativo por meio do fio.js; seu aplicativo recebe o Facial ID e os campos relacionados da resposta.

Não trate um Facial ID como um identificador de perfil público nem o exponha em logs do navegador, eventos de análise, fóruns públicos de suporte ou URLs. Se precisar armazená-lo localmente, mantenha-o no servidor com o mesmo cuidado aplicado aos dados de conta relacionados à autenticação.

Para planejar a privacidade, combine esta referência com as Boas práticas de privacidade, Boas práticas de segurança, e Central de confiança.

• Armazene-o com os dados da conta. Salve o facialId no backend quando precisar associar a FACEIO a um registro de usuário local.
• Faça verificações no servidor. Use o Facial ID retornado como entrada para sua lógica de autorização, não como uma concessão de sessão independente.
• Mantenha os payloads mínimos. Se você anexar um payload durante o cadastro, inclua apenas os dados que seu fluxo de autenticação realmente precisa.
• Sincronize com webhooks. Use eventos de webhook quando alterações no estado do cadastro ou da exclusão precisarem chegar ao seu backend.
• Ofereça controles ao usuário. Ofereça aos usuários cadastrados um caminho para desativar o login biométrico ou solicitar a exclusão do Facial ID.
• Documente a retenção. Defina quando os Facial IDs são mantidos, excluídos ou desvinculados no seu produto e nos avisos de privacidade.

A exclusão do Facial ID é realizada pela REST API da FACEIO usando o /deletefacialid rota da API. Informe o Facial ID que deseja remover do aplicativo-alvo usando o formato de solicitação da REST API documentado na referência da REST API.

Após a exclusão bem-sucedida, o Facial ID cadastrado não poderá mais ser usado para autenticar o usuário. Se o mesmo usuário escolher se cadastrar novamente, a FACEIO criará um novo registro de cadastro e retornará um novo Facial ID.