Human Token

Markdown

Com apenas uma foto do rosto, você transforma o seu usuário em um humano único. Simples, intuitivo e seguro.

Um humano. Um token. Sempre. O Human Token cria uma identidade única para cada rosto a partir de uma única selfie, sem exigir documento emitido por governo. Isto é útil tanto onde esse vínculo não existe quanto onde seus clientes preferem não compartilhar números de documento. Sempre que precisar, peça uma nova verificação e compare os tokens: tokens iguais significam o mesmo humano.

Isso permite:

• Detectar usuários recorrentes e evitar contas duplicadas: um rosto, um token. Identifique contas duplicadas ou falsas no cadastro, no login e na recuperação, sem documentos oficiais.
• Integrar via Web, Nativo ou API: usando apenas a imagem da selfie como entrada, sem necessidade de dados adicionais de documentos.
• Combinar com outros sinais: adicionar o Human Token junto a outras capabilities conforme necessário.

Entre os cenários mais comuns estão ataques de deepfake (confirmar que há uma pessoa real e presente por trás de cada ação, sem CAPTCHA e sem SMS), múltiplas contas, abuso de promoções e indicações, recuperação de senha, autenticação de novo dispositivo e redução de inadimplência. Verifique o risco antes da decisão e não depois da perda.

O que faz

A partir da selfie capturada, o Human Token gera um identificador biométrico estável e opaco (humanToken) que representa de forma exclusiva aquele rosto. O usuário não declara nenhum identificador: a identidade é o resultado da chamada, não a entrada. Em cada correspondência bem-sucedida, a resposta retorna o mesmo humanToken, permitindo que o mesmo usuário seja reconhecido em processos futuros, em qualquer dispositivo ou sessão.

Privacy by Design: Nenhum dado prévio é necessário e a foto do rosto pode ser descartada após o processamento: o que fica no seu sistema é o token, não o rosto — reduzindo materialmente a exposição biométrica da sua empresa e dos seus clientes.

Entradas

A única entrada é a selfie. Com os fluxos API Only, seu back-end a envia como imageBase64 no corpo de Criar Processo. Com o fluxo da Human Token Journey (humantoken), a selfie é capturada na jornada.

SDK necessário para captura de qualidade

Para garantir que a imagem enviada via API atenda aos requisitos biométricos, utilize o SDK da Unico para sua plataforma ou siga o Padrão de Captura. O Human Token não aceita imagens arbitrárias sem controle de qualidade de captura.

Respostas possíveis

O resultado vem em data.humanToken: value é o identificador, e state indica em que ponto o processo está — PROCESS_STATE_FINISHED quando o resultado está pronto. Veja Criar Processo › Interpretando o resultado.

Quando nenhum humanToken pode ser gerado

Há um único cenário em que o Human Token não produz um humanToken: o rosto não pode ser identificado na imagem enviada — nenhum rosto é detectado, a qualidade da imagem é baixa demais, ou o rosto está fora do padrão de captura (inclinado, virado de lado). Seguir o Padrão de Captura é o que evita isso.

humanToken é um identificador estável e opaco — o mesmo usuário sempre resolve para o mesmo valor. Armazene-o junto ao registro do usuário para reconhecer a mesma pessoa em chamadas futuras do Human Token.

Integração via API

O Human Token é executado na Human API. Seu back-end cria o processo com Criar Processo: com um fluxo API Only (api+humantoken, api+liveness+humantoken ou api+liveness+humantoken+revalidation), o humanToken retorna na mesma resposta; com o fluxo da Human Token Journey (humantoken ou humantoken+revalidation), o usuário percorre a jornada e seu back-end consulta o resultado com Obter Processo.

Para começar:

1. Configure a Autenticação — toda chamada envia a sua access key no header x-unico-accesskey.
2. Crie o processo com Criar Processo e leia data.humanToken.
3. Consulte o processo novamente, quando precisar, com Obter Processo.

Disponibilidade

Componentes de integração necessários
API Web