Biometria Facesign
DocHub
  • Home
  • Guia Rápido de Integração
  • Produtos
    • APP
    • SSO
    • MFA
  • CRM
  • DOCs
  • Recursos
    • Padrão de captura
    • Score biometrico
    • Score de autenticação
    • Prova de vida
    • Documentoscopia
    • Liveness 2D
    • Funcionalidade 1:N
      • Cadastro
      • Match
    • Webhook
      • JSON Web Token (JWT)
    • Redirect
    • Callback
    • Token criptografado
  • Releases
    • Releases
Fornecido por GitBook
Nesta página
  • Container
  • Liveness
  • Token
  1. Recursos

Funcionalidade 1:N

A funcionalidade 1:N (ou “Um para Muitos”) é um componente essencial em sistemas de reconhecimento facial voltados à identificação de indivíduos. Diferente da abordagem 1:1, onde a imagem facial de uma pessoa é comparada diretamente com outra imagem de referência (por exemplo, validação de identidade via selfie frente a um documento), o 1:N realiza a comparação de uma imagem facial contra uma base de dados contendo múltiplos perfis faciais registrados.

Essa funcionalidade permite identificar uma pessoa sem que ela informe previamente sua identidade, com base apenas na imagem do seu rosto. O sistema então procura, dentro do banco de dados, o registro mais semelhante ou compatível com aquela imagem.

Container

O Container de faces é um conjunto organizado de representações faciais (embeddings) armazenadas no banco de dados, utilizadas como base para fazer a identificação de pessoas. O Container de faces é cadastrado por cliente, ou seja, o cliente poderá realizar o Cadastro de faces no Container e, posteriormente, o Match 1:N com a base de todas as faces cadastradas em seu perfil.

Liveness

Na implementação do Cadastro e Match 1:N, o cliente poderá optar por ativar ou desativar o Liveness como parâmetro para realizar cadastros ou autenticações de faces.

  • Parâmetro Liveness ativado: Caso a face enviada não passe pelo Liveness, a API Facesign retorna com Code 400 - Erro, não permitindo a finalização do processo com retorno negativo do Liveness;

  • Parâmetro Liveness desativado: Cadastros e Matchs podem ser realizados sem a validação positiva do Liveness, a face passará pelo processo de Cadastrou ou Match independente do retorno positivo ou negativo do Liveness. Mesmo com o Parâmetro Liveness desativado, a API Facesign devolverá no Payload o resultado do Liveness da face enviada.

O Parâmetro Liveness ativado garante uma maior segurança e autenticidade tanto no Cadastro, quanto no Match 1:N.

Token

Para gerar um token de autenticação, envie um JSON com o ID e senha fornecidos pela Facesign para o endpoint: /api/v1/auth/empresa/autenticar.

Exemplo de JSON:

{
  "empresaId": "9EEC5EFD-XXXX-XXXX-8A10-1F689615D3BE",
  "password": "S6YW59TejZ9aJ0gXXXXXXXXXXXXXtnpOUCObZCL5r"
}

Ao enviar, retornará no payload o token de acesso e o tempo para expirar, desta forma:

{
 "AccessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI5ZWVjNWVmZC0wYWY1LTQwZTItOGExMC0xZjY4OT...",
    "ExpiresIn": 86400,
    "UserToken": {
        "UsuarioId": "9eec5efd-XXXX-XXXX-XXXX-1f689615d3be",
        "EmpresaId": "9eec5efd-XXXX-XXXX-XXXX-1f689615d3be",
        "Nome": "Face1N_Dev",
        "Role": 1
    }
}

O token de acesso será inserido no “header” como “Authorization” : “Bearer Token”

Exemplo:

“Authorization” : “Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9 .eyJzdWIiOiI5ZWVjNWVmZC0wYWY1LTQwZTItOGExMC0xZjY4OT...”

Para teste via Postman, basta apenas acessar a aba “Authorization” na Collection, selecionar a opção “Bearer Token” no tipo de autenticação (Auth Type) e colocar o token gerado.

AnteriorLiveness 2DPróximoCadastro

Atualizado há 22 dias