Introdução ao Veridis Biometrics SDK VERIDIS

Transcrição

1 Introdução ao Veridis Biometrics SDK Versão do SDK: Veridis Biometrics VERIDIS BIOMETRICS

2 Versão do Documento Versão Data Modificações /mar/ /mai/ /jul/2011 3/out/ /fev/2013 Versão original Expansão da Introdução. Novos leitores suportados Hamster III e Hamster DX SDK 3.0. Biblioteca de alto nível. SDK 3.2. Biometric SDK FREE. NET HighLevelBiometricServices SDK 5.0. API totalmente reformulada Suporte a vários formatos de imagens Carregamento dinâmico dos leitores Licenciamento FREE 02

3 Sumário Introdução Características Funcionalidades Sistemas Operacionais Leitores Suportados Instalação e licenciamento Estrutura do SDK Licenciamento Instalação do Leitor Distribuição Demo Funcionalidades Desenvolvimento Desenvolvimento em.net Pré-requisitos Instalação Documentação Sample Desenvolvimento em Java Instalação Documentação Sample Distribuição Desenvolvimento utilizando DLL Documentação Sample Configurações Distribuição 03

4 Introdução O Veridis Biometric SDK é um kit de desenvolvimento de software contendo algoritmos biométricos e uma interface de fácil compreensão e programação. Realiza a captura dos dados biométricos, extração dos templates (representação matemática única de cada amostra) e a comparação. O Veridis Biometric SDK é o primeiro SDK de qualidade do mercado a suportar leitores de diferentes fabricantes e não possuir licenciamento pago, ou seja, o seu uso é FREE. Tudo o que é preciso fazer para incorporar essa tecnologia no seu produto de software está disponível da forma mais amigável possível nas interfaces do tipo DLL, SO, JAVA e.net. A figura a seguir mostra o fluxo dos dois principais processos da biometria: o cadastro do template do usuário e a comparação entre templates. 04

5 Características Funcionalidades Captura de amostras biométricas. Modos de captura síncrona e assíncrona. Extração de templates. Suporte aos padrões internacionais de template ISO e ANSI Suporte ao padrão ISO Representação do template em Base64. Junção de templates (merge) em um único template de alta qualidade. Comparação biométrica no modo Verificação (um-para-um). Comparação biométrica no modo Identificação (um-para-muitos). Multi-plataforma. Windows (32 e 64 bits) e Linux (32 e 64 bits). Bibliotecas de baixo nível (DLL e SO) para desenvolvimento em qualquer linguagem de programação. Componentes Java e.net. Documentação completa de todos os componentes, inclusive integrado ao IntelliSense. Sistemas Operacionais Windows XP SP2 (x86 e x64) Windows Vista (x86 e x64) Windows 7 (x86 e x64) Windows Server 2003 (x86 e x64) Windows Server 2008 (x86 e x64) Ubuntu (x86 e x64) Fedora (x86 e x64) Suse (x86 e x64) Leitores Suportados Futronic FS-80, FS-88 e FS-90 Techmag BioTouch Nitgen Hamster I,III,DX Suprema Biomini, Biomini Plus Microsoft Fingerprint Reader* DigitalPersona U.are.U 4000B* *Utilizam o driver LibUSB. 06

6 Instalação de Licenciamento Estrutura do SDK Pasta \demo \samples\dotnet\c# \samples\cpp \samples\java \bin\86 \bin\x64 \inc \lib\x86 \lib\x64 \doc Descrição Pasta com a aplicação demo e suas dependências externas Sample em C#.NET com código fonte Samples em C++ com código fonte Sample em Java com código fonte DLLs para Windows (32 bits) DLLs para Windows ( 64 bits) Includes para desenvolvimento com a biblioteca nativa Biblioteca estática para Windows (32 bits) Biblioteca estática para Windows (64 bits) Documentação do SDK Licenciamento O Veridis Biometric SDK não possui qualquer licenciamento pago ou amarrado à máquina. O seu uso é ilimitado, podendo ser utilizado em qualquer aplicação por um número ilimitado de usuários. Ao criar uma conta em nosso site, o usuário receberá uma chave (key). Essa chave deverá ser passada na função VInstallLicense. Instalação do Leitor Os leitores Microsoft Fingerprint Reader e Digital Persona U.are.U 4000B utilizam a libusb. O driver pode ser baixado em nosso site. Ao conectar o leitor, escolha a instalação manual do driver e aponte para o driver\windows\veridis_biometric_driver.inf. Para os outros leitores suportados, utilize o driver fornecido pelo fabricante. Distribuição Para distribuir o Veridis Fingerprint SDK junto com sua aplicação: Acrescente ao seu pacote de distribuição os arquivos presentes na pasta bin/x86 ou bin/x64. Em cada máquina onde será feito a implantação, garanta: Que o leitor de impressões digitais foi instalado corretamente. 07

7 Demo A aplicação Demo foi desenvolvida para demonstrar os principais objetivos da biometria: cadastro e identificação. Essa aplicação faz uso do Veridis Biometric SDK 5.0. A Figura 1 representa a tela principal do programa. Nessa tela são listados os cadastros já efetuados e as opções de Registrar, Remover e fazer a Identificação através da impressão digital. Funcionalidades Figura 1 - Tela Principal Cadastro: clique no botão Registrar para visualizar a interface de cadastro. Alteração: com um duplo clique em um dos nomes listados na tela principal, a interface para edição de cadastro será aberta. Remoção: para deletar um cadastro existente, selecione o nome na lista e clique em Remover. Identificação: para realizar uma identificação (busca 1:N), clique em Identificação, aguarde a interface de captura aparecer e posicione o dedo no leitor biométrico. Caso a pessoa seja encontrada, a ficha com o cadastro completo dessa pessoa será aberta. Filtrar: para filtrar a lista por nome, digite o nome ou parte dele no campo Nome. 08

