Pantek Productivity Pack Fingerprint Verification Control Verze 1.1 10. října 2001
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
Ú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
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.: Tel.: +420 49 563 5072 nebo 563 5073 E-mail: info@pantek.cz http://www.pantek.cz Strana 4 / 8
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
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
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: info@pantek.cz E-mail: pklen@pantek.cz http://www.pantek.cz http://www.pantek.cz Strana 7 / 8
Strana 8 / 8