Fingerprint Verification Control

Pantek Productivity Pack
Fingerprint Verification Control
Uživatelský manuál
Verze 1.1
10. října 2001
Fingerprint Verification Control Verze 1.1
Uživatelský manuál
Obsah
ÚVOD ..................................................................................................................................................... 3
Charakteristika produktu ..................................................................................................................... 3
Systémové požadavky ........................................................................................................................ 3
Instalace.............................................................................................................................................. 4
Licencování......................................................................................................................................... 4
POPIS ROZHRANÍ................................................................................................................................. 5
Metody ................................................................................................................................................ 5
TIPY A TRIKY......................................................................................................................................... 6
Vkládání objektu ActiveX do okna aplikace InTouch.......................................................................... 6
Ošetřování chybových stavů............................................................................................................... 6
Strana 2 / 8
Fingerprint Verification Control Verze 1.1
Uživatelský manuál
Úvod
Charakteristika produktu
Fingerprint Verification Control je objekt ActiveX určený pro ověření totožnosti uživatele
Windows NT na základě otisku prstu na počítačích vybavených snímači otisků prstu. Objekt
pro svou správnou funkci vyžaduje software BioLogon firmy Identix, Inc. Více informací viz
http://www.identix.com/products/itsecurity/windows.asp .
Hlavní vlastnosti a přínosy:
•
Ověření platnosti jména uživatele a jeho otisku prstu (namísto hesla)
v bezpečnostním systému Windows NT přímo z aplikace InTouch.
•
Uživatelským účtům ve Windows NT jsou otisky prstů přiřazeny
pomocí software BioLogon, který rozšiřuje možnosti bezpečnostního
systému Windows.
•
Výsledek ověření je vrácen aplikaci InTouch jako pravda/nepravda.
•
Možnost detekce případných chybových stavů.
Systémové požadavky
•
Wonderware InTouch 7.1 nebo
Wonderware InTouch 7.11
•
Microsoft Windows NT 4.0 SP5 nebo vyšší
•
Identix BioLogon 2.0 (http://www.identix.com/products/itsecurity/windows.asp)
•
Hardware pro snímání otisků prstů (například viz
http://www.identix.com/products/itsecurity/hardware.asp)
Strana 3 / 8
Fingerprint Verification Control Verze 1.1
Uživatelský manuál
Instalace
Instalaci produktu Fingerprint Verification lze začít spuštěním souboru Setup.exe. Instalace
probíhá automaticky bez zásahu uživatele.
Instalační program nakopíruje a zaregistruje všechny potřebné soubory na cílový počítač. Po
skončení instalace je Fingerprint Verification připraven k použití.
Pro použití v programu Wonderware InTouch WindowMaker je třeba prvek nainstalovat do
tohoto prostředí. Tato instalace se provede takto:
•
Zobrazte dialog “Wizard/ActiveX Installation” (menu Special/Configure/Wizard-ActiveX
Installation)
•
Zvolte kartu “ActiveX Control Installation”.
•
Ze seznamu “Available ActiveX controls” vyberte “Pantek FingerprintVerification Control”.
•
Stiskněte tlačítko “Install”. Řádek “Pantek FingerprintVerification Control” by se měl
přesunout do seznamu “Installed ActiveX controls”.
•
Klikněte na tlačítko “OK”.
Tímto by měl být Fingerprint Verification nainstalován. Pro vložení do okna bude nyní
dostupný ve “Wizards”, ve skupině “ActiveX Controls”.
Licencování
Tento produkt může být používán pouze na počítačích obsahujících instalaci některého
z produktů rodiny Wonderware FactorySuite 2000. Pro svou funkci dále vyžaduje platný
licenční soubor PantekLic.lic. Licenční soubor je umístěn ve složce Program
Files\FactorySuite\Common\License. Licence je svázána se sériovým číslem (Serial Number)
produktu FactorySuite.
Bez platného licenčního souboru bude Fingerprint Verification spuštěn v demo režimu.
Tento režim je plně funkční, avšak během používání se zobrazuje dialog s informacemi o
produktu a údajem, že jde o demoverzi.
Licenční soubory můžete objednávat u společnosti Pantek (CS) s.r.o.:
s.r.o.
•
Tel.: +420 – 49 – 563 5072 nebo 563 5073
•
E-mail: [email protected]
•
http://www.pantek.cz
Strana 4 / 8
Fingerprint Verification Control Verze 1.1
Uživatelský manuál
Popis rozhraní
Fingerprint Verification Control má jednoduché rozhraní, které poskytuje pouze dvě
metody: VerifyFingerPrint a VerifyFingerGetExtError. Produkt neobsahuje žádné další
vlastnosti, události ani stránky vlastností, což maximálně zjednodušuje jeho použití.
Metody
INT VerifyFingerPrint (MESSAGE UserName, MESSAGE Domain, DISCRETE ReadOnly );
Tato metoda zobrazí dialog produktu BioLogon pro přihlášení uživatele do systému. Tento
dialog je modifikací standardního přihlašovacího dialogu Windows a umožňuje uživateli se
identifikovat otiskem prstu namísto vypsání svého hesla. Modifikace dialogu je provedena
při instalaci BioLogon software. Parametry metody mají následující význam:
UserName ............... jméno uživatele, jehož otisk prstu bude ověřován.
Domain................... název domény, ve které je uživatelský účet vytvořen. Pro lokální účty
použijte jméno počítače.
ReadOnly................. pokud je hodnota TRUE (1), políčko User Name v přihlašovacím dialogu
bude pouze pro čtení. Pokud je hodnota FALSE (0), pak uživatel bude
schopen modifikovat uživatelské jméno v přihlašovacím dialogu.
Návratová hodnota metody: 1 pokud ověření otisku prstu bylo úspěšné, jinak 0.
INT VerifyFingerGetExtError ();
Vrací poslední chybový kód generovaný produktem BioLogon SDK. Jde o jednu z
následujících hodnot:
•
0x00008001 hex nebo 32769 dec – chybná velikost struktury (invalid structure size)
•
0x00008002 hex nebo 32770 dec – chyba inicializace wizarda (unable to initialize logon
wizard)
•
0x00008003 hex nebo 32771 dec – chybná velikost bufferu (invalid buffer size)
•
0x00008004 hex nebo 32772 dec – chybná procedura hook (invalid hook procedure)
•
0x00008005 hex nebo 32773 dec – chyba inicializace knihovny ITCREDS (unable to initialize
ITCREDS library)
•
0x00008006 hex nebo 32774 dec – uživatel uzavřel přihlašovací dialog tlačítkem Cancel
(user cancelled logon wizard dialog)
Návratová hodnota metody: poslední chybový kód (viz výše).
Strana 5 / 8
Fingerprint Verification Control Verze 1.1
Uživatelský manuál
Tipy a triky
Vkládání objektu ActiveX do okna aplikace InTouch
Pro každý objekt ActiveX platí, že aby mohl pracovat musí být vložen do okna kontejneru
(InTouch) a toto okno musí být otevřené. Pokud InTouch aplikace otevře okno s prvkem
Fingerprint Verification, tak tento prvek připojí dynamické knihovny BioLogon SDK, které
jsou nezbytné pro správnou funkci prvku.
Doporučená praxe je mít otevřen právě jeden prvek Fingerprint Verification po celou dobu
běhu aplikace. Je několik způsobů, jak zajistit, aby byl objekt ActiveX otevřen celou dobu:
•
Objekt je vložen do okna, které je otevřeno po celou dobu běhu InTouch aplikace.
•
Objekt může být vložen do speciálního okna, které bude umístěno mimo viditelnou část
obrazovky.
Ošetřování chybových stavů
Pro ošetření případných chybových stavů existuje v prvku Fingerprint Verification metoda
VerifyFingerGetExtError. Následující příklad ukazuje její použití ve skriptu InTouch aplikace.
{ zobraz prihlasovaci dialog }
result = #FingerPrintVerification1.VerifyFingerPrint ( strUserName, strDomain, dReadOnly );
{ zkontroluj navratovou hodnotu }
IF result == 0 THEN
{ verifikace otisku prstu neuspesna, zkontroluj chybovy kod }
error = #FingerPrintVerification1.GetExtendedError ( );
{ zobraz informacni okno s chybovou zpravou }
IF error == 32774 THEN
Show "Msg box";
{ uzivatel zavrel prihlas. dialog tlacitkem Cancel }
ENDIF;
ELSE
{ uspesne prihlaseni, platnost otisku prstu potvrzena }
Show "Protected window";
ENDIF;
Popis příkladu: První příkaz zobrazí přihlašovací dialog s možností identifikace otiskem
prstu. Jestliže výsledek operace bude FALSE (0), pak bude metoda VerifyGetExtError použita
pro získání chybového kódu. Tento kód je porovnán s hodnotou 32774, která reprezentuje
situaci, kdy uživatel uzavřel přihlašovací dialog tlačítkem Cancel.
Strana 6 / 8
Fingerprint Verification Control Verze 1.1
Uživatelský manuál
Dodavatel
Pantek (CS) s.r.o.
Pantek (CS) s.r.o., pobočka Ostrava
Škroupova 957
28. října 150
Hradec Králové
Ostrava
500 02
702 00
Tel.: +420-(0)49-5635 072 až 3
Tel.: +420-(0)69-6602 378
E-mail: [email protected]
E-mail: [email protected]
http://www.pantek.cz
http://www.pantek.cz
Strana 7 / 8
Fingerprint Verification Control Verze 1.1
Uživatelský manuál
Strana 8 / 8