Saltar para o conteúdo principal
A biometria facial é essencial para cada entidade User. A Didit captura um rosto durante a prova de vida, gera um embedding vetorial e armazena-o para quatro funcionalidades subsequentes: pesquisa facial 1:N, deteção de duplicados, aplicação da lista de bloqueio e reautenticação biométrica.
Os rostos armazenados servem também de referência para a Autenticação biométrica: crie uma sessão de autenticação biométrica com o vendor_data do utilizador e omita portrait_image, e a Didit reutiliza automaticamente o rosto armazenado (primeiro o rosto da prova de vida aprovado, depois a fotografia do chip do ePassport, depois o retrato do documento de identidade e, por último, um rosto de perfil inscrito manualmente).

Como os rostos ficam associados a um utilizador

1

Capturado durante a prova de vida

Quando um utilizador passa por uma sessão com a prova de vida ativada, a Didit captura uma selfie, executa a deteção passiva de prova de vida, extrai o rosto de maior dimensão e gera um embedding vetorial para pesquisa.
2

Armazenado no perfil do utilizador

O rosto fica associado à sessão e à entidade User principal. O URL do retrato surge no perfil do utilizador como portrait_image.
3

Indexado para pesquisa

O embedding é adicionado ao índice de pesquisa. As sessões seguintes podem executar pesquisas 1:N neste índice.

Pesquisa facial (1:N)

A pesquisa facial permite encontrar um utilizador carregando uma imagem e comparando-a com todos os rostos inscritos na sua aplicação. Casos de utilização:
  • Deteção de duplicados no onboarding: impedir que a mesma pessoa crie duas contas.
  • Pesquisa inversa: identificar o utilizador por detrás de uma imagem de CCTV ou de uma imagem numa investigação de fraude.
  • Reconhecimento de cliente recorrente: dispensar o KYC para um cliente que regressa.
A pesquisa facial é executada automaticamente durante as novas sessões quando o seu fluxo tem a deteção de duplicados ativada. Também está exposta como API autónoma:

Deteção de duplicados

Cada novo rosto pode ser comparado com os rostos inscritos existentes para identificar duplicados. A Didit atribui a cada rosto um approved_duplicate_status: Os fluxos de verificação podem ser configurados para:
  • Recusar automaticamente as sessões marcadas como duplicadas.
  • Sinalizar para revisão: encaminhar para um analista humano.
  • Apenas aviso: permitir a sessão, mas adicionar uma etiqueta de risco.
Configure isto na consola em Workflows → [o seu fluxo] → Face Match / Liveness → Duplicate detection.

Lista de bloqueio facial

Recusar uma sessão não adiciona o rosto a nenhuma lista de bloqueio. Para rejeitar futuras sessões com o mesmo rosto, bloqueie-o você mesmo: adicione-o a partir da página da lista de bloqueio ou com a API de listas. Uma nova sessão cuja selfie de prova de vida corresponda a essa entrada é recusada automaticamente.

Carregar um rosto importado para o perfil de um utilizador

Se estiver a migrar de outro fornecedor de KYC, pode criar primeiro o utilizador e depois associar a esse perfil uma imagem de rosto fidedigna. O utilizador continua identificado pelo seu vendor_data, mas o endpoint de carregamento de rostos usa o ID interno do utilizador na Didit (didit_internal_id), para que o alvo seja inequívoco.
1

Criar ou obter o utilizador

Chame POST /v3/users/create/ com o seu vendor_data estável, ou chame GET /v3/users/{vendor_data}/ se o utilizador já existir.
2

Ler o didit_internal_id

A resposta do utilizador inclui didit_internal_id. Continue a usar o vendor_data no seu próprio sistema; use o didit_internal_id apenas nos endpoints de associação ao perfil.
Os rostos de perfil importados são inscritos no mesmo índice facial usado para a deteção de duplicados e a pesquisa facial. Não são colocados automaticamente numa lista de bloqueio. Para bloquear um agente mal-intencionado conhecido, carregue o rosto para uma lista de rostos.
Carregue apenas rostos que tem autorização para tratar ao abrigo do seu próprio aviso de privacidade e do seu acordo de migração. Mantenha os identificadores do fornecedor de origem em metadata ou comment apenas quando for seguro expô-los aos seus responsáveis de conformidade.

Como o bloqueio acontece

Carregar um rosto para a lista de bloqueio

Para bloquear um utilizador por rosto de forma programática, carregue a imagem do rosto para uma lista de bloqueio do tipo facial através do endpoint dedicado Carregar rosto para a lista. A Didit extrai o embedding biométrico e insere-o no índice de correspondência: qualquer sessão futura cuja selfie de prova de vida corresponda é recusada automaticamente.
O carregamento de um rosto de perfil e o carregamento de um rosto para a lista de bloqueio são operações diferentes. Use o carregamento de perfil para associar um rosto importado de confiança a um utilizador, para fins de evidência, deteção de duplicados e pesquisa facial. Use a API de listas para bloquear um rosto, para que as sessões futuras em que haja correspondência sejam rejeitadas.

Remover um rosto da lista de bloqueio

Remova a entrada na consola em Blocklist → Faces → row actions → Remove, ou use o endpoint Eliminar entrada.

Templates biométricos conservados após a eliminação da sessão

Ao eliminar uma sessão, elimina-se a imagem do rosto e, por predefinição, o embedding facial, pelo que a pessoa deixa de ser considerada na deteção de duplicados e na Pesquisa facial. Se eliminar sessões logo após a aprovação, mas ainda precisar de detetar novos registos da mesma pessoa, ative a conservação de templates biométricos na aplicação ou envie retain_face_embeddings: true no pedido de eliminação. A Didit elimina a sessão e todos os seus dados, como habitualmente, e mantém um template biométrico facial separado, gerido à parte, sem imagem, associado ao utilizador:
  • Contém apenas o template facial numérico e os metadados de conservação. Nunca contém a imagem do rosto, o vídeo de prova de vida, os dados do documento, os campos de identidade extraídos, a decisão nem o id da sessão eliminada.
  • Participa na deteção de duplicados, na Pesquisa facial, na autenticação biométrica e nas suas listas faciais exatamente como um rosto de uma sessão ativa. Os resultados são reportados com source: "retained_template", o vendor_user_id e o vendor_data do utilizador, e um biometric_template_id.
  • É um dado biométrico com um expires_at finito. É eliminado quando o utilizador é eliminado, quando qualquer sessão desse utilizador é eliminada com deletion_instruction: "privacy_erasure", quando expira, ou quando o purga em Lists → Templates biométricos ou através da API de Templates biométricos.
  • Uma sessão criada sem vendor_data não tem um utilizador ao qual associar um template; ao eliminá-la, é reportado ineligible_no_vendor_user e o embedding é eliminado juntamente com a sessão.
  • Os templates conservados nunca são incluídos na lista de bloqueio. Uma entrada na lista de bloqueio criada a partir da sessão eliminada mantém a sua própria entrada biométrica independente e o seu próprio ciclo de vida.
Os templates associados a um utilizador aparecem no perfil do utilizador, em Templates biométricos, com uma ação de purga.

Resumo do ciclo de vida facial

Carregar um rosto a partir da consola

Os operadores de conformidade podem carregar rostos manualmente:
  1. Aceda a Users → [user] → Actions → Upload face.
  2. Selecione uma imagem; a Didit extrai o maior rosto e guarda um novo registo de Face associado ao utilizador.
  3. O rosto fica registado para as provas do perfil, a deteção de duplicados e a pesquisa facial. Use a área de Blocklist quando o objetivo for rejeitar futuras sessões que correspondam.
Isto é útil quando:
  • Tem uma fotografia conhecida de um cliente verificado por um canal offline.
  • Pretende carregar previamente uma lista de bloqueio com autores de fraude conhecidos da sua base de dados de fraude.

Privacidade e conservação

  • Os embeddings faciais são vetores numéricos, não imagens. As próprias imagens são guardadas em armazenamento de objetos cifrado, com acesso por URL assinado. Um embedding facial é um dado biométrico.
  • A conservação segue a política de conservação de dados da sua aplicação. Os templates biométricos conservados seguem o período de conservação de templates biométricos, mais restrito e finito.
  • Ao eliminar uma sessão, elimina-se a imagem e, por predefinição, o embedding. Se a sua aplicação tiver ativado a conservação de templates biométricos, a eliminação de uma sessão mantém um template sem imagem até expirar ou ser purgado.
  • Para um pedido de direito ao esquecimento ao abrigo do RGPD ou do CCPA, elimine as sessões da pessoa com deletion_instruction: "privacy_erasure" ou elimine o utilizador: em ambos os casos, todos os templates conservados são também purgados. As entradas da lista de bloqueio que gere mantêm-se até as remover.

Próximos passos

Pesquisa facial

Como funciona a pesquisa facial 1:N.

Prova de vida

A deteção de prova de vida que capta o rosto.

API de lista de bloqueio

Carregue um rosto para uma lista de bloqueio.

Templates biométricos

Templates conservados após a eliminação da sessão.

Lista de bloqueio de utilizadores

Como funciona o bloqueio de um utilizador.
Última modificação em 7 de novembro de 2026