Ingrid Signo Webservice telepítési és üzemeltetési kézikönyv

IngridSigno Webservice telepítési és üzemeltetési kézikönyv 3.0. verzió

Microsoft Windows operációs rendszerre

2006. január 20.

IngridSigno Webservice üzemeltetési kézikönyv

Az ingrid Signo XML Alapú, Elektronikusan Aláírt Foglalkoztatói Bevallás Hitelességet Ellenőrző Modult az IRF Szoftverház készítette, a termékhez kötődő minden szerzői jog az IRF Szoftverházat illeti. Termékinformáció: www.irf.hu A Digitális Aláírás a MultiSigno termék használatával történik. A termék a KopintDatorg fejlesztése. Ehhez kapcsolódó minden szerzői jog a Kopint-Datorg Rt.-t illeti. Termékinformáció: www.kopint-datorg.hu/multisigno. A Szoftver és az ahhoz fűződő jogok – így a szellemi alkotásokhoz fűződő jogok, a Szoftver továbbfejlesztési, módosítási, forgalmazási és szerzői, továbbá a Szoftverhez fűződő vagyoni jogainak – kizárólagos tulajdonosa és jogosultja az IRF Szoftverház. Az IRF Szoftverház Kft. mindent megtett annak érdekében, hogy ez a dokumentum pontos információkat közöljön. Ennek ellenére a közölt információk tartalmazhatnak műszaki vagy más jellegű pontatlanságokat. Az IRF Szoftverház Kft fenntartja magának az előzetes értesítés nélküli változtatás jogát. A rendelkezésre bocsátott műszaki dokumentációk az IRF Szoftverház Kft. szerzői jogi védelme alatt álló termékei, amelyek kizárólagos tulajdonosa az IRF Szoftverház Kft. A Windows a Microsoft Corporation bejegyzett védjegye, a dokumentációban szereplő egyéb terméknevek más vállalatok védjegyei vagy bejegyzett védjegyei lehetnek, amelyeket az IRF Szoftverház Kft. ezennel elismer. Jelen kiadvány bármely részéről kizárólag az IRF Szoftverház Kft. írásos engedélye alapján készíthető másolat.

2

IRF Szoftverház Kft.

ingrid®Signo Felhasználói Kézikönyv

TARTALOMJEGYZÉK 1. ÁLTALÁNOS LEÍRÁS, RENDSZERKÖRNYEZET .................. 4 1.1. SZOFTVERKÖVETELMÉNYEK ................................................................4 1.2. HARDVERKÖVETELMÉNYEK .................................................................4 1.2.1. SZÁMÍTÓGÉP .......................................................................................4 1.2.2. TŰZFAL ..............................................................................................4 1.2.3. INTERNET HOZZÁFÉRÉS ...........................................................................5

1.3. EGYÉB KÖVETELMÉNYEK ....................................................................5

2. A PROGRAM TELEPÍTÉSE .......................................... 6 2.1. ELŐKÉSZÜLETEK A TELEPÍTÉSHEZ .........................................................6 2.2. A TELEPÍTŐ FUTTATÁSA .....................................................................7 2.3. BEÁLLÍTÁSOK A TELEPÍTÉS UTÁN ..........................................................9 2.4. TÖBB PÉLDÁNY TELEPÍTÉSE............................................................... 14

3. A PROGRAM ELTÁVOLÍTÁSA .................................... 14 4. JOGOSULTSÁGOK ................................................. 15 5. A PROGRAM MŰKÖDÉSE ......................................... 15 5.1. A PROGRAM FELADATAI ................................................................... 15 5.2. A RENDSZER FIZIKAI ARCHITEKTURÁJA ................................................. 16 5.3. A LÉTREJÖVŐ FÁJLOK ..................................................................... 17 5.3.1. ADATSZOLGÁLTATÁS CSOMAG .................................................................17 5.3.2. NYUGTA CSOMAG ................................................................................17 5.3.3. KONTÉNER FÁJL ..................................................................................18

6. BEÁLLÍTÁSOK ..................................................... 18 6.1. A WEB.CONFIG PARAMÉTEREI ............................................................ 18 6.2. AZ ALÁÍRÓ TANÚSÍTVÁNY KIVÁLASZTÁSA ..... HIBA! A KÖNYVJELZŐ NEM LÉTEZIK.

7. ÜZEMELTETÉSI FELADATOK .................................... 21 7.1. TANÚSÍTVÁNYOK TELEPÍTÉSE ............................................................ 21 7.2. MENTÉS/ADATVISSZATÖLTÉS............................................................ 21

8. NAPLÓZÁS ......................................................... 23 9. HIBAKEZELÉS ..................................................... 24


3


1. ÁLTALÁNOS LEÍRÁS, RENDSZERKÖRNYEZET Az IngridSigno Webservice teszi lehetővé az adatszolgáltatások felhasználói interakció nélküli fogadását. A webservice üzemeltetése egy, az internetre kapcsolódó, webszerverként üzemelő számítógépen történik. A megfelelően beállított webservice képes a foglalkoztatók vagy egyéni vállalkozók által elektronikus úton küldött adatszolgáltatás csomagokat fogadni és ellenőrízni.

1.1. SZOFTVERKÖVETELMÉNYEK A webservice futtatásához ajánlott operációs rendszer a Microsoft Windows 2003 melyen az Internet Information Server 5 vagy 6 verziója és a MS.NET Framework v1.1 telepítve van.

1.2. HARDVERKÖVETELMÉNYEK 1.2.1. SZÁMÍTÓGÉP

A rendszer üzemeltetéséhez ajánlott számítógép konfiguráció a következő: Intel P4 processzor, 512 Mbyte RAM, az alkalmazás részére 50 Mbyte, a beérkezett adatok számára pedig 1-20 Gbyte háttértár, Internet kapcsolathoz szükséges kommunikációs eszköz (hálózati kártya, ISDN, ADSL, BDSL berendezés) Az adatok biztonságos tárolása érdekében redundáns adattárolást, pl. RAID-1 (lemeztükrözés) megoldást kell alkalmazni. A biztonsági mentések elvégzéséhez olyan adattároló megoldást kell alkalmazni amely lehetőséget biztosít a mentet adatoknak az eredeti adatokat tartalmazó adathordozótól való fizikailag elkülönített tárolására. 1.2.2. TŰZFAL

