Fingerprint Verification Control

Transkript

1 Pantek Productivity Pack Fingerprint Verification Control Verze října 2001

2 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

3 Ú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 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 ( Hardware pro snímání otisků prstů (například viz Strana 3 / 8

4 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 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.: nebo info@pantek.cz Strana 4 / 8

5 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: 0x hex nebo dec chybná velikost struktury (invalid structure size) 0x hex nebo dec chyba inicializace wizarda (unable to initialize logon wizard) 0x hex nebo dec chybná velikost bufferu (invalid buffer size) 0x hex nebo dec chybná procedura hook (invalid hook procedure) 0x hex nebo dec chyba inicializace knihovny ITCREDS (unable to initialize ITCREDS library) 0x hex nebo 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

6 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 == 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

7 Dodavatel Pantek (CS) s.r.o. Pantek (CS) s.r.o., pobočka Ostrava Škroupova října 150 Hradec Králové Ostrava Tel.: +420-(0) až 3 Tel.: +420-(0) info@pantek.cz pklen@pantek.cz Strana 7 / 8

8 Strana 8 / 8