MOK/HEFOP Java Kliens Telepítési, kapcsolódási problémák elhárítása és hibakeresés Rendszergazdák, üzemeltetők számára Revíziók: 1.0 Nádor Szabolcs 2008 02 20 1.1 Nádor Szabolcs 2008 04 14 5. pont kiegészítése Tartalom 1 Bevezető... 2 2 Telepítési hibák... 2 2.1 Windows és Java alapkomponensek... 2 2.1.1 Java Runtime 1.5.0.11... 2 2.1.2 Microsoft Visual C++ 2005 Redistributable... 2 2.2 Komponensek regisztrálása... 3 2.3 Gyökér tanúsítványok telepítése... 3 2.4 PIN kód csere... 3 3 Fájlok listája... 3 3.1 Alkalmazás célkönyvtár ban levő könyvtárak... 3 3.2 C:\Windows\System32 ben levő fájlok... 3 3.2.1 Alap kártyakezelő környezet... 3 3.2.2 Java s fájlok... 4 4 Hálózati kommunikáció... 4 5 Mi a teendő, ha... 5 1
1 Bevezető A MOK/HEFOP Java aláíró kliens alkalmazás egy bonyolult infrastruktúrájú, összetett rendszer része, emiatt az üzemeltetés (telepítés) során számtalan hiba előfordulhat, amelyet jelen leírás segítségével lehet elhárítani. Amennyiben olyan probléma merül fel, amire itt nem adtam válasz, akkor kérem, hogy az alábbi elérhetőségek valamelyikén keressenek meg: hefop@medismart.hu 06 20 5881033 (nem tudom felvenni, ha megbeszélésen vagyok, és a szám nélküli hívásoknak csekély az esélyük a visszahívásra) Nádor Szabolcs fejlesztés vezető 2 Telepítési hibák A telepítést a www.medismart.hu honlapról, a MOK Kártya felső menüpontból célszerű indítani. Itt a Drivercsomag link alatt a legfrissebb verzió mindig elérhető. A drivercsomag másik elérési útja: a bal oldali menü Letölthető anyagok Magyar Orvosi Kamara (MOK) Kártyarendszer vagy HEFOP Projekt Alkalmazások MOK HEFOP kártyakezelő alkalmazás és driver X.YZ DL A DL jelző mutatja, hogy internetről próbálja letölteni a kiegészítő komponenseket. 2.1 Windows és Java alapkomponensek A telepítő megpróbálja a telepítés során a szükséges Windows és Java alapkomponenseket letölteni, de proxy s környezetben gyakran ezt nem sikerül végrehajtani. 2.1.1 Java Runtime 1.5.0.11 Csak az 1.5.0.11 es Java jó a kliens alkalmazás futtatására. Az 1.6 os, illetve a korábbi verziók nem biztosítják a megfelelő környezetet a kliens alkalmazás számára. A komponens meglétének ellenőrzése: HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\1.5.0_11\JavaHome A csomag letölthető erről a linkről: http://www.medismart.hu/data/dokumentum/supplemental/jre 1_5_0_11 windows i586 p.exe Vagy a Sun Java oldaláról 2.1.2 Microsoft Visual C++ 2005 Redistributable Feladata az ActiveX komponens számára megfelelő Windows library k nyújtása. Webes alkalmazások számára fontos, hogy telepítve legyen, mert a szkriptek az ActiveX el tudják a kártyakezelő komponenst megszólítani. 2
A komponens meglétének ellenőrzése: HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{7299052b 02a4 4627 81f2 1818da5d550d}\Version tipikusan C:\WINDOWS\WinSxS\ x86_microsoft.vc80.crt_..._8.0.50727.1433_... könyvtár nem üres A csomag letölthető erről a linkről: http://www.microsoft.com/downloads/details.aspx?familyid=200b2fd9 AE1A 4A14 984D 389C36F85647&displaylang=en 2.2 Komponensek regisztrálása Ha az előzőek közül a Visual C++ redist nincs meg, akkor az ActiveX et nem lehet beregisztrálni, emiatt nem fog menni a tanúsítvány igénylés sem. C:\Windows\System32 > regsvr32 MOKAX.DLL Ha ez lefut sikeresen, akkor az ActiveX működni fog. 2.3 Gyökér tanúsítványok telepítése Mivel sem a MediSmart, sem a Magyar Telekom nincs benne a Windows által alapból ismert gyökértanúsítványok listájában, ezért a telepítő a végén célszerű végigkattintani a tanúsítványok telepítését. 2.4 PIN kód csere Ha a telepítés során kiválasztásra került, hogy a Rendszergazda eszközei közül a PIN/PUK kezelő alkalmazás is felkerüljön, akkor azt a telepített célkönyvtár.net2.0 almappájában lehet megtalálni. Parancssoros program, és.net 2.0 t igényel a futtatása. 3 Fájlok listája 3.1 Alkalmazás célkönyvtár ban levő könyvtárak ActiveX (üres, mert a System32 ben van) Certs root certificate ek Docs dokumentáció Java a javas s alkalmazás NET20.NET 2.0 s komponensek SCR33XX a kártyaolvasó driverének telepítője 3.2 C:\Windows\System32 ben levő fájlok 3.2.1 Alap kártyakezelő környezet mokka.dll Kártyakezelő DLL proxyclient.dll Proxy kliens (kártya kommunikációs proxy, nem inet proxy) mokka.cfg Konfiguráció 3
libeay32.dll Kriptográfia modul dmcrdacc.dll Dimenzió chipkártya kezelő MOKAX.dll ActiveX, be is kell regisztrálni 3.2.2 Java s fájlok jdic.dll jnlp2msi.exe IeEmbed.exe MozEmbed.exe tray.dll WinMsiWrapper.dll 4 Hálózati kommunikáció Gyakori hibák a proxy hibák, ami a MOK/HEFOP kártyás rendszerben kétféle proxyt jelentenek: kártya kommunikációs proxy: a kártya és a HSM közti összetett kapcsolatot valósítja meg alkalmazás proxy: normál internetes kapcsolatot próbál a Java s alkalmazás ezen keresztül megvalósítani, és letölteni a futási paramétereit (időpecsét szolgáltató, tanúsítvány típusok, stb.) A mokka.dll a proxyclient.dll segítségével tart kapcsolatot a külvilággal, a mokka.cfg ben leírt proxyt fogja keresni, mert az adja meg a kártya kommunikációs proxyt. A DLL ek nem tartalmaznak semmilyen kulcs információt, ezért van szükség az online kommunikációra, ugyanis a HSM (hardware security module) egy védett hálózaton található meg. Amennyiben egy intézmény saját kártya kommunikációs proxy t szeretne, hogy csak egy gépet kelljen kiereszteni a külvilágba, a többiek pedig belül kommunikálhassanak, kérek egy e mailt küldeni a hefop@medismart.hu címre. A proxy VMWARE image (linux) formájában telepíthető, és mindenütt ajánlott, ahol 10 nél több olvasó lett telepítve, vagy a hálózati policy nem engedi a gépeket a külvilággal kommunikálni. 4
5 Mi a teendő, ha Szimptóma Kriptográfiai modult kell választani a tanúsítvány igénylésekor A jó oldal jelenik meg, de nem látszik a kártyaolvasó a listában (üres a lista) A tanúsítvány igényléskor kiírja: kártya azonosítási hiba, checkterminal, HSM kommunikációs hiba A Java alkalmazás nem tudta letölteni a paramétereit A Java alkalmazásban a terminál ellenőrzés piros lett. A kártya használatkor kiírja, hogy a licence lejárt Sokszor elrontottam a PIN kódomat, vagy nem is tudom, mi az. Sokszor próbáltam a terminál authentikációt, és más kártyával működik, ezzel pedig hibát ad. A tanúsítvány igénylésnél minden látszólag működik, az igénylés megkezdődik, majd sikertelen visszajelzést kapok. Megoldás Nem MOK/HEFOP tanúsítványt akarunk igényelni. www.medismart.hu 1. ActiveX nincs telepítve, vagy nincs regisztrálva 2. A böngésző nem engedélyezte az ActiveX futtatását a lapon. (Felső sárga csík) A proxyclient.dll nem tud kommunikálni a külvilággal. A mokka.cfg fájlban jelzett (kártya) proxy szervert nem találja. A Java első indulásakor rossz internet proxy paraméterek lettek megadva. Kommunikációs hiba: a kártya alrendszer (proxyclient.dll) nem tud kommunikálni. Új drivercsomagot kell letölteni. (Ez 2008 évvégéig nem fog előfordulni.) Jobb nem túl sokat próbálkozni, ugyanis a PIN kódot 5 próba után letiltja a rendszer, és csak PUK kóddal lehet kinyitni. Ha a PIN kód nem volt megváltoztatva gyártás óta, akkor az ügyfélszolgálat meg tudja mondani. De csak annak, akié a kártya (telefonos, hangfelvételes azonosítás és/vagy egyéb ellenőrzés). Sikerült a kártya kommunikációs kulcsait zárolni, új kártyát kell igényelni. Max. 20 szor lehet sikertelenül próbálkozni, és a belső számláló minden sikeres terminál azonosításnál visszaáll 0 ra. A megadott adatokban nem lehet, (vessző) és / (perjel), mivel ezek speciális karakterek. 5