A rendszer használatához tűzfal üzemeltetése ajánlott. 4



1.2.3. INTERNET HOZZÁFÉRÉS

A beérkező adatszolgáltatások Internet kapcsolaton keresztül érkeznek be a webszerverre. A megvalósítandó feladat a kliens oldal részéről nem, de a szerver oldalon folyamatosan rendelkezésre álló internetes csatlakozást követel meg. Minimális követelmény: Fix IP címmel rendelkező ADSL (vagy BDSL) kapcsolat. Ennek rendelkezésre állása éves szinten 95%. Javasolt: A rendelkezésre állás növelése érdekében bérelt vonali összeköttetés azonnali átkapcsolást biztosító tartalék összeköttetéssel (akár ISDN backup vonallal). Így 99% feletti rendelkezésre állás érhető el. 1.3. EGYÉB KÖVETELMÉNYEK A rendszer üzemeltetéséhez nélkülözhetetlen egy érvényes, fokozott biztonságú, az alkalmazás személyes tanúsítványtárába telepített aláíró tanúsítvány, amely a nyugta-üzenetek aláírására szolgál, valamit egy működő időbélyeg szolgáltatás. Az időbélyeg szolgáltatást valamelyik hitelesítés szolgáltatónál lehet megrendelni. Amenynyiben az időpecsét kéréshez a szolgáltató tanúsítványt mellékel, ezt is telepíteni kell a személyes tanúsítványtárába.


5


2. A PROGRAM TELEPÍTÉSE 2.1. ELŐKÉSZÜLETEK A TELEPÍTÉSHEZ A program telepítésének megkezdése előtt létre kell hozni egy felhasználót, akinek a nevében a webservice-t futtatni szeretnénk.

Ezt a Számítógép kezelés (Computer Management) funkció használatával lehet megtenni. A funkció indítható a „Control Panel/Administrativ Tools/Computer Management” kiválasztásával vagy a Desktopon a MyComputer ikonon a jobb egérgommbal kattintva feljövő popUp menü „Manage” menüpontjának a kiválasztásával. Ezután ki kell választani a Local Users and Groups, majd a Users elemet, és ott a menüben a Create User menüpont kiválasztása után felvinni az új felhasználót.

6



A telepítés megkezdése előtt meg kell győződni róla, hogy a számítógépre a Windows, az Internet Information Server és az MS .NET Framework megfelelő verziói vannak telepítve. Ellenőrizni kell,hogy az IIS fut-e. Az operációs rendszer „Környezeti változók” -> „Rendszerváltozók” > „Path” kulcsához adjuk hozzá a „telepítési célmappa\WorkDir” értéket (teljes fizikai elérési út szükséges). A fenti ellenőrzések után el lehet indítani a webservice telepítő programját.

2.2. A TELEPÍTŐ FUTTATÁSA A telepítő elindítása után ellenőrzi, hogy a program a gépen már telepítve van-e, és ha igen, akkor a telepítést megszakítja. Ha korábbi verziót szeretnénk eltávolítani, akkor figyelnünk kell rá, hogy az „uninstall” csak akkor tud minden szükséges korábbi állományt eltávolítani, ha a webservice le van állítva. Amennyiben a program telepíthető úgy a következő képernyő jelenik meg.


7


8



Ez után a program információkat jelenít meg a rendszer telepítésével kapcsolatban, majd meg kell adni a webservice kívánt elérési útját, és a webszerver portcímét. A Disc Cost gombra kattintva megnézhetjük mennyi szabad hely van a merevlemezen.

A tovább gombra kattintva a program megkezdi a webservice telepítését, majd annak végeztével tájékoztatja a felhasználót a telepítés sikerességéről. Sikertelen telepítés esetén a program minden beállítást helyreállít a telepítés előtti állapotra. 2.3. BEÁLLÍTÁSOK A TELEPÍTÉS UTÁN A felhasználónak megfelelő jogosultságokat kell adni a webservice root alatti alkönyvtárakhoz, melyekben az adatszolgáltatás fájlok, a naplófájlok kerülnek eltárolásra, illetve ahol a bejelentkezettségi adatokat tartalmazó mdb fájl és a tanúsítványtár található.


9


Mappa Webservice root Webservice root\Web.config

bin Data Data\tempFiles db Log WorkDir

Jogosultságok végrehajtás, olvasás A „config.exe”-t futtató felhasználó számára végrehajtás, olvasás, írás végrehajtás, olvasás végrehajtás, olvasás, írás végrehajtás, olvasás, írás végrehajtás, olvasás, írás végrehajtás, olvasás, írás végrehajtás, olvasás, írás

Ezek után a web.config fájlban megfelelően be kell állítani a paramétereket. Lásd:6 bekezdés. Be kell állítani a „Windows\Microsoft.NET\Framework\V1.1.4322\CONFIG\machine.config”

fájl ProcessModel szekciójában, hogy a webservice mely felhasználó jogosultságával fusson. <processModel enable="true" timeout="Infinite" idleTimeout="Infinite" shutdownTimeout="0:00:05" requestLimit="Infinite" requestQueueLimit="5000" restartQueueLimit="10" memoryLimit="60" webGarden="false" cpuMask="0xffffffff" userName="ebevallas" password="jelszo" logLevel="Errors" clientConnectedCheck="0:00:05" comAuthenticationLevel="Connect" comImpersonationLevel="Impersonate" responseDeadlockInterval="00:03:00" maxWorkerThreads="20" maxIoThreads="20" />

10



Végül a felhasználó személyes tanúsítványtárába telpíteni kell az aláíráshoz használni kívánt tanúsítványt. Ehhez használjuk a program mappában található „Config.exe” alkalmazást.

A „File”->”Tanúsítványtár” menüpont segítségével tudjuk elérni a fogadó modul által használt tanúsítványtárat. Adjuk hozzá a személyes tárhoz a szükséges fokozott aláíró tanúsítványt


11


A tanúsítvány telepítése után a „Kiválaszt” nyomógomb segítségével tudjuk kijelölni, mely tanúsítvánnyal szeretnénk a visszaküldendő nyugtaüzeneteket aláírni. A megfelelő aláíró tanúsítvány kiválasztása után a program a kiválasztott tanúsítvány sorszámát (ami nem azonos a sorozatszámmal) elmenti a web.config certificateIndex paraméterébe.

