Quando a tela de biometria do Quírons não funciona, três testes feitos na própria estação costumam apontar exatamente onde está o problema. Levam menos de dois minutos e não exigem conhecimento técnico.
Este artigo vale apenas para leitores Nitgen. Os endereços de teste, os nomes de programa e as mensagens esperadas descrevem a integração com o leitor Nitgen Hamster DX + Biometric Service API (FingerTech). Leitores de outras marcas usam programas próprios: nada aqui se aplica a eles, e os testes abaixo vão falhar mesmo com o equipamento em perfeito estado. Na dúvida, confira a marca impressa no corpo do leitor antes de começar.
Como funciona, em uma frase
O leitor de digital não conversa diretamente com o Quírons. Quem faz essa ponte é a Biometric Service API, instalada no computador, que precisa estar em execução para qualquer tela de biometria funcionar — mesmo que o leitor esteja aceso e piscando normalmente.
O serviço é local: atende só o computador em que está instalado e só reconhece leitores Nitgen conectados a ele. Se a biometria funciona na máquina do colega, isso não diz nada sobre a sua.
Teste 1 — O programa está em execução?
Pressione Ctrl + Shift + Esc para abrir o Gerenciador de Tarefas, vá na aba Processos e procure por BiometricService na lista.
Aparece na lista: o serviço está rodando. Siga para o Teste 2.
Não aparece: essa é a causa mais comum de todas. Abra o atalho do Fingertech-API, ou o arquivo direto na pasta de instalação:
C:\Arquivos de Programas\Fingertech\Fingertech-API\Fingertech-API.exe
Depois de abrir, confira de novo se BiometricService apareceu na lista de processos.
Teste 2 — O serviço está respondendo?
Abra uma aba nova no navegador, digite o endereço abaixo inteiro e pressione Enter:
http://localhost:5000/apiservice/total-in-memory
Resposta esperada: uma página em branco com esta única linha de texto —
{"total":0,"success":true}. É feio, mas é o certo. Siga para o Teste 3."Não foi possível acessar esse site" ou ERR_CONNECTION_REFUSED: o serviço não está em execução. Volte ao Teste 1. Se o BiometricService estava na lista de processos e mesmo assim deu esse erro, registre e abra um chamado.
Abriu uma busca do Google: você digitou sem o
http://e o navegador entendeu como pesquisa. Repita com o endereço completo.Erro de certificado ou de conexão segura: o endereço é http, não https. Com
https://localhost:5000nunca vai funcionar — apague o "s" e tente de novo.
Teste 3 — O leitor Nitgen está sendo reconhecido?
Com o leitor conectado, abra este outro endereço na mesma aba:
http://localhost:5000/apiservice/device-unique-id
Aparece um código: o identificador do equipamento na tela significa que o leitor foi reconhecido. Se, mesmo assim, a tela do Quírons continuar falhando, o problema é de configuração — abra um chamado.
Página em branco ou "HTTP ERROR 500": o serviço está no ar, mas não encontrou um leitor Nitgen. Confira o cabo, ligue o leitor direto em uma porta USB do computador (sem hub, sem extensão, sem monitor com USB), veja se a luz acende e repita o teste. Se o equipamento conectado for de outra marca, é esse o motivo do erro.
Sintomas comuns
Funcionava ontem e hoje não / parou depois de reiniciar: o serviço não subiu junto com o Windows. Faça o Teste 1. Se isso se repetir todo dia, abra um chamado para configurar a inicialização automática.
Fechei uma janela preta e a biometria parou: aquela janela era o próprio serviço. Abra novamente e deixe minimizada, não fechada.
O leitor acende, mas nada acontece na tela: a luz indica apenas energia da USB, não que o serviço esteja rodando. Faça o Teste 1.
Testes 2 e 3 passam, mas o Quírons dá erro: é a liberação de acesso (CORS) entre o Quírons e o serviço. Não se resolve na estação — abra um chamado com os prints dos dois testes.
Falha só em um navegador: extensão, bloqueador ou política do navegador. Teste em outro navegador e informe qual funciona e qual não.
Trocaram o leitor e parou de funcionar: o novo equipamento pode não ser Nitgen. Confira a marca no corpo do leitor e informe o modelo antigo e o novo.
O BiometricService some da lista sozinho: antivírus ou política de segurança encerrando o programa. Informe o nome do antivírus usado na estação.
Perguntas frequentes
Posso ligar um leitor de digital de outra marca?
Não. A integração é específica para leitores Nitgen — é a única marca que a Biometric Service API reconhece. Um leitor de outro fabricante pode até acender e ser visto pelo Windows, mas o Teste 3 vai falhar e nenhuma captura vai acontecer.
Preciso de internet para a biometria funcionar?
A conversa entre o Quírons e o leitor acontece dentro do próprio computador e não depende de internet. O restante do sistema, sim — mas se a internet cair, a mensagem de erro costuma ser outra.
Posso usar pela rede o leitor que está em outro computador?
Não. O serviço aceita conexões apenas da própria máquina, por segurança. Cada estação que for usar biometria precisa do programa instalado e de um leitor conectado a ela.
Preciso deixar o programa aberto o tempo todo?
Sim, enquanto for usar biometria. Ele pode ficar minimizado. Se você usa biometria todos os dias, vale abrir um chamado para deixá-lo configurado para iniciar junto com o Windows.
Posso mudar a porta 5000 ou editar o arquivo de configuração?
Não altere por conta própria. Se houver conflito com outro programa na porta 5000, quem ajusta é o suporte — uma alteração manual costuma deixar o serviço inacessível sem aviso.
Posso reinstalar o programa para tentar resolver?
Não é necessário na maioria dos casos, e a reinstalação apaga os ajustes feitos na instalação, inclusive a liberação de acesso do Quírons. Faça os três testes primeiro e envie o resultado.
O que enviar ao abrir um chamado
Nome ou patrimônio da máquina em que o erro acontece
Print do Teste 2 e do Teste 3, com a barra de endereço do navegador visível
Print da mensagem de erro que aparece na tela do Quírons
Navegador usado e, se possível, a versão
Data e hora da última tentativa que falhou
Se a luz do leitor estava acesa no momento da falha
Marca e modelo do leitor conectado, como está impresso no equipamento
Conteúdos relacionados: