Академический Документы
Профессиональный Документы
Культура Документы
SecuBSP
Guia de
Programao
Secure
Biometri
c
Service
Provider
SC2-0023F Rev A
Secure
Copyright 2000-2001 SecuGen Corporation
Nmero Serial:
entidade, qualquer um que esteja referido como Licensiado ) a licena para usar o
( Aplicativos)
O licenciado tambm poder reproduzir e distribuir o Sample Code num cdigo objeto
junto com qualquer modificaes que o Licenciado faa no Sample Code, provido que o
c. O Licenciado poder copiar e redistribuir o Sample Code provido de: (a) distribudo
acrescenta funes primrias e significantes para o Sample Code; (c) o Sample Code
Sample Code; (e) Licenciado no usa o nome , logo e nem marca registrada da SecuGen
em seu Aplicativo; (f) Licena inclui uma notificao vlida de direitos autorais no
sem consentimento por escrito concedido pela SecuGen. A SecuGen reserva todos os
desta restrio expressamente permitida pela lei aplicada, (iii) separar os componentes
do SDK para transferir para terceiros; (iv) se alugar, arrendar, vender ou emprestar o
SDK.
SecuGen. O SDK protegido pelas leis de direitos autorais, tratados e acordos de direitos
autorais internacionais.
4. Garantia. A garantia do SDK da SecuGen ao Licenciado expira dentro de um perodo
de trinta (30) dias. Se a data de recebimento do SDK pelo licenciado a mesma data da
compra pelo licenciado, a garantia de trinta dias comea no dia da compra. Se a data de
recebimento do SDK pelo licenciado foi depois do ato da compra , da a garantia de trinta
perodo de trinta dias da garantia, a SecuGen garante que: (a) a mdia na qual o SDK ou a
(b) SDK. o SDK, quando instalado, configurado, usado e mantido de acordo com o
para o SDK. A nica obrigao da SecuGEn , para violao desta garantia ser para a
em combinaes para uso do Licenciado ou que o SDK ser ininterrupto ou livre de erro.
Nem todos os erros no software podem ou precisam ser corrigidos, por isso SecuGen no
garante que o SDK est livre de erros ou que todos os erros do software podem ser
corrigidos.
DO SDK.
aparecendo como resultado de relato e qualquer reclamao do Licenciado que use o SDK
junto com qualquer Licenciado. A infrao da patente, dos direitos autorais, marca
8. Trmino. Sem que prejudique qualquer outro direito, SecuGen pode terminar este
Acordo se o Licenciado falhar ao cumprir com qualquer termo ou condio deste Acordo.
Sobre o trmino deste Acordo, o Licenciado dever imediatamente encerrar o uso do SDK
e certificar a destruio de todas as cpias integrais ou parciais do SDK e materiais
9. Geral. Licenciado reconhece que ele ou ela leu este Acordo, entendeu, e que usando o
SDK o Licenciado concorda em estar dentro dos termos e condies estabelecidas neste
Acordo. O Licenciado, alem disso concorda que este Acordo a declarao completa e
relacionado com o assunto deste Acordo. Este Acordo no dever ser modificado exceto
Licenciado. Se qualquer condio deste Acordo segurada que no pode ser amarrada de
por qualquer razo, tal condio dever ser reformulada somente para o permetro
necessrio para que possa ser compelido, e semelhante deciso no dever afetar a
10. Direitos restritos ao Governo do Estado Unidos. Usar cpia, ou revelao pelo
reexportar o SDK. O Licenciado concorda que o SDK em qualquer forma no dever ser
exportado ou reexportado sem qualquer aprovao dos Estado Unidos e do governo
estrangeiro.
Contedo
Prefcio............................................................................................5
VANTAGENS DE USAR A IMPRESSO DIGITAL.............................................6
SOBRE A SECUGEN..............................................................................7
GLOSSARY OF COMMON BIOMETRIC TERMS..............................................8
CHAPTER ONE............................................................................13
Introducing SecuBSP....................................................................13
1.1 FEATURES......................................................................................14
1.2 BIOMETRIC FUNCTIONS...................................................................15
Primitive API....................................................................................15
1) Capture............................................................................................................. 15
2) Process............................................................................................................. 16
3) VerifyMatch....................................................................................................... 16
4) CreateTemplate................................................................................................. 16
High-level API..................................................................................17
1) Enroll................................................................................................................. 17
2) Verify................................................................................................................. 17
1.3 FIR................................................................................................ 17
1.3.1 Format...................................................................................18
1.3.2 Header...................................................................................18
SC2-0023F Rev A
ii
SC2-0023F Rev A
iv SecuBSP Guia do Programador
SC2-0023F Rev A
5
6
Prefcio 7
8 SecuBSP Guia do Programador
1.3 FIR
Os dados da impresso digital do SecuBSP representado no
Estrutura da FIR:
1.3.1 Formato
O campo de formato FIR indica o formato dos dados da
1.3.2 Cabealho
O cabealho possui 20 bytes e engloba os seguintes campos:
Captulo 1. Introduzindo SecuBSP 13
do cabealho.
14 SecuBSP Guia do Programador
Lista de Arquivos
Destino Arquivos Descrio
Programas de Demonstrao
Demonstrao
Programas Comuns
Principal
\ readme.txt Arquivo de
leitura
Coreano
Arquivos de Exemplos
SecuAPI_Type.h
SecuAPI_CheckValidity.h
SecuBSP SDK
StdAfx.cpp
StdAfx.h
Captulo 2. Instalando SecuBSP 21
BSPDemo.dsp
BSPDemo.dsw
BSPDemo.h
BSPDemo.rc
BSPDemoDlg.cpp
BSPDemoDlg.h
BSPInter.cpp
BSPInter.h
\res\BSPDemo.ico
\res\BSPDemo.rc2
(opcional)
da seguinte janela:
1) Informao BSP
Voc pode configurar os valores do seu SecuBSP nesta seo.
configuraes.
24 SecuBSP Guia do Programador
100.
0 a 100.
registrados em um modelo.
para leitura)
milisegundos)
segurana de verificao.
2) Funes do Dispositivo
A seo Funes do Dispositivo mostra a lista de dispositivos
3) Registrar
A seo Registrar testa a funo de registro de usurios. Se
4) Verificar
A seo Verificar testa a funo verificao. O BSP pode
SecuBSP
29
CAPTULO TRS
Programao SecuBSP
O SecuBSP consiste em uma DLL principal e uma DLL de
do SDK SecuBSP.
Aplicativos
Mdulo externo do UI
Mdulo principal do BSP (Opcional)
(SecuBSP.dll)
(SBSPGame.dll)
Dispositivo de Driver
30
Basic Functions :
SecuAPI_GetVersion ( )
SecuAPI_GetInitInfo ( )
SecuAPI_SetInitInfo ( )
BSP Functions :
SecuAPI_Enroll ()
SecuAPI_Verify ()
ETC......
#incluem "SecuAPI_CheckValidity.h"
Close Dev ice : SecuAPI_CloseDev ice ( )
bool IsValidModule()
{ if (SecuAPI_CheckValidity(_T("SecuBSP.dll")) =
SecuAPIERROR_NONE)
Terminate SecuBSP return
Module : SecuAP_Terminate () true; else return false;}
Programao SecuBSP 31
32 SecuBSP Guia do Programador
device_name = FDP02;
device_name = FDU01;
pDeviceList.
SecuAPI_DEVICE_NAME_FDU01 0x02
SecuAPI_OpenDevice(). O SecuAPI_OpenDevice() ir
34 SecuBSP Guia do Programador
dispositivo de identificao.
m_DeviceID = SecuAPI_DEVICE_ID_AUTO;
else
// Close device.
if ( ret != SecuAPIERROR_NONE )
}
Programao SecuBSP 35
parmetro.
SecuAPI_DEVICE_INFO device_info;
if ( ret != SecuAPIERROR_NONE )
ret = SecuAPI_Enroll(
NULL,
NULL,
);
...
SecuAPI_FreeFIRHandle(g_hBSP, g_hEnrolledFIR);
primeiro do SecuBSP.
Programao SecuBSP 37
SecuAPI_FIR g_FIR;
Membro Descrio
Formato Formato do FIR
38 SecuBSP Guia do Programador
impresso digital
[ Estrutura SecuAPI_FIR ]
SecuAPI_FIR g_FIR;
Programao SecuBSP 39
DWORD length;
if ( ret == SecuAPIERROR_NONE )
BYTE* binary_stream;
g_FIR.Header.DataLength;
g_FIR.Header.Length);
memcpy(&binary_stream[sizeof(g_FIR.Format)
+g_FIR.Header.Length],&g_FIR.Data, g_FIR.Header.Data];
delete [ ] binary_stream;
...
SecuAPI_FIR_TEXTENCODE g_firText;
&g_firText, SecuAPI_FALSE);
if ( ret == SecuAPIERROR_NONE )
char* text_stream;
DWORD length;
length = lstrlen(g_firText.TextFIR);
if (g_firText.IsWideChar == SecuAPI_TRUE))
delete [] text_stream
FIR.
Membro Descrio
IsWideChar Especifica se formato multi-byte ou no
(SecuAPI_TRUE : Multi-byte)
[Estrutura SecuAPI_FIR_TEXTENCODE ]
3.5 Verificao
A funo SecuAPI_Verify () captura os dados da impresso
Membro Descrio
Form SecuAPI_FIR_FORM_HANDLE Forma de
reconhecimento FIR
FIR
FIR
[ Estrutura SecuAPI_INPUT_FIR ]
BSPinputFIR.InputFIR.FIRinBSP = &g_hEnrolledFIR;
if ( g_hBSP != SecuAPI_INVALID_HANDLE )
);
if ( result == SecuAPI_TRUE)
// Verification success
else
// Verification failed
44 SecuBSP Guia do Programador
SecuAPI_FIR_FORM_FULLFIR na forma de
SecuAPI_INPUT_FIR inputFIR;
inputFIR.InputFIR.FIR = &g_FIR;
// Matching
);
if ( result == SecuAPI_TRUE)
// Verification success
else
// Verification failed
SecuAPI_FIR g_FIR;
char * binary_stream;
total_length = lstrlen(binary_stream);
format_length = sizeof(g_FIR.Format);
header_length = sizeof(g_FIR.Header);
header_length);
memcpy(&g_FIR.Data, &binary_stream[format_length+header_length],
data_length);
46 SecuBSP Guia do Programador
);
Programao SecuBSP 47
char* text_stream;
length = lstrlen(text_stream);
Cliente/Servidor]
no segundo parmetro.
SecuAPI_RETURN ret;
ret = SecuAPI_Capture(
NULL,
);
Valor Descrio
Programao SecuBSP 49
atualmente)
atualmente )
atualmente)
[ Valores SecuAPI_FIR_PURPOSE]
SecuAPI_RETURN ret;
SecuAPI_BOOL result;
storedFIR.InputFIR.FIR = &fir1;
inputFIR.InputFIR.FIR = &fir2;
ret = SecuAPI_VerifyMatch(
&payload // Payload
);
if ( result == SecuAPI_TRUE)
// Matching success
...
3.7 (Payload)
No h duas amostras de impresses digitais de usurios que
de usurio.
Membro Descrio
Tamanho Tamanho do Payload
[ Estrutura SecuAPI_FIR_PAYLOAD]
dados atuais.
SecuAPI_FIR_PAYLOAD payload;
ret = SecuAPI_Enroll(
NULL,
&g_hEnrolledFIR, // Handle of enrolled FIR
Programao SecuBSP 53
NULL,
);
SecuAPI_FIR_PAYLOAD payload;
inputFIR.InputFIR.FIRinBSP = &g_hEnrolledFIR;
if (g_hNewTemplate != SecuAPI_INVALID_HANDLE)
SecuAPI_FreeFIRHandle(g_hBSP, g_hNewTemplate);
&payload);
delete[] payload.Data;
SecuAPI_FreeFIRHandle(g_hBSP, g_hEnrolledFIR);
g_hEnrolledFIR = g_hNewTemplate;
g_hNewTemplate = 0;
SecuAPI_FIR_PAYLOAD payload;
NULL,
);
if ( result == SecuAPI_TRUE)
CString msg;
MessageBox(msg);
else
// Verification failed
}
56 SecuBSP Guia do Programador
SecuAPI_WINDOW_OPTION . A estrutura
SecuAPI_Verify().
Membro Descrio
Length Tamanho da estrutura
boto <Cancel>
[Estrutura SecuAPI_WINDOW_OPTION]
SecuAPI
57
APNDICE A.
Usando o Assistente
A.1 Assistente de Registro
1. Quando registro e executado, clique Next para continuar
aparecer.
ajuste.
e segure no lugar.
58
claras e escuras).