12



Ha a szolgáltató az időbélyeg szolgáltatáshoz tanúsítványt mellékelt, akkor az „Időbélyeg szolgáltatáshoz tanúsítvány szükséges” címkéjű jelölő négyzetet pipáljuk ki és ebbe a blokkba tartozó „Kiválaszt” nyomógomb segítségével - az aláíró tanúsítvány kiválasztásához hasonló módon - válasszunk ki az időbélyegzéshez használni kívánt a személyes tanúsítványt. A megfelelő időbélyeg tanúsítvány kiválasztása után a program a kiválasztott tanúsítvány sorszámát (ami nem azonos a sorozatszámmal) elmenti a web.config TSAcertificateIndex paraméterébe. A fenti beállítások után újra kell indítani a webservice-t.


13


2.4. TÖBB PÉLDÁNY TELEPÍTÉSE A program egy webszerveren több példányban is futhat. Ehhez létre kell hozni egy új alkönyvtárat és abba bemásolni a webservice és a webservice alkönyvtára alatti bin könyvtár által tartalmazott fájlokat. A webservice-t futtató felhasználónak jogot kell adni az új alkönyvtárakhoz is, illetve a web.configban az összes szükésges paramétert módosítani. A létrehozott alkönyvtárra vonatkozóan az IISben applikációt kell generálni.

3. A PROGRAM ELTÁVOLÍTÁSA A program eltávolítása a következőképpen történik. A Control Panelen ki kell választani az Add/Remove Programs funkciót, és az ott megjelenő listából kiválasztani az IngridSigno Webservice-t. A Remove gomb lenyomása után a rendszer a programot automatikusan eltávolítja a rendszerből. Figyeljünk oda, hogy az eltávolítás megkezdése előtt a webservice le legyen állítva.

14



4. JOGOSULTSÁGOK A program a telepítés során meghatározott felhasználó jogosultságával fut. A kiválasztott felhasználónak jogosultságot kell adni a beérkező adatszolgáltatásokat, illetve a a naplófájlt tartalmazó alkönyvtár kezeléséhez. A program üzemeltetéséhez semmilyen egyéb jogosultság nem szükséges, rendszeralkalmazásként, felhasználói beavatkozás nélkül működik.

5. A PROGRAM MŰKÖDÉSE 5.1. A PROGRAM FELADATAI ▪ ▪ ▪

a beérkezett adatszolgáltatás csomagok ellenőrzése nyugtacsomag létrehozása és továbbítása a foglalkoztató felé. A konténer fájl előállítása és eltárolása.


15


5.2. A RENDSZER FIZIKAI ARCHITEKTURÁJA

A fenti ábra a rendszer fizikai architektúráját szemlélteti. A fogadó modulnak helyet adó webszervert a pénztár informatikai biztonsági szabályzatának megfelelő módon kialakított és üzemeltetett környezetben, csomagszűrő tűzfallal kell védeni.

16



5.3. A LÉTREJÖVŐ FÁJLOK A webservice által létrehozandó fájlok köre a web.config fájlban megadott SaveAllFiles paraméterrel befolyásolható. Amennyiben ezt a paramétert „0”-ra állítjuk, csupán a konténer fájl és a beérkezett adatszolgáltatás csomag kerül elmentésre. A paraméter „1”-re állítása esetén a rendszer elmenti a beérkezett adatszolgáltatást, a nyugta csomagot, az aláírt nyugtacsomagot, illetve a konténer fájlt is. A konténerfájlon kívül minden fájlt a megadott adatszolgáltatás alkönyvtár alatt létrehozott tempFiles könyvtárba ment a webservice. A konténer fájl-t a program a konfigurációban megadott alkönyvtárba menti el a foglalkoztató által megadott néven, abban az esetben ha a csomag hibátlannak bizonyult. A fájlok neve a beérkezett adatszolgáltatás fájlnév alapján kerül meghatározásra úgy, hogy a filenév kiegészítésre kerül egy jelzéssel arra vonatkozóan, hogy a hivatkozott adatszolgáltatáscsomaghoz kapcsolódóan mit tartalmaz. A következő kiegészítések fordulhatnak elő: _ArrivedPackage a beérkezett adatszolgáltatás csomag _ServerXMLResponse nyugta csomag _ServerSignedResponse aláírt nyugta csomag _ControlContainer konténerfájl ellenőrzési céllal A kontrol konténer fájlt a program abban az esetben is létrehozza, ha a beérkezett adatszolgáltatás csomag valamilyen szempontból hibásnak bizonyult. 5.3.1. ADATSZOLGÁLTATÁS CSOMAG

A foglalkoztató vagy meghatalmazottja által - a Pénztár program segítségével - összeállított és aláírt adatszolgáltatás adatok adatszolgáltatás csomagként kerülnek továbbításra a fogadó modul részére. 5.3.2. NYUGTA CSOMAG

A fogadó modul a beérkező adatszolgáltatás csomagokat ellenőrzi, majd az ellenőrzések eredményeit, és a beérkezést igazoló nyugtát tartalmazó, fokozott biztonságú aláírással ellátva nyugta csomagot küld vissza a küldő modul részére. IRF Szoftverház Kft.

17


5.3.3. KONTÉNER FÁJL

Az összetartozó adatszolgáltatás csomag és a nyugta csomag minden esetben (küldő, fogadó s feldolgozó oldalon egyaránt) egységes szerkezetben, konténer fájlban kerül tárolásra. A feldolgozó program bemenetét ezek a konténer fájlok jelentik.

6. BEÁLLÍTÁSOK A program működését befolyásoló paraméterek a webservice alkönyvtárában a web.config fájlban találhatóak. 6.1. A WEB.CONFIG PARAMÉTEREI Paraméter neve ptAzon

MaxFileSize

MaxDirSize

MDBPath 18

Leírás A pénztár azonosítója. Az azonosítót négy karakteren, balról „0”-val feltöltve kell megadni. Pl.:”0027”. Amennyiben egy webszerveren több pénztár adatszolgáltatását is fogadni kívánjuk, úgy a webservice-ből több különálló verziót kell futtatni, és mindegyiknél megadni a pénztárazonosítót. A beérkező adatszolgáltatás fájlok maximális méretét lehet megadni. Amennyiben az adatszolgáltatás fájl ennél nagyobb, az nem kerül eltárolásra, és a küldő hibaüzenetet kap. A méret megadása történhet byte-ban, Kbyte-ban és Mbyteban. Pl.:”60000”,”150k”,”5M” A beérkező adatszolgáltatások mentésére fenntartott alkönyvtár maximális méretét lehet megadni. Amennyiben az alkönyvtárban már nincs annyi hely, hogy a beérkezett adatszolgáltatást eltároljuk, úgy az nem kerül eltárolásra, és a küldő hibaüzenetet kap. A bejelentkezettség adatokat tartalmazó IRF Szoftverház Kft.


DataPath

LogPath

SaveAllFiles

SaveAllMessages

certificateIndex

TSAcertificateIndex

adatállomány elérési útja illetve a file neve. Az elérési út megadása a webservice elérésí útjához viszonyítva történik. Pl.: „Database/IngridSigno.MDB” A beérkező adatszolgáltatás fájlok mentésének elérési útja a webservice alkönyvtárához viszonyítva. Pl.: „Data” A logfájlok mentésének elérési útja a webservice alkönyvtárához viszonyítva. Pl.: „Log” Paraméter amely meghatározza hogy csak a beérkezett adatszolgáltatás csomagot és a konténer fájlt akarjuk menteni, vagy a nyugta az aláírt nyugta csomagot és a kontrol konténer fájlt is. 0 – csak az adatszolgáltatás és a konténer fájl mentése 1 – minden fájl mentése 0 – csak a hibák és figyelmeztetések kerülnek be a nyugta csomagba. 1 – az üzenetek és az Információk is bekerülnek a nyugta csomagba. A nyugta aláírásához használt tanúsítvány személyes tanúsítványtárbeli sorszáma. A tanúsítványok sorszámozása a tanúsítványtárakban nulláról indul. Az időpecsét kéréshez használt tanúsítvány személyes tanúsítványtárbeli sorszáma. A tanúsítványok sorszámozása a tanúsítványtárakban nulláról indul. Ha nem szükséges ilyen tanúsítvány, akkor ehhez a kulcshoz tartozó érték kitöltetlen. Pl.: vagy

TSAURL Owner IRF Szoftverház Kft.

A hitelesítés-szolgáltatótól kapott időbélyeg URL. A nyugta csomag aláírója 19


ProductionCity ProductionProvince ProductionPostalCode ProductionCountry

20

A A A A

nyugta nyugta nyugta nyugta

aláírásának aláírásának aláírásának aláírásának

városa körzete irányítószáma országa



7. ÜZEMELTETÉSI FELADATOK A rendszer üzemeltetése során a következő feladatokat kell elvégezni: Tanúsítványok telepítése Mentések készítése 7.1. TANÚSÍTVÁNYOK TELEPÍTÉSE A rendszerben mindig telepítve kel hogy legyenek azok a tanúsítványok, amelyek a beérkezett adatszolgáltatások aláírásainak az ellenőrzéséhez szükségesek. Ezek a tanúsítványok idővel érvényüket vesztik, így gondoskodni kell arról, hogy mindig az éppen aktuálisan érvényes tanúsítványok legyenek telepítve. 7.2. MENTÉS/ADATVISSZATÖLTÉS A rendszer által használt illetve eltárolt adatokat napi rendszerességgel menteni kell. Ehhez célszerű olyan mentési eljárást telepíteni a szerverre, amely automatikusan, felhasználói beavatkozás nélkül végzi el a mentési műveleteket. A mentések idejére a rendszert nem kell leállítani. A mentendő fájlok körébe tartoznak a webservice beállításait tároló állományok a webservice alkönyvtárában, a fogadott adatszolgáltatások és azokhoz kapcsolódó állományok, illetve a naplófájlok. A mentést minden esetben külső adathordozóra kell készíteni, és azt a szervertől elkülönítve, amennyiben lehetséges úgy tűzbiztos páncélszekrényben tárolni. A szerveren levő adatok meghibásodása esetén lehet szükségünk a mentett adatok visszatöltésére. Ilyenkor a legutolsó sikeres mentés során keletkezett állományokat kell visszatölteni. A visszatöltés előtt az aktuális állapotot mindenképpen érdemes elmenteni, mert sok esetben olyan adatokat tartalmazhat, amelyekre a mentés visszaállítása után is szükségünk lehet.


21


A mentés és az adatvisszatöltés menete természetesen minden esetben az erre a célra használt alkalmazástól függ.Egy lehetséges eljárás a mentések végrehajtásához a Windows beépített Backup programja. Ennek telepítéséről és üzemeltetéséről a Windows dokumentációjában lehet további információkat találni.

22



8. NAPLÓZÁS A program valamennyi feldolgozási műveletet naplózza. A napló adatok szövegfájlban kerülnek tárolásra, amelyhez a hozzáférést az operációs rendszer szabályozza. A naplófájlok az üzemeltetési dokumentációban szabályozott módon archiválásra és megőrzésre kerülnek. Részlet a naplófájlból: 2004.09.06. 16:53:04 : ************************************** 2004.09.06. 16:53:04 : Webservice inditása...user:IRF\lengyel.zoltan 2004.09.06. 16:53:04 : **************************************7 2004.09.06. 16:53:04 : Pénztár Azonosító:0016 2004.09.06. 16:53:05 : Bejelentkezettségi adatok adatbázisának elérési útja:c:\inetpub\wwwroot\eBevallas\DB\IngridSigno.MDB 2004.09.06. 16:53:05 : *** 0016_1_11111111111_200409061652.xml adatszolgáltatás csomag ellenőrzése... 2004.09.06. 16:53:05 : 0016_1_11111111111_200409061652.xml eredeti adatszolgáltatás csomag mentése... 2004.09.06. 16:53:05 : *** Az adatszolgáltatás csomag hibás... 2004.09.06. 16:53:05 : nyugtacsomag létrehozása a 0016_1_11111111111_200409061652.xml adatszolgáltatás csomaghoz... 2004.09.06. 16:53:05 : Feltöltés azonosító létrehozása... 2004.09.06. 16:53:06 : Konfigurációs adatok olvasása az aláíráshoz... 2004.09.06. 16:53:06 : Nyugtacsomag mentése: 0016_1_11111111111_200409061652.xml 2004.09.06. 16:53:06 : Nyugtacsomag aláírása: 0016_1_11111111111_200409061652.xml 2004.09.06. 16:53:06 : Aláírt Nyugtacsomag mentése: 0016_1_11111111111_200409061652.xml 2004.09.06. 16:53:06 : Kontroll Konténerfile mentése: 0016_1_11111111111_200409061652.xml 2004.09.06. 16:54:00 : ************************************** 2004.09.06. 16:54:00 : Webservice inditása...user:IRF\lengyel.zoltan 2004.09.06. 16:54:00 : **************************************

A program interaktív hibakijelzéssel nem rendelkezik, a futás során előforduló hibák a naplófájlban illetve a nyugtafájlban kerülnek kijelzésre. Hibát okozhat a nem megfelelő telepítés vagy beállítás, ileltve az üzemeltetés során esetlegesen előforduló problémák, például alkönyvtár törlése, felhasználói jogosultságok megváltoztatása vagy a felhasználó jelszavának megváltoztatása.


23


9. HIBAKEZELÉS Amennyiben a program nem képes a beérkező adatszolgáltatás csomagok fogadására, vagy a nyugta csomagban hibára utaló bejegyzés van, úgy a következőket kell ellenőrízni. •

• • • • • • • •

A webservice-hez rendelt felhasználónak van-e írási és olvasási joga az adatszolgáltatás csomagokat és a naplófájlt tartalmazó alkönyvtárakhoz (Data, Db, Log, WorkDir)? Van-e elegendő hely a merevlemezen? Telepítve vannak-e a szükséges tanúsítványok a felhasználó személyes tanúsítványtárába? A machine.config fájlban megfelelő felhasználói név van-e regisztrálva? (lásd: 2.3) A Web.Config fájlban megfelelő adatszolgáltatás mappa van-e megadva ? A Web.Config fájlban megfelelő naplófájl mappa van-e megadva ? A Web.Config fájlban megfelelő pénztárazonosító van-e megadva ? Megfelelő tanúsítvány van-e kiválasztva a nyugta aláírásához ? A Control Panelen be van állítva a magyar kódlap használata nem Unicode programok esetén.

Amennyiben a programban a fenti ellenőrzések után is hibásan működik, úgy célszerű annak újratelepítése. Ha újratelepítés után sem megfelelő a működés, úgy a következőket kell ellenőrízni: • • • •

IIS telepítve van, és megfelelően működik MS.NET Framework 1.1 telepítve van A számítógép csatlakozik az internetre A tűzfalon a webszerver megfelelő portjai negedélyezve vannak

Ha a program fogadja az adatszolgáltatás csomagokat, de a nyugtafájlban arra vonatkozóan hibákat jelez, úgy a feldolgozó programmal célszerű ellenőrízni a konténer fájlt.

24



TERMÉKTÁMOGATÁS Ha a termékkel problémák vagy kérdések merülnek fel vegye fel a kapcsolatot ügyfélszolgálatunkkal! E-mail: Internet: Telefon: Fax:

[email protected] www.irf.hu 212-6346 212-3754

VÁRJUK JAVASLATAIT Várjuk jelen dokumentummal és a programmal kapcsolatos észrevételeiket és javaslataikat. Az új verziók tervezésénél törekszünk arra, hogy minél több felhasználói kérést be tudjunk építeni a programba. Jelezze ötleteit az előzőekben felsorolt csatornák valamelyikén!

ADATHORDOZÓ MEGHIBÁSODÁS Ha a telepítő CD meghibásodott, akkor ezt a vételtől számított 30 napon belül jelezze az ügyfélszolgálatunknak! A hibás adathordozó cseréjéről a lehető leggyorsabban intézkedünk!


25


VÉGFELHASZNÁLÓI LICENCSZERZŐDÉS A LICENCSZERZŐDÉS TÁRGYA

Az IRF Szoftverház Kft. (1015 Budapest, Szabó Ilonka utca 61., a továbbiakban: IRF Szoftverház), az „ingrid Signo XML Alapú, Elektronikusan Aláírt Foglalkoztatói Bevallás Hitelességet Ellenőrző Modul” (továbbiakban Szoftver) fejlesztője és annak kizárólagos tulajdonosa. Jelen végfelhasználói licencszerződés (továbbiakban: Szerződés) a Szoftver felhasználását szabályozza. A SZERZŐDÉS LÉTREJÖTTE

A Szoftver telepítésére, illetve használatára kizárólag a Pénzügyi Szervezetek Állami Felügyelete által a mindenkori felhasználás időpontjában érvényes tevékenységi engedéllyel rendelkező magánnyugdíjpénztár (továbbiakban: Magánnyugdíjpénztár) vagy az adott Magánnyugdíjpénztár helyett a nyilvántartási és adminisztrációs tevékenységet érvényesen ellátó szolgáltató szervezet (továbbiakban: Szolgáltató) jogosult. A Szerződés a Szoftver telepítésével jön létre az IRF Szoftverház és a felhasználó Magánnyugdíjpénztár vagy Szolgáltató (továbbiakban: Felhasználó Szervezet) – együttesen a Felek – között a Szoftver felhasználás tárgyában. SZOFTVERHASZNÁLATI FELTÉTELEK

A szoftverhasználati jog a Felhasználó Szervezet részére, a Szoftver egy telephelyen, egy példányban, egy egyidejű felhasználóval történő üzemeltetésre szól. A Felhasználó Szervezet a Szoftvert kizárólag Magyarországon, és kizárólag a Magánnyugdíjpénztár adminisztrációs feladatainak támogatására használhatja. A szoftverhasználati jog a Felhasználó Szervezet részéről nem ruházható át és nem értékesíthető. A Felhasználó Szervezet tudomásul veszi, hogy a Szoftverrel kapcsolatos, a szoftverhasználati jogon kívüli egyéb jogot az IRF Szoftverház nem ad át a Felhasználó Szervezet részére. A Felhasználó Szervezet nem jogosult más rendszeren történő használat céljából a Szoftverről másolatot készíteni, a Szoftvert le illetve 26



visszafordítani vagy azt származékos szoftver termék előállításához felhasználni. A Felhasználó Szervezet jogosult egy biztonsági másolatot készíteni a szoftverről, ha az a felhasználáshoz szükséges. A Felhasználó Szervezet a Szoftvert és a Szoftver dokumentációját csak a Szoftvert felhasználó alkalmazottai (illetve a Felhasználó Szervezettel munkavégzésre irányuló egyéb jogviszonyban álló személyek) részére teheti hozzáférhetővé. A Felhasználó Szervezet késedelem nélkül nyilatkozik az IRF Szoftverház minden olyan kérdésére, amely az engedélyezettől eltérő esetleges szoftverhasználatra vonatkozik. AZ IRF SZOFTVERHÁZ SZELLEMI ALKOTÁSÁHOZ FŰZŐDŐ JOGAI

Az IRF Szoftverház Kft. szerzője, fejlesztője és kizárólagos tulajdonosa a Szoftvernek. A Felhasználó Szervezet elismeri, hogy a Szoftver és az ahhoz fűződő jogok – így a szellemi alkotásokhoz fűződő jogok, a Szoftver továbbfejlesztési, módosítási, forgalmazási és szerzői továbbá a Szoftverhez fűződő vagyoni jogainak – kizárólagos tulajdonosa és jogosultja az IRF Szoftverház. A Felhasználó Szervezet nem jogosult a Szoftvert módosítani, megbontani, szétszedni, elemeiből mást felépíteni vagy egyéb hasonló módon vizsgálat alá vetni. A Felek a Szjt. 59.§ (1),(3) és 60.§-ai alkalmazását kizárják. A Felhasználó Szervezet tartózkodik minden, az IRF Szoftverháznak a Szoftverhez fűződő jogát sértő cselekménytől, és semmilyen módon nem teszi lehetővé, hogy bármely harmadik személy másolja, használja a Szoftvert, vagy ahhoz hozzáférjen. A jelen Szerződésben nem szabályozott kérdésekben a szerzői jogvédelem alá eső szellemi termékekre vonatkozó jogszabályok rendelkezései az irányadóak. MULTISIGNO

A Digitális Aláírás a MultiSigno termék használatával történik. A termék a Kopint-Datorg fejlesztése. Ehhez kapcsolódó minden szerzői jog a Kopint-Datorg Rt.-t illeti. Termékinformáció: www.kopint-datorg.hu/multisigno.


27


FELELŐSSÉGKORLÁTOZÁS

Az IRF Szoftverház a Szoftver használatából, hibás működéséből, illetve üzemképtelenségéből származó mindennemű felelősségét kizárja, így jelen Szerződés elfogadásával a Felhasználó Szervezet közvetlen vagy közvetett kártérítési igényéről lemond. A SZERZŐDÉS ELUTASÍTÁSA

Amennyiben Ön – Felhasználó Szervezet részéről – a jelen Szerződés feltételeit nem fogadja el, úgy a Szoftvert nem telepítheti, nem másolhatja, nem használhatja, annak telepítő készletét köteles visszajuttatni az IRF Szoftverház részére. A SZERZŐDÉS ELFOGADÁSA

A Szoftver telepítésével Ön a jelen Szerződés minden pontját felelősen a Felhasználó Szervezet részéről elfogadja.

28



NAPLÓÁLLOMÁNY ÉRTELMEZÉSE Adatszolgáltatás fogadása: Napló bejegyzés Client IP: A küldő IP címe Client HTTPMethod: A küldő alkalmazás protokollja Client Host: A küldő host IP címe Client Agent: Keretformátum Client URL: A küldőnél beállított cím, ahová küld. Célszerűen a pénztár szervere, amin a webszervíz fut. Client browser: A küldő böngészőjének típusa Client SSL: Titkosítási információ, HTTPS az alkalmazott protokoll vagy nem Client RequestType: A küldő funkciókérése CONF: Beérkező fájlok elérési útja: Az alkönyvtár, ahová a fogadó alkalmazás a beérkezett csomagokat elmenti CONF: Pénztár azonosító: A pénztár azonosítója

CONF: Legnagyobb fogadható fájl mérete: Fogadási méretlimit beállítás CONF: A beérkezett fájlok alkönyvtárának maximális mérete: a maximált könyvtárméret KONFIGURÁCIÓS BEÁLLÍTÁSOK: PtAzon: Pénztár azonosító

MaxFileSize: Fogadási méretlimit beállítás


Magyarázat

Alapbeállításként https, mivel csak ez engedélyezett

A PSZÁF által adott pénztár azonosítók. Minden pénztár rendelkezik egy ilyen négy karakterből álló azonosítóval, pl. 0001

A PSZÁF által adott pénztár azonosítók. Minden pénztár rendelkezik egy ilyen négy karakterből álló azonosítóval, pl. 0001 Megadható a feltölthető (fogadható) adatszolgáltatás fájlok maximális mérete 29


MaxDirSize: a maximált könyvtárméret

MDBPath: a bejelentkezettségi adatbázis elérési útvonala DataPath: az adatkönyvtár elérési útvonala LogPath: a logfile-ok elérési útvonala SaveAllFiles: a TEMP alkönyvtárban az átmeneti állományok elkészüljenek-e vagy sem. Ennek a beállításnak 1 értékűnek kell lennie. SaveAllMessages: A nyugtába belekerüljön-e minden üzenet, vagy csak a hibaüzenetek.

CertificateIndex: a store-ban lévő tanúsítványok közül az aktív aláíró tanúsítvány kiválasztása

Megadható a feltöltött fájlokat tartalmazó könyvtár, azaz a feltöltött fájlok együttes, maximális mérete. Megadható, hol keresse az alkalmazás a bejelentkezettségi adatokat tároló adatbázist Megadható, holvá kerüljenek a feltöltött adatszolgáltatások Megadható, hová kerüljenek a naplóállományok

Alapbeállítás: 1, azaz készüljenek el az átmeneti állományok Alapbeállítás: nem kerül be minden üzenet a nyugtába, csak a hibák, az információk nem. A tanúsítványtárolóban több tanúsítvány is lehet, ezek közül kell kiválasztani melyik legyen az aktív, aláíró tanúsítvány.

SignaturePolicyOID: Az aláírási szabályzat objektumazonosítója SignaturePolicyDescription: az elvárt aláírási szabályzat neve

