Token Biometrico

Este artigo explica como verificar a autenticidade de um usuário que passou previamente pelo Score de Autenticação (CreateProcess), fornecendo agora uma nova foto a ser comparada com a foto do processo do score de autenticação, utilizando a REST API do Unico Check.

O Token Biométrico é uma funcionalidade do Unico Check para situações em que um usuário que passou previamente pelo Score de Autenticação (CreateProcess) deseja se autenticar, fornecendo uma nova foto

Como usar?

Faça uma requisição POST para o endpoint /biometry/token

Com o token de acesso válido, faça uma requisição para o endpoint (POST/biometry/token) enviando os seguintes parâmetros:

{
  "processId": "ID_PROCESSO_SCORE",
  "selfie": "FOTO_PESSOA"
}

Parametros:

• HEADER PARAMETERS

Nome	Tipo	Mandatorio/Opcional	Descrição
APIKEY	String	Mandatório	API key
Authorization	String	Mandatório	Token de acesso
X-Tenant	String	Mandatório	Identificador exclusivo da empresa

• REQUEST BODY SCHEMA

Nome	Tipo	Mandatorio/Opcional	Descrição
processId	String	Mandatório	Identificador do processo de score de autenticação (1:N) que será usado como base para comparação com a selfie fornecida
selfie	String	Mandatório	Foto de la persona. La imagen debe estar en base64 (png, jpg, jpeg). Si la foto se captura usando el SDK de Unico con Liveness, la imagen enviada debe ser el Json Web Token (.jwt). El .jwt debe enviarse en un plazo de 10 minutos para evitar que la imagen caduque. Y este .jwt solo se puede usar una vez.

Exemplo de requisição:

Arquivo JSON

{
  "processId": "D7A8B471-E69C-42B7-AF14-05E83365A944",
  "selfie": "iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsQAAA7EAZUrDhsAAAAgSURBVDhPY/wPBAwUACYoTTYYNWDUABAYNWDgDWBgAABrygQclUTopgAAAABJRU5ErkJggg=="
}

Requisição com Sucesso

Se a requisição foi executada com sucesso, a resposta de retorno é um JSON contendo o status da verificação como a seguir:

{
  "authenticated": true
}

O authenticated é um boolean indicando se a foto enviada na requsição é da mesma pessoa que passou pelo score de atenticação.

Erro na Requisição

Caso ocorra algum erro, a resposta de retorno é um JSON contendo o código e descrição do erro:

{
    "Error": {
        "code": "40004",
        "description": "Descrição do erro"
    }
}

Para mais infomações sobre os erros retornados, consulte a lista disponível no artigo Response Errors.

Dúvidas?

Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da Central de Ajuda.