Quando você inscreve uma pessoa em um sistema de autenticação biométrica, os dados faciais e de impressão digital são armazenados em um banco de dados. Quando você tenta fazer login no sistema, essas informações são verificadas e comparadas com os dados coletados anteriormente. Se houver uma partida, o acesso é permitido.
Apesar da conveniência de usar a biometria, é possível fraudar ou manipular os sensores biométricos de forma deliberada ou inadvertida. Portanto, além da comparação, é extremamente importante prestar atenção ao nível de similaridade entre as biometrias correspondentes, o que garantirá ainda mais a segurança da autenticação.
Abaixo, mostrarei passo a passo como usar o Postman e fazer a comparação entre a biometria, usando o conjunto de recursos BioPass ID para fazer solicitações à API.
1. Obtenha a chave biométrica da API via Postman
Para realizar operações na API de biometria, você precisará de uma chave de acesso que o identifique e forneça acesso às várias funcionalidades do sistema. Para obter um, consulte o artigo anterior sobre como inscrever um biometria facial do indivíduo via carteiro.
2. Extraia os modelos de imagem no Postman
Como a plataforma biométrica usa apenas os “modelos” retirados das imagens para os diferentes recursos de identificação biométrica, você precisa realizar, antes da solicitação de “correspondência facial”, a operação de extração do modelo das imagens faciais que deseja comparar.
2.1 Configure a solicitação de extração do modelo no Postman
No cabeçalho de autorização, selecione o tipo de “Chave de API”. Em seguida, preencha os campos “Chave” e “Valor”, respectivamente, com Chave de assinatura Ocp Apim e o valor da “chave de API”, que é a chave de acesso mencionada acima. Você também precisa selecionar a opção “Cabeçalho” no campo “Adicionar a”.
Como o documentação biométrica da API mostra, o URL usado para esta chamada é https://api.biopassid.com/multibiometrics/extract e o método é “POST”. Todos os campos mencionados estão marcados em vermelho, conforme mostrado na imagem abaixo:
Em seguida, preencha os parâmetros do corpo da solicitação. Em seguida, selecione a seção “Corpo”, marque o ponto “bruto” e escolha o formato JSON na lista suspensa. O JSON é um padrão de formatação de dados usado para trocar informações entre sistemas porque é leve e fácil para humanos e computadores entenderem.
A estrutura corporal tem o objeto “Extrair”, que representa o modelo extraído da imagem, dentro dele os campos: “Tipo”, que se refere ao tipo de biometria da imagem fornecida, e pode assumir os valores “FINGER” e “FACE”, “Format”, que determina o formato do modelo a ser retornado. Os formatos suportados são: BIOPASS, ISO_IEC_2005_19794_2, ISO_IEC_2011_19794_2 e ANSI_INCITS_378. E o campo “Artefato”, que recebe a imagem biométrica codificada na string base64.
Veja como a estrutura se parece no Postman:
Observe que o parâmetro “Tipo” está obtendo a biometria do tipo “FACE”, pois compararemos imagens faciais e, para Formato, escolha “BIOPASS”. Em relação ao “Artefato”, onde é necessário converter a imagem em base64, leia a etapa 5 do tutorial Registrando a biometria facial de um indivíduo via Postman. Lá você aprenderá o que é base64, por que é usado e como converter o arquivo.
Para auxiliá-lo na operação, segue abaixo o código parcialmente preenchido. Você só precisa substituir o conteúdo do “Artefato”:
2. 2 Verifique o status da operação
Depois de enviar a solicitação, você recebe imediatamente uma resposta de sucesso ou falha da operação. Em caso de sucesso, você pode ver o status “200 OK” e o corpo da resposta com o objeto “Extrair” e o campo “Modelo”, contendo o modelo extraído da imagem a ser comparada. Salve o conteúdo do modelo no bloco de notas.
Agora veja o exemplo de uma transação bem-sucedida:
Se a operação não for bem-sucedida, obtemos como status de resposta um código numérico começando com os números 4 ou 5, junto com o motivo do erro. Aqui está um exemplo:
Para ver todas as descrições e motivos das falhas, dê uma olhada no documentação biométrica da API.
2.3 Extraia a segunda imagem para comparação
Antes de declarar a extração concluída, é importante lembrar que você precisa de duas imagens para comparação. Portanto, você precisa realizar duas extrações de modelo. Como o conteúdo da primeira solicitação foi salvo, repita as mesmas etapas para extrair a segunda imagem e também salvar o conteúdo em um caderno. Feito isso, podemos prosseguir para a fase de comparação.
3. Compare imagens
Para executar a operação que compara a biometria facial de uma pessoa, mantemos a mesma configuração no cabeçalho de autorização da solicitação anterior. Só alteramos o URL da chamada para: https://api.biopassid.com/multibiometrics/match e o corpo da solicitação, onde adicionamos os modelos extraídos nas operações anteriores.
A estrutura da solicitação é composta por um objeto “Match”, que representa a correspondência entre as imagens comparadas, e dentro dele estão os campos: “Tipo”, “Formato” (ambos explicados na transação de extração do modelo), “Artifact_A” e “Artifact_B”, que recebem os conteúdos extraídos anteriormente, aqueles salvos no bloco de notas.
A resposta será uma mensagem JSON com um objeto Match que tem dois campos: “isGenuine”, um campo booleano que indica, por meio de respostas verdadeiras ou falsas, se as duas biometrias estão coincidentes. E a “Pontuação”, um campo numérico que indica o nível de similaridade das duas biometrias. Seu valor pode variar de 0 a 100.
Os casos de falha seguem um padrão semelhante ao da solicitação de extração: um código de status começando com os números 4 ou 5, seguido pelo motivo. A imagem abaixo exemplifica uma operação malsucedida, em que o motivo é um formato JSON inválido.
4. Pronto para usar o Postman?
Neste artigo, mostrei como a correspondência biométrica funciona com o recurso BioPass ID definido pela plataforma Postman para fazer as solicitações à API.
Um processo importante para evitar possíveis fraudes biométricas que garante a segurança da autenticação.
É isso por enquanto. Até o próximo artigo!