1.3.6.1.4.1.16261.3.2.1.2.3 A Penzugyi Szervezetek Allami Felugyeletenek Alairasi Szabalyzata SignaturePolicyUrl: az URL, ahonnan letölthe- http://www.kopinttő az aláírási szabályzat datorg.hu/multisigno/signaturep olicy/pszaf/pszaf_sigpol.pdf SignaturePolicyHash: az elvárt hash érték 86EF0E8E4866D4D7C030646 E5A528B8F5FD4F936 Owner: Az aláíró (cég)neve Az aláíró (adatszolgáltató) cég neve ProductionCity: az aláírás helyszíne (város) Az aláíró címéből a város ProductionProvince: az aláírás helyszíne (megye) Az aláíró címéből a megye ProductionPostalCode: az aláírás helyszíne Az aláíró címéből az irányító(irányítószám) szám 30



ProductionCountry: az aláírás helyszíne (ország) TimeSlot: Az időpecsét és a rendszeróra közötti különbség

Az aláíró címéből az ország A megengedett legnagyobb eltérés beállítható, az alapértelmezett érték 300 másodperc, azaz 5 perc. A beállítás a „beállítások” menüpontban változtatható meg (vagy a webconfig fájlban). SecureSocketLayer: SSL beállítás Alapbeállításként https, mivel csak ez engedélyezett WEBSERVICE: SOAP package mentése A beérkezett SOAP csomag az (útvonal): A beérkezett package elérési útvo- itt megadott útvonalon, a megnala és fájlneve adott könyvtárban kerül elmentésre CONF: A bejelentkezettségi adatokat tartalmazó adatbázis elérési útvonala: (útvonal): a A bejelentkezettségi adatokat tároló adatbázis elérési útvonabejelentkezettségi adatok adatbázisának la elérési útvonala Webservice: Eredeti adatszolgáltatás csomag Az adatszolgáltatás ezen a mentése fájlba: ( fájlnév) : Ezen a néven kerül néven kerül(t) elmentésre a megadott útvonalon elmentésre az adatszolgáltatás SaveFile: Fájl: (útvonal\fájlnév): Jelzi, hogy az Az elkészült átmeneti állomány átmeneti fájl elkészült a megadott útvonalon elérési útvonala és nevének kijelzése és néven Nyugtacsomag létrehozása: A következő üzenetek a nyugtacsomag létrehozásának indítását jelzik: RESPONSE: Nyugtacsomag létrehozása RESPONSE: XML Start CONF: Pénztár azonosító: a pénztár azonosítója MESSAGE: Pénztárnév: A pénztár neve MESSAGE: A feltöltés sikeres volt vagy pedig a feltöltés sikertelen volt A további sorok a rendszer működését jelzik RESPONSE: Messages Start RESPONSE: Messages End RESPONSE: Timestamp IRF Szoftverház Kft.

31


RESPONSE: Signatures Start RESPONSE: Signatures End RESPONSE: XML End A nyugta mentési beállításait jelzik a következő sorok SAVERESP: Nyugta mentése SAVEFILE: Fájl (fájlnév) A nyugta aláírása: Napló bejegyzés SIGNRESP: A nyugta aláírása (útvonal \ fájlnév): a fájl útvonala és neve, amire az aláírás kerül CONF: Aláíró tanúsítvány azonosító: az aláíráshoz használt tanúsítvány azonosítója CONF: SignaturePolicyOID: Az aláírási szabályzat objektumazonosítója CONF: SignaturePolicyDescription: az elvárt aláírási szabályzat neve CONF: SignaturePolicyUrl: az URL, ahonnan letölthető az aláírási szabályzat CONF: SignaturePolicyHash: az elvárt hash érték CONF: Owner: Az aláíró (cég)neve CONF: ProductionCity: az aláírás helyszíne (város) CONF: ProductionProvince: az aláírás helyszíne (megye) CONF: ProductionPostalCode: az aláírás helyszíne (irányítószám) CONF: ProductionCountry: az aláírás helyszíne (ország) CONF: Beérkező fájlok elérési útja: az alkönyvtár, ahová a beérkező fájlok kerülnek

**** ALÁÍRÁS START **** Rendben A nyugta aláírása közben a Cpax.Sign vagy Cpax.SignToStream eljárás sikeresen lefutott

32

Hiba A nyugta aláírása közben a Cpax.Sign vagy Cpax.SignToStream eljárás hibába ütközött

Magyarázat Az ellenőrző alkalmazás hibaüzenete. Ilyen hibajelzést kapunk pl. ha a futtató felhasználónak nincs jogosultsága hozzáférni a tanúsítIRF Szoftverház Kft.


Az aláírás megtörtént

sikeresen

Az aláírás nem sikerült

ványtárolóhoz, vagy sérült a hardver, a tanúsítvány tároló, az operációs rendszer, vagy bármely ok miatt az ellenőrzés pillanatában az alkalmazás nem tudta elérni a tanúsítvány információkat. Ebben az esetben a futtató felhasználónak meg kell adni a megfelelő jogosultságokat, ellenőrizni kell a hardvert és az operációs rendszert. Ha az előző okok miatt nem sikerült elkészíteni az aláírást, ezt az összesítő üzenetet kapjuk..

SIGNERESP: errorflag: az aláírás hibajelzése. Értéke True és False lehet SIGNERESP: aláírás Kész A nyugtacsomag ellenőrzése következik. Itt ugyanazon lépések hajtódnak végre, mint az adatszolgáltatás ellenőrzésekor: SIGNERESP: Nyugtacsomag ellenőrzése A meghajtó \ útvonal | állománynév fájl tulajdonságai: Adatküldő: a nyugdíjpénztár (pénztárszolgáltató) neve Adatlétrehozás időpontja: a nyugta állomány létrehozásának időpontja A csomagban található objektumok száma: ennek 1-nek kell lennie Csatolt adatszolgáltatás fájl neve: az eredeti dokumentum fájlneve Csatolt adatszolgáltatás fájl dátuma: a létrehozás dátuma Csatolt adatszolgáltatás fájl mérete(byte-ban): az eredeti dokumentum mérete


33


Hibátlan esetben 1 dokumentumnak és 5 megjegyzés objektumnak kell lennie a csomagban. Az objektumok vizsgálata során a következő üzenetek lehetségesek:

