Escolar Documentos
Profissional Documentos
Cultura Documentos
Dicionário ...................................................................................................................................................... 3
Introdução..................................................................................................................................................... 4
Visão Geral .................................................................................................................................................... 4
Arquitetura................................................................................................................................................ 4
Requisitos técnicos ................................................................................................................................... 5
Módulo Cliente...................................................................................................................................... 5
Módulo Servidor ................................................................................................................................... 5
Leitores Suportados .................................................................................................................................. 5
Câmeras .................................................................................................................................................... 5
Fluxos de Processamento ......................................................................................................................... 6
Cadastro/Atualização ............................................................................................................................ 6
Busca ..................................................................................................................................................... 7
Instalação ...................................................................................................................................................... 8
Módulo Servidor ....................................................................................................................................... 8
Módulo Cliente ......................................................................................................................................... 8
Integração ..................................................................................................................................................... 9
Definições.................................................................................................................................................. 9
Conta ..................................................................................................................................................... 9
Tipo de Operação .................................................................................................................................. 9
Códigos de Retorno............................................................................................................................. 10
Tipo de Resposta ................................................................................................................................. 10
Status de Processamento.................................................................................................................... 11
Códigos de Posições dos Dedos .......................................................................................................... 11
Requisição ............................................................................................................................................... 12
Resposta .................................................................................................................................................. 12
2
Dicionário
3
Introdução
O SimpleID da HTX Systems é uma plataforma multibiométrica de rápida integração, que permite que
aplicações web e desktop adicionem identificação por impressão digital e facial em seu fluxo de processos
sem a necessidade de alterar o banco de dados, processar imagens ou realizar comparações.
O SimpleID foi desenvolvido de forma que toda a complexidade do processamento biométrico fique sob
sua responsabilidade, tornando a integração simples e de baixo custo. Além disso, por não necessitar
armazenar qualquer informação demográfica, o SimpleID garante a privacidade dos dados e a segurança
que as aplicações necessitam.
Visão Geral
Arquitetura
A arquitetura da solução foi definida de forma a permitir a total separação entre a aplicação e o
processamento biométrico.
Na figura acima é possível observar que o SimpleID é composto por um módulo cliente e um módulo
servidor.
O módulo servidor pode ser instalado no mesmo datacenter da aplicação ou até mesmo em datacenter
diferente. Esse módulo servidor irá receber requisições exclusivamente do módulo cliente, que será
instalado em cada máquina onde a aplicação será executada.
A aplicação, por sua vez, se comunicará apenas com o módulo cliente através de websockets. Com isso,
aplicações web e desktop poderão ser facilmente integradas ao fluxo de processamento biométrico.
4
Requisitos técnicos
Os módulos cliente e servidor são aplicações do tipo Serviço do Windows e possuem os seguintes
requisitos técnicos:
Módulo Cliente
• Windows 7 ou superior
• .NET Framework 4.0 ou superior
• Memória RAM: 2GB ou superior
Módulo Servidor
Leitores Suportados
O módulo cliente do SimpleID é responsável pela comunicação com o leitor de impressão digital. Os
seguintes modelos são suportados atualmente e novos modelos podem ser adicionados sob demanda.
• Futronic FS80/FS88
• Digital Persona 4500
• Nitgen Hamster DX
Câmeras
Como forma de trazer mais flexibilidade, o SimpleID não realiza a integração direta com câmeras para a
captura da foto facial. Dessa forma, a aplicação pode escolher a melhor maneira de capturar a imagem.
No entanto, visando a captura de imagens com qualidade suficiente para serem processadas, recomenda-
se a utilização de câmeras com resolução mínima de 720p.
5
Fluxos de Processamento
O SimpleID é responsável por todos os fluxos relacionados a captura, cadastro e comparação biométrica.
Tanto o módulo cliente como o módulo servidor realizam análises e ações para cada ação solicitada pela
aplicação. A seguir apresentaremos detalhamente cada fluxo.
Cadastro/Atualização
Cliente
Apenas Foto
Caso a aplicação envie uma requisição de cadastro apenas facial, o módulo cliente irá verificar se a imagem
passada é válida e, caso seja, irá enviar para o servidor realizar o processamento. Durante esse processo,
algumas mensagens de status serão enviadas de volta para aplicação até que a mensagem de resposta
final da requisição seja enviada.
Impressão Digital
Quando a aplicação deseja fazer o cadastro de impressões digitais para uma determinada pessoa, todo o
fluxo de controle de qualidade será executado pelo módulo cliente. Dessa forma, a aplicação inicia uma
operação de cadastro junto ao módulo cliente, indica qual dedo deverá ser capturado e à medida que o
usuário interage com o leitor, a aplicação receberá mensagens de status sobre a imagem, qualidade e se
já existem amostras suficiente de um determinado dedo para que a qualidade da informação biométrica
seja garantida. Quando todos os dedos exigidos pela aplicação tiverem sido capturados, uma mensagem
deverá ser enviada para que o módulo cliente envie as informações para que o servidor possa realizar o
processamento.
Servidor
A figura abaixo representa o fluxo de processamento no servidor quando uma requisição de cadastro ou
atualização é recebida. Uma requisição é considerada de atualização quando o identificador único da
pessoa informado já existe na base de dados.
6
Figura 2 - Fluxo de Cadastro no Servidor
• Em uma requisição de atualização, caso ocorra um HIT com as biometrias da própria pessoa sendo
atualizada, esse HIT não será considerado um erro.
• Em uma requisição de atualização apenas as informações que foram passadas serão atualizadas
e/ou inseridas, ou seja, caso uma requisição de atualização contenha apenas uma foto facial e a
pessoa já possua impressões digitais e fotos cadastradas, as impressões digitais NÃO serão
apagadas.
• Em uma requisição de cadastro/atualização contendo foto e impressões digitais, na qual ocorra
HITs diferentes para foto e impressões digitais, os dois HITs serão retornados. Ou seja, caso haja
uma tentativa de cadastro/atualização de uma pessoa João com a foto de José e as impressões
digitais de Maria, a solução irá informar que ocorreu um HIT tanto com José como com Maria.
Esse fluxo garante a UNICIDADE do cadastro biométrico da aplicação, ou seja, com o SimpleID a
aplicação não estará aberta a fraudes onde uma pessoa cadastra suas informações biométricas para
múltiplas identidades
Busca
Cliente
7
Para as requisições de busca, o módulo cliente será responsável por realizar a captura da impressão digital,
avaliar a qualidade e caso a imagem seja considerada adequada, irá enviar para o servidor realizar o
processamento. Para buscas de face, o módulo cliente irá receber a imagem da aplicação e enviar para o
servidor realizar o processamento. Durante esse processo, algumas mensagens de status serão enviadas
de volta para aplicação até que a mensagem de resposta final da requisição seja enviada.
Servidor
A figura abaixo representa o fluxo de processamento no servidor quando uma requisição busca é recebida.
Caso a requisição forneça o identificador de uma pessoa, será realizada uma VERIFICAÇÃO (1:1). Caso a
requisição não forneça um identificador, será realizada uma IDENTIFICAÇÃO (1:N).
Instalação
Módulo Servidor
Caso a instalação seja feita no ambiente da empresa contratante, uma máquina virtual com as
especificações definidas durante a definição do projeto deverá ser fornecida. Caso contrário, a HTX irá
preparar um ambiente em sua nuvem própria e fornecer os dados de conexão para configuração do
módulo cliente para a empresa contratante.
Módulo Cliente
8
A instalação do módulo cliente é feita através de um arquivo .msi, que deverá ser executado por um
usuário com permissão de Administrador na máquina cliente. O serviço do módulo cliente será instalado,
e estará pronto para se comunicar com o módulo servidor.
Integração
Definições
Conta
Uma conta é uma subdivisão da base de dados. A unicidade do cadastro é verificada a nível da conta, ou
seja, uma mesma informação biométrica pode ser registrada mais de uma vez no SimpleID, desde que
seja em contas diferentes.
Durante as operações, a aplicação é responsável por informar em qual conta será executada a ação. Caso
a conta não exista, ela será criada e caso nenhuma conta seja informada, uma conta padrão com nome
“htx” será utilizada.
Tipo de Operação
A tabela a seguir apresenta os tipos de operação que podem ser enviados pela aplicação para o SimpleID.
9
Códigos de Retorno
A tabela a seguir apresenta os códigos de retorno que podem ser enviados pelo SimpleID. Esses códigos
indicarão o sucesso ou falha da operação solicitada. Essa informação está presente no objeto JSON
enviado.
Tipo de Resposta
A tabela a seguir apresenta os códigos dos tipos de resposta (mensagens) que serão enviadas pelo cliente
de volta para a aplicação. Essa informação que permite a aplicação saber a que se refere a mensagem
recebida via websocket.
10
FINGER_CAPTURE_STATUS 1 Mensagem sobre a captura de impressão digital
REGISTRATION_PROCESS_RESPONSE 2 Resposta do processo de cadastro
SEARCH_PROCESS_RESPONSE 3 Resposta do processo de busca de impressão digital
CANCEL_SEARCH_RESPONSE 4 Resposta do cancelamento da busca
SOCKET_GENERAL_MESSAGE 5 Mensagem geral
DELETE_RESPONSE 6 Resposta do processo de remoção
GET_PERSONS_BY_ID_RESPONSE 7 Resposta do método de listar registros
PROCESSING_STATUS 8 Mensagem com a atualização de status de
processamento
DUPLICATED_FINGER 9 Mensagem informando que o mesmo dedo já foi
capturado
GENERAL_MESSAGE 10 Mensagem geral
SEARCH_FACE_RESPONSE 11 Resposta do processo de busca facial
INIT_FACE_ANALYSIS_RESPONSE 12 Resposta do processo de inicialização da análise facial
PERFORM_FACE_ANALYSIS_RESPONSE 13 Resposta do processo de análise facial
STOP_FACE_ANALYSIS_RESPONSE 14 Resposta do processo de término da análise facial
GET_CLIENT_VERSION_RESPONSE 15 Resposta do processo de retorno da versão do client
Tabela 3 - Tipos de Resposta
Status de Processamento
A tabela a seguir apresenta status enviados pelo módulo cliente para que a aplicação acompanhe a
evolução da operação em andamento.
11
RIGHT_THUMB 1 Polegar Direito
RIGHT_INDEX 2 Indicador Direito
RIGHT_MIDDLE 3 Médio Direito
RIGHT_RING 4 Anelar Direito
RIGHT_LITTLE 5 Mínimo Direito
LEFT_THUMB 6 Polegar Esquerdo
LEFT_INDEX 7 Indicador Esquerdo
LEFT_MIDDLE 8 Médio Esquerdo
LEFT_RING 9 Anelar Esquerdo
LEFT_LITTLE 10 Mínimo Esquerdo
Tabela 5 - Posição dos dedos
Requisição
A tabela abaixo especifica o objeto JSON de requisição que deve ser enviado pela aplicação para o módulo
cliente do SimpleID.
Resposta
As tabelas abaixo especificam o objeto JSON que o módulo cliente enviará para a aplicação. O mesmo
objeto é enviado em diferentes situações, e a aplicação deverá utilizar as propriedades baseado no tipo
de resposta.
12
Propriedade Tipo Descrição Exemplo
13
Propriedade Tipo Descrição Exemplo
14