8 Figura 2 - Tela de Cadastro A Figura 2 representa a interface de cadastro. Essa tela é responsável por capturar as informações de uma pessoa. Campos biográficos: o documento é obrigatório e deve ser único no banco. Cadastro biometrico: selecione um dos retângulos acima dos dedos para cadastrar o respectivo dedo. Uma nova janela será aberta aguardando o posicionamento do dedo no leitor biométrico. Cada dedo deverá ser capturado três vezes. Foto: clique no botão com a câmera para começar a capturar imagens da webcam, um novo botão irá surgir ao lado, clique nele para capturar a imagem final ou cancele clicando novamente no botão da câmera. Verificação: em caso de alteração de cadastro, uma verificação deve ser feita para confirmar as alterações. Clique em verificar e coloque um dedo no leitor. Caso a verificação ocorra com sucesso o botão Confirmar será habilitado. Cancelar: cancele o cadastro ou edição em qualquer momento clicando em Cancelar. Confirmação: para efetivar o cadastro ou alteração, clique em Confirmar. 08

9 Desenvolvimento em.net Pré-requisitos Visual Studio..NET Framework 2.0 ou superior. Instalação Adicione uma referência ao Veridis.Biometric no seu projeto: 1 No Solution Explorer, selecione o projeto. 2 No menu Project, clique em Add Reference. 3 A caixa de diálogo Add Reference abre. 4 Selecione a aba Browse. 5 Localize o arquivo Veridis.Biometric.dll na pasta \bin do nosso pacote. 6 Clique em OK, quando tiver localizado o arquivo desejado. A referência selecionada (Veridis.Biometric) aparecerá na relação de referências do projeto. A documentação do projeto também estará disponível automaticamente via IntelliSense. Documentação Ao referenciar a Veridis.Biometric no seu projeto a documentação inline é importada e aparece no IntelliSense automaticamente. A documentação também está disponível em formato HTML na pasta \docs\dotnet do nosso pacote. Sample Figura 3 - Sample C#.NET A figura 3 representa a tela principal do sample em C#.NET. O código fonte desse sample está disponível no pacote do SDK e pode ser utilizado como um guia para o desenvolvimento de aplicações que utilizem o.net Framework. 08

10 Desenvolvimento em Java Instalação O componente java é distribuido como um pacote JAR, veridisbiometric.jar, presente na pasta \bin do SDK. Para utilizá-lo, é necessário: Adicionar este pacote ao classpath do seu projeto Na linha de comando, uso o parâmetro "-classpath path/to/veridisbiometric.jar" No Eclipse e NetBeans, siga as instruções disponíveis em nosso site. Instalar o leitor de impressões digitais, conforme seção Instalação do Leitor Apesar do componente Java utilizar bibliotecas nativas (.dll./so), não é necessário tomar nenhuma medida adicional, as bibliotecas são carregadas automaticamente. Documentação Os documentos Javadoc do componente estão presentes na pasta doc/javadoc. Sample O componente acompanha um sample demonstrando as principais funcionalidades do SDK. O código fonte desse sample pode ser encontrado junto ao pacote de instalação na pasta samples/java. Distribuição Distribuir o arquivo veridisbiometric.jar bem como as DLLs nativas junto com o seu projeto Instalar o leitor de impressões digitais, conforme seção Instalação do Leitor 14

11 Desenvolvimento utilizando DLL O uso direto da DLL permite acesso direto às funções do Biometric SDK em muitos ambientes diferentes, mas é particularmente adequada para o desenvolvimento em C/C++. O pacote inclui: Cabeçalho (inc\vrbio.h, inc\vtypes.h, inc\vconsts.h) Import library (VrBio.lib), necessário pelo Visual C++ e outras ferramentas. GCC e algumas outras ferramentas não precisam da Import library para o link. Documentação (docs/c), gerada através de doxygen. Também é possível acessar a DLL a partir de outras linguagens / plataformas, tais como Delphi, Visual Basic, Python, etc. Para tais linguagens, o programador será responsável por criar as bibliotecas de importação necessárias. Documentação Os documentos Doxygen da API estão presentes na pasta docs/c. Sample Os samples em C++ do Veridis Biometrics SDK estão agrupados em uma solução do Visual Studio 2010 (CPPExamples.sln). Os projetos que fazem parte da solução são do tipo Console Application e demonstram as principais funcionalidades do SDK. Embora o Visual Studio e a linguagem C++ tenham sido utilizados, os códigos-fontes servem de base para o desenvolvimento em qualquer linguagem que permita a importação de DLL nativa. Configurações Todos os projetos estão configurados para buscar os arquivos de include no caminho../../../inc e a biblioteca estática no caminho../../../lib/x86. Além disso, alguns projetos fazem o carregamento de imagens de arquivo, utilizando para isso o caminho../../../images. Caso a solução tenha sido colocada em uma pasta diferente daquela da instalação do SDK, esses caminhos devem ser configurados novamente. Obs: Todos os exemplos fazem a chamada da função VInstallLicense( YOUR KEY HERE,null). O primeiro parâmetro da função deve ser substituído pela chave do usuário, gerada no momento da criação da conta no site. Distribuição Para distribuir o Veridis Biometric SDK junto com sua aplicação, nas máquinas clientes: Inserir todas as DLLs necessárias na mesma pasta que o seu aplicativo. Estas podem ser encontradas na pasta bin, dentro da sub-pasta correspondente ao seu sistema (por exemplo, bin\x86). Instalar o leitor conforme seção de "instalação do Leitor". 15

12 VERIDIS BIOMETRICS