Hiba esetén Magyarázat Hibátlan kibontás esetén A csomagban 1 darabNem egy darab dokumen- Az XML csomagnak 1 tum objektum található a dokumentum objektumot dokumentum van. csomagban kell tartalmaznia. Ettől eltérő számú dokumentum nem lehet benne A csomagban 5 darabNem 5 darab megjegyzés Az XML csomagnak 5 megjegyzés objektum van. objektum található a megjegyzés objektumot csomagban kell tartalmaznia. Ettől eltérő számú megjegyzés objektum nem lehet benne Az aláírt csomag csakAz aláírt XML csomag Az XML csomagnak 1 dokumentum és megjegy-nem csak dokumentum dokumentum és 5 megzés objektumokat tartal-és megjegyzés objektu- jegyzés objektumot kell maz mokat tartalmaz tartalmaznia. Ettől eltérő objektumtípus nem lehet benne.

Napló bejegyzés Az elvárt SignaturePolicyOID: az elvárt aláírási szabályzat objektumazonosító Az elvárt SignaturePolicyDescription: az elvárt aláírási szabályzat neve Az elvárt SignaturePolicyUrl: az URL, ahonnan letölthető az aláírási szabályzat Az elvárt SignaturePolicyHash: az elvárt hash érték A csomagban található aláírások száma X ahol X az aláírások száma Az 1. aláírás tulajdonságai: -SignatureID: az aláírás azonosítója -ProductionCity: az aláírás helyszíne (város) -ProductionProvince: az aláírás helyszíne (megye) -ProductionPostalCode: az aláírás helyszíne (irányítószám) 34



-ProductionCountry: az aláírás helyszíne (ország) -CommitmentType: az aláírással kapcsolatos nyilatkozat -SignaturePolicyOID: az elvárt aláírási szabályzat objektumazonosító - SignaturePolicyDescription: az elvárt aláírási szabályzat neve -SignaturePolicyUrl: az URL, ahonnan letölthető az aláírási szabályzat - SignaturePolicyHash: az elvárt hash érték -SignerName: Az aláíró neve -SigningTime: Az aláírás időpontja -TSTATime: Az időbélyegző időpontja -SignerCert: maga az aláírói tanúsítvány, base64 kódolva -TSACert: az időbélyező tanúsítványa, base64 kódolva -SignatureValue: az aláírás érték base64 kódolva Csomag típus: nyugta. Ellenőrzés típus: passzív SignatureStatus: egy 16 karakterből álló bináris flag, melyben az egyes karakterek jelentését lásd az adatszolgáltatás ellenőrzésénél ChainStatus: egy 16 karakterből álló bináris flag, melyben az egyes karakterek jelentését lásd az adatszolgáltatás ellenőrzésénél TimeStatus: egy 16 karakterből álló bináris flag, melyben az egyes karakterek jelentését lásd az adatszolgáltatás ellenőrzésénél A nyugtacsomag ellenőrzésének eredményei: Rendben A nyugtacsomag rendben


Hiba A nyugtacsomag aláírásakor hiba adódott. A hiba helye és kódja:

Magyarázat A hiba helye: ide az ellenőrzési pont sorszáma kerül. A hibakódok a következők: 1. Nincs hiba, a függvény sikeresen lefutott. 2. Hibás XML handle. 3. Hiba a fájl betöltésénél, megnyitásánál. 4. Hiba a fájl mentésénél, írásra való megnyitásánál. 5. Nincs tartalom vagy találat. 6. Tanúsítványtárral kapcsolatos hiba. 35


7. Hiányzik egy szükséges XML node, valószínűleg sérült a csomag. 8. Általában a csomag alap <Pack> node-ját hiányolja. 9. Egy szükséges/keresett tanúsítvány nem található. 10. Hibás (vagy már létező) azonosító. 11. Hiba a tanúsítvány olvasásánál / értelmezésénél. 12. Hibás a megadott / talált tanúsítványok importálása / értelmezése. 13. Hibás a csomag XML struktúrája. 14. Memória olvasási hiba egy belső művelet során. 15. A műveletet, vagy a művelet ennyiszer történő végrehajtását a DLL típusa vagy verziója "nem támogatja. 16. A DLL típusa vagy verziója ezt a függvényt nem támogatja. 17. Az aláírásra / kódolásra / dekódolásra átadott adat értelmezhetetlen vagy ismeretlen típusú. 18. A DLL nem tudja kezelni a csomag verzióját (nem támogatott régi vagy a kiadás óta megjelent új verzió). 19. Általában azt jelenti, hogy nem tudott egy belső munkaváltozó számára memóriát foglalni. 20. Az átadott XML handle 36



nem tartozik XML objektumhoz, vagy hibás. 21. Valamelyik kimenő paraméter túl rövid, ezért nem fért bele a kívánt adat. 22. A titkosított adatot nem tudta dekódolni. 23. Az adatot nem tudta titkosítani. 24. A függvény paraméterezése hibás. 25. Nincs ilyen store, vagy a felhasználónak nincsen megfelelő jogosultsága a store művelet végrehajtásához. 26. Nem sikerült felépíteni a tanúsítványláncot a Root CA-ig, vagy hibás. 27. Nem sikerült az LDAP szerverhez, az időbélyegszolgáltatóhoz, vagy a visszavonási-információ szolgáltatáshoz kapcsolódni. 28. A függvény hiba nélkül lefutott, de nem adott vissza egy eredményt, amit vártunk volna. 29. Az aláírással probléma van. (A létrehozás során hiba adódott, nem sikerült ellenőrizni, stb.) 30. Nem sikerült jeleznünk az OS felé, hogy szeretnénk COM-ot használni. 31. Nem várt kivétel történt. 32. A tanúsítvány nem minősített, vagy a tanúsítványláncban nem minősített tanúsítványt található. IRF Szoftverház Kft.

37


33. Thread hiba. A konténer objektum létrehozása és a nyugta elküldése következik, az alábbi sorok a folyamat előrehaladtáról tájékoztatnak: CONTAINER: létrehozás kezdete CONTAINER: adatszolgáltatás beágyazása CONTAINER: adatszolgáltatás base64 encoding CONTAINER: nyugta beágyazása CONTAINER: nyugta base64 encoding CONTAINER: konténer Kész WEBSERVICE: Kontroll konténer mentése: (útvonal\fájlnév) SAVEFILE: Fájl létrehozása (útvonal|fájlnév) WEBSERVICE: Nyugta küldése, futás vége.

38



JEGYZETEK:


39

Ingrid Signo Webservice telepítési és üzemeltetési kézikönyv

Recommend Documents