FAQ (Perguntas Frequentes) 🤔

Para cadastrar o usuário e suas credenciais de acesso, é necessário realizar primeiramente o processo de cadastro do usuário. Durante esse processo, todas as credenciais serão atribuídas a um ID de usuário (UserID).

Por meio do cadastro, será possível gerenciar e controlar o acesso do usuário ao sistema. Dessa forma, é fundamental que todas as informações sejam precisas e atualizadas regularmente para garantir a segurança do sistema e do usuário.

Abaixo segue os passos para cadastrar um usuário e após seu cartão:

Cadastre o usuário por meio da chamada abaixo:

Dependendo do modelo do dispositivo facial utilizado, diferentes motivos de erro podem ser retornados na requisição, como falha ao extrair valor de característica facial, limite máximo de tamanho de arquivo excedido, o usuário correspondente aos dados não existe ou foto já existente. Consulte a Seção Parâmetros Retornados para mais informações.

No entanto, em alguns modelos de dispositivo, independentemente do motivo de erro, a resposta para a tentativa de cadastro da face será sempre o código 404, informando que a foto não foi aceita. Nesse caso, é importante verificar os seguintes pontos para resolver o problema:

• O usuário (UserID) ao qual a face está sendo atribuída existe
• A imagem possui apenas uma face
• A imagem não excede o tamanho máximo permitido (100kb)
• A Face já não foi cadastrada anteriormente a um outro usuário

Também é importante verificar os seguintes requisitos:

• Resolução mínima: 150 × 300 pixels (L × A)
• Resolução Máxima: 600 × 1200 pixels (L × A)
• A altura não deve exceder duas vezes a largura
• Verifique se o rosto está visível e se a testa não está coberta por cabelos.
• Enquadre todo o rosto, olhe para a câmera e esteja de olhos abertos durante o cadastro.
• Evite usar óculos e não use chapéus ou outros ornamentos para o rosto que influenciem a gravação da imagem do rosto.
• Enquadre da cabeça aos ombros e dê preferência a um fundo neutro ou branco.
• Evite sombras no seu rosto ou ao fundo.
• Faça uma expressão neutra e natural e mantenha os braços ao longo do corpo.
• Como pode conferir abaixo, o padrão para a foto é semelhante ao exigido em um documento oficial.
• Padrão 3x4.

Aqui uma ilustração que consta do manual do produto:

O cadastro de uma biometria é uma das partes mais importantes na identificação de uma pessoa. Então alguns cuidados são importantes no momento do cadastro.

• Resolução mínima: 150 × 300 pixels (L × A)
• Resolução Máxima: 600 × 1200 pixels (L × A)
• A altura não deve exceder duas vezes a largura*
• Tamanho máximo de arquivo: 100KB

Recomenda-se a utilização de imagens com resolução superior a 500 × 500 pixels (L × A) onde o rosto não deve ocupar mais de 2/3 da área total da imagem Para a aparência/conteúdo das fotos:

• Verifique se o rosto está visível e se a testa não está coberta por cabelos.
• Enquadre todo o rosto, olhe para a câmera e esteja de olhos abertos durante o cadastro.
• Evite usar óculos e não use chapéus ou outros ornamentos para o rosto que influenciem a gravação da imagem do rosto.
• Enquadre da cabeça aos ombros e dê preferência a um fundo neutro ou branco.
• Evite sombras no seu rosto ou ao fundo.
• Faça uma expressão neutra e natural e mantenha os braços ao longo do corpo.
• Como pode conferir abaixo, o padrão para a foto é semelhante ao exigido em um documento oficial.
• Padrão 3x4.

Aqui uma ilustração que consta do manual do produto:

Tanto o eventManager quanto o snapManager são chamadas que devem ser executadas em formato de fluxo, permitindo que o processo de recebimento continue por um tempo indefinido.

Caso esteja executando via Postman não é possível definir este tipo de tempo indeterminado para que seja possível receber os dados. Para isso, é necessário utilizar de integração direta em código. Segue abaixo um exemplo um Python para a chamada do eventManager:

import requests
 
url = "http://192.168.3.87/cgi-bin/eventManager.cgi?action=attach&codes=[All]"
digest_auth = requests.auth.HTTPDigestAuth('admin', 'acesso1234')
 
response = requests.get(url, auth=digest_auth, stream=True, timeout=60, verify=False)
 
empty_lines = 0
event = {}
 
for chunk in response.iter_lines():
        print(chunk)
 
        if chunk == ''.encode():
            empty_lines += 1
            if empty_lines == 2:
                empty_lines = 0
                print(event)

Consulte a página eventManager e snapManager para mais informações e exemplos.

O erro HTTP 401 é um código de status que indica que a solicitação enviada para um servidor web não foi autorizada. Em outras palavras, o servidor recebeu a solicitação, mas não reconheceu as credenciais de autenticação fornecidas ou o usuário não tem permissão para acessar o recurso solicitado.

Existem várias razões pelas quais um servidor web pode retornar um erro 401, incluindo:

• Credenciais inválidas: as credenciais de autenticação fornecidas pelo usuário são incorretas ou expiraram.

• Ausência de credenciais: o usuário não forneceu as credenciais de autenticação necessárias para acessar o recurso solicitado.

Outro ponto importante a se verificar, A autenticação Digest é um esquema de autenticação baseado em desafio-resposta que permite que um cliente se autentique com um servidor web protegido por senha.

Quando um cliente faz uma solicitação HTTP para um recurso protegido por autenticação Digest, o servidor web responde com um código de status HTTP 401, indicando que o acesso não é permitido sem autenticação. Junto com o código de status 401, o servidor também envia um cabeçalho "WWW-Authenticate" contendo informações sobre a proteção utilizada para a senha, bem como um desafio aleatório.

O cliente responde ao desafio enviando um cabeçalho "Authorization" contendo as credenciais de autenticação criptografadas, juntamente com informações sobre o desafio e outras informações necessárias. O servidor web verifica se as credenciais estão corretas e, se estiverem, retorna um código de status HTTP 200, indicando que o acesso ao recurso foi permitido.

O motivo pelo qual o servidor web envia um código de status HTTP 401 antes de enviar o código de status HTTP 200 é que o cliente precisa ser informado de que a autenticação é necessária antes de enviar as credenciais de autenticação criptografadas. O código de status HTTP 401 é usado para indicar que o acesso ao recurso é negado sem autenticação.

Em resumo, a sequência de códigos de status HTTP 401 seguido por um código de status HTTP 200 é um comportamento padrão na autenticação Digest para permitir que o cliente se autentique com o servidor web protegido por senha.

Antes de mais nada, para identificar se a versão de firmware é a mais recente é necessário verificar qual o modelo do seu dispositivo. Caso não saiba consulte a etique branca disponivel atrás do produto e verifique seu modelo.

Com o modelo do dispositivo, é possível realizar o acesso em nosso site Intelbras e realizar a busca pelo dispositivo, utilizaremos como exemplo o modelo SS 5530: