Biometria Nitgen
Este documento descreve os processos de instalação e uso do sistema biométrico baseado na engine da Nitgen.
Versão do documento: 0.1
Documento destinado aos programadores
Programador, para a utilização direta dos links nesta pagina, adicione a seguinte linha ao seu hosts:
10.1.1.10 uniware-lda.no-ip.net
Índice
Visão Geral
O sistema biométrico ENBioBSP (baseado na engine da Nitgen) funciona de forma independente, ou seja, um módulo mão interfere no funcionamento do outro. Esta independência permite que duas ou mais aplicações que utilizem este sistema possam rodar simultaneamente no mesmo terminal, por exemplo o Unilab rodando com biometria na maquina que também é o servidor do mysql (laboratórios com apenas 1 ou 2 terminais) ou ainda dois Unilabs no mesmo terminal (vai saber o motivo).
A codificação do registro de impressões digitais (FIR - Finger Identifier Record) é executada pela própria interface do Unilab, e o registro salvo no banco. Como a licença da API é livre, não há necessidade de um servidor de conversão o que torna todo o processo mais rápido.
O módulo myENBioBSP (API da Uniware instalada no mysql) esta disponível para os sistemas Windows e Linux nas plataformas x86 e x64.
SDK NBioBSP
O SDK NBioBSP é o conjunto de softwares da Nitgen que contem a engine para a codificação dos registros de impressões digitais (FIR) e a API que permite a integração das aplicações com esta engine.
Módulo myENBioBSP
O modulo myENBioBSP consiste em uma biblioteca de ligação dinâmica ('dll' no windows e 'so' no linux) escrita para ser integrada ao banco de dados MySQL na forma de plugin, disponibilizando as funções:
FIRCOMP - Compara dois registros FIR retornando 1 para confere e 0 para não confere
NitgenStatus - Le o código de status do módulo myENBioBSP
Código Fonte
O Código fonte do sistema biométrico do Unilab esta postado no SVN e organizado conforme a finalidade e linguagem em que foi escrito. A tabela abaixo mostra a localização de cada parte do código:
| Linguagem | Modulo | Aplicação | Localização |
| Delphi 5 | Interface da Aplicação | Captura e Codificação de FIR | CVS\_d5_sharedforms\eNBioBSP_API |
| Delphi 5(x86)XE(x64) | Módulo myENBioBSP (windows) | MySQL verificação de FIR | CVS\uniware\Biometria-Nitgen-2017 |
| C++ | Módulo myENBioBSP (Linux) | MySQL verificação de FIR | CVS_OutrasLinguagens\cpp\projetos-nb\myENBioBSP |
Instalação do SDK NBioBSP No Windows
1) Baixar o pacote de instalação do SDK
| Plataforma | Link |
| x86 | http://uniware-lda.no-ip.net:3080/dist/win/x86/enbiobsp_sdk_v4.890-win-x86.7z |
| x64 | http://uniware-lda.no-ip.net:3080/dist/win/x64/enbiobsp_sdk_v4.890-win-x64.7z |
2) Instalar o SDK correspondente.
Use o serial que acompanha o pacote para registrar a API; A licença é livre.
- Nota: A plataforma do SDK deve ser a mesma do Banco de Dados e quando for o caso do driver do dispositivo.
Instalação do SDK NBioBSP No Linux
1) Abra o terminal de comando
2) Mude para usuário root
$ su
3) Crie uma nova pasta e entre nela
# mkdir nit # cd nit
4) Baixar o pacote de instalação do SDK correspondente
Nota: Não funciona em LINUX 32bits
(use o endereço do pacote desejado) # wget http://uniware-lda.no-ip.net:3080/dist/linux/debian/x86/Nitgen_SDK_eNBSP-1.8.5-1_(x86_linux-install).7z
2) Descompactar o pacote
(Dica: Apos digitar as primeiras 3 ou 4 letras
do nome do arquivo, tecle TAB para completar.)
# 7z x Nitgen_SDK_eNBSP-1.8.5-1_(x86_linux-install).7z
3) Acessar o diretório extraido do pacote
# cd eNBSP-1.8.5-1/
4) Instalar o SDK
# ./install.sh
5) Registrar a API (aplicar a licença)
(mostra na tela do terminal o serial para registro) # cat SERIAL.TXT (executa a aplicação de registro) # ./NBioBSP_Signer (o NBioBSP_Signer solicitará o número de série, informe o numero mostrado no comando anterior.)
Concluido
Instalação do Módulo myNBioBSP No Windows
- Requer SDK da Nitgen previamente instalado.
1) Baixar a o pacote do módulo myENBioBSP correspondente
Nota: O pacote deve ser compatível com a plataforma do SDK e do MySQL
| Plataforma | Link |
| x86 | http://uniware-lda.no-ip.net:3080/dist/win/x86/myENBioBSP-win-x86.7z |
| x64 | http://uniware-lda.no-ip.net:3080/dist/win/x64/myENBioBSP-win-x64.7z |
2) Descompacte o arquivo baixado.
3) Copie o arquivo myENBioBSP.dll para a pasta bin do MySQL (onde se localiza o mysqld.exe)
4) Acesse a pasta bin do MySQL e abra o prompt do DOS nesta pasta
5) Acesse o banco de dados
> mysql -uUNIWARE -p
Digite a senha padrão para o usuário UNIWARE
6) Ative as funções do módulo
mysql> CREATE FUNCTION FIRCOMP RETURNS INTEGER SONAME "myENbioBSP.dll"; <Enter> mysql> CREATE FUNCTION NitgenStatus RETURNS INTEGER SONAME "myENbioBSP.dll"; <Enter>
7) Sair do mysql
mysql> quit; <Enter>
8) Reiniciar o MySQL.
9) Testar se esta tudo Ok, execute os comandos abaixo no prompt do DOS (pasta bin do MySQL)
Digite a senha padrão para o usuário UNIWARE. mysql -uUNIWARE -e "SELECT NitgenStatus()" --port=3309 -p Deve retornar o valor 12. mysql -uUNIWARE -e "SELECT FIRCOMP(1,1)" --port=3309 -p Deve retornar o valor 52.
Concluido.
Instalação do Módulo myNBioBSP No Linux
- Requer SDK da Nitgem previamente instalado
1) Abra o terminal de comando e mude para o usuário root
$ su
2) Crie um diretório novo (temporario), e acesse este diretório
# mkdir bioinst # cd bioinst/
3) Baixe o pacote de instalação do módulo myENBioBSP para linux
| Plataforma | Link |
| x86 | não disponível |
| x64 | http://uniware-lda.no-ip.net:3080/dist/linux/debian/x64/myENBioBSP-x64-install.7z |
# wget http://uniware-lda.no-ip.net:3080/dist/linux/debian/x64/myENBioBSP-x64-install.7z
4) Descompacte o arquivo baixado
# 7z x myENBioBSP-x64-install.7z
5) Acesse a pasta myENBioBSP-x64-install, e execute o instalador
# cd myENBioBSP-x64-install # ./install.sh
6) Acesse o banco de dados
> mysql -uUNIWARE -p
Digite a senha padrão para o usuário UNIWARE
7) Ative as funções do módulo // O Unilab cria as funções quando ativa a biometria.
mysql> CREATE FUNCTION FIRCOMP RETURNS INTEGER SONAME "myENBioBSP.so"; <Enter> mysql> CREATE FUNCTION NitgenStatus RETURNS INTEGER SONAME "myENBioBSP.so"; <Enter>
mysql> quit
8) Reiniciar o Mysql
# /etc/init.d/mysql restart
9) Testar se esta tudo Ok, execute os comandos abaixo no prompt
Digite a senha padrão para o usuário UNIWARE. mysql -uUNIWARE -e "SELECT NitgenStatus()" --port=3309 -p Deve retornar o valor 12. mysql -uUNIWARE -e "SELECT FIRCOMP(1,1)" --port=3309 -p Deve retornar o valor 11.
10) Finalizando, exclua o diretório temporário
# cd ../../ # rm -rf bioinst
Concluido.
Interface Aplicação Código de exemplo
Estão disponíveis dois exemplos de aplicação que demonstram o uso da interface de captura (svn:CVS\_d5_sharedforms\eNBioBSP_API), estes exemplos estão postados em svn:CVS_Exemplos\D5\Biometria-Nitgen-2017
