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.
POST /v3/face-search/: pesquisa facial 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 umapproved_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.
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 seuvendor_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.3
Carregar o rosto
Chame
POST /v3/organization/{organization_id}/application/{application_id}/vendor-users/by-id/{didit_internal_id}/faces/upload/ com uma imagem de rosto codificada em base64.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 envieretain_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", ovendor_user_ide ovendor_datado utilizador, e umbiometric_template_id. - É um dado biométrico com um
expires_atfinito. É eliminado quando o utilizador é eliminado, quando qualquer sessão desse utilizador é eliminada comdeletion_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_datanão tem um utilizador ao qual associar um template; ao eliminá-la, é reportadoineligible_no_vendor_usere 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.
Resumo do ciclo de vida facial
Carregar um rosto a partir da consola
Os operadores de conformidade podem carregar rostos manualmente:- Aceda a Users → [user] → Actions → Upload face.
- Selecione uma imagem; a Didit extrai o maior rosto e guarda um novo registo de Face associado ao utilizador.
- 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.
- 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.