sERPa súgó

 

Az interneten keresztüli URL megadással történő kommunikáció tipikusan használatos eszköze az IIS - Internet Information Services, amely a Windows server és a Windows kliens operációs rendszereknek egyaránt része.

Ezzel az eszközzel egyrészt sERPa adatbázisok között is van lehetőség adatot átadni másrészt más alkalmazás is adhat adatot ilyen módon adatot sERPa adatbázisnak.

A lenti leírás leginkább azokra vonatkozik, amelyekre a PROGEN készített.

 

Beüzemelési lépések

Az IIS szolgáltatást csak Windows rendszergazdai jogokkal lehet telepíteni és a beállításokat is csak ezekkel a jogokkal lehet megtenni, ezért az alábbiakhoz szükség van a cég rendszergazdájára!

Az interface interneten való megjelenéséhez természetesen a biztonsági beállításokat, engedélyezéseket is meg kell tenni a szerverként használt gépen.

1) IIS telepítés

Indítsuk el a vezérlőpultot és ott válasszuk ki a

Programok és szolgáltatások elemet.

 

 

A megnyíló Programok és szolgáltatások elem bal oldalán kattintsunk a

Windows-szolgáltatások be- és kikapcsolása linkre.

 

Másik módja a Startmenü gomb jobb klikk Futtatás... (Windows+R) és oda be kell írni: optionalfeatures

 

A megjelenő Windows-szolgáltatások ablakban pipáljuk be a következőket:

 

Az OK után elkezdődik a telepítés.

 

Ezt követően elindítható lesz az IIS kezelő konzol:

A Start / Keresés programokban és fájlokban keressünk rá a feltelepült Internet Information Services (IIS) kezelője programra és indítsuk el:

 

Fontos!

1.A gépen a szolgáltatás telepítésekor automatikusan létrejön egy C:\inetpub\ könyvtár.

2.Ebbe a könyvtárba a C:\inetpub\wwwroot\ alkönyvtárba kézzel nem szabad további alkönyvtárakat létrehozni a jogosultsági problémák elkerülése miatt.

3.De a virtual directory létrehozásakor a Fizikai elérési út meghatározásakor létrehozható új mappa és ez automatikusan ide fog létrejönni.

4.A Fizikai elérési út létrehozásakor majd célszerű lesz olyan nevet megadni, ami a használt sERPa adatbázisra utal. (nem kötelező)

 

2) Virtuális könyvtár hozzáadása (Add Virtual Directory)

Ebbe a könyvtárba kell majd bemásolni a használni kívánt kommunikációt leíró a PROGEN által biztosított fájlokat.

 

A bal oldalon a Default Web Site soron jobb kattintás és válasszuk ki a Virtuális könyvtár hozzáadása (Add Virtual Directory) menüpontot.

A megjelenő Virtuális könyvtár hozzáadása (Add Virtual Directory) ablakban meg kell adni az Alias nevet, amely néven lesz elérhető az URL-ben az interface és a Fizikai elérési út-vonalat, ahol ennek az interface-nek fizikailag vannak a kommunikációt leíró fájljai.

 

Ez az Alias lesz a sERPa B2B partner funkciójában megadandó URL cím része! Például az alábbi Virtuális könyvtár létrehozása esetén az URL a következő lesz:

http://www.bence.hu:8080/bence_b2b/SOAP/B2B

ahol:

1.www.bence.hu:8080 - a gép, ahogy az interneten elérhető (amennyiben port is van megadva, mint a fenti képen jobb oldalon lehet látni)

2.bence_b2b - Alias név, amit a virtual directoryban megadtunk

3.SOAP - kötelező megadni logikai szerepe van, fizikailag nincs ilyen könyvtár

4.B2B - szintén csak logikailag kell megadni, fizikailag nincs. Azt jelzi, hogy a B2B partner sERPa funkció használja az interface-t.

Itt az Új mappa létrehozásával hozzuk létre a c:\inetpub\wwwroot\ könyvtárba az új könyvtárat!

3) Fájl másolás

A PROGEN által készített kommunikációs fájlokat ide, a megadott fizikai elérési útra kell másolni. (c:\inetpub\wwwroot\nev)

Ezek a fájlok letölthetőek a Partnerközpontból a telepítőkészlettel együtt, vagy kérésre a tanácsadóink megküldik.

Ld. InstCD\Kiegeszitesek\SOAPService mappa.

 

 

4) ConnString fálj megadása

A Partnerközpontból letölthető SOAPService könyvtár tartalmazza a szükséges fájlokat, amelyből a ConnString.inc.sample-ből kell beüzemeléskor ConnString.inc-t csinálni (A fogadó oldalon található IIS-ben) és ebben kell definiálni a szolgáltató adatbázis adatait és egy SOAPUsert, akinek a nevében történik az adatfelvétel a szolgáltató adatbázisába.

A ConnString.inc-fájlban át kell írni az adatbázis elérési útvonalát.

 

SOAP esetén SQL hitelesítést kell választani, REST esetén Windows hitelesítést.

 

Célszerű felvenni a Windowsba és az SQL szerverbe egy SOAPUser-t, akinek a nevében fog történni az adatbázisba az adatok rögzítése.

A SOAPUser-nek az SQL-ben megfelelő jogosultságra (Public) van szüksége az érintett adatbázisban való íráshoz. Ezt a SOAPUser-t kell majd a ConnString.inc -be beírni:

 

<%

Dim ConnString

'define the connection string, specify database driver

ConnString="Provider=SQLNCLI11;Data Source=SQL kiszolgáló;Initial Catalog=Adatbázisnév;UID=SOAPUser; Password=HasználtErősjelszó1793;"

%>

 

Az SQL-ben meg kell adni ennek a SOAPUser-nek a SOAP service használati jogát (tárolt eljárás futtatási jog) a következő utasítás lefuttatásával az összes olyan sERPa adatbázisban, amelybe adatot fog írni az interface segítségével:

 

GRANT EXECUTE ON Uzenet.SOAPService TO SOAPUser

 

Microsoft SQL Server Management Studio segítségével:

Vonatkozó SQL szerver alatt: Security / Logins könyvtáron Jobb egér kattintás / Properties New login (windows authentikációval windows usert célszerű felvenni)

Bal oldalon a User mapping-ot választva a jobb oldalon pipáljuk be a vonatkozó sERPa adatbázis(oka)t. A Public jog automatikusan megjelenik.

Az itt bepipált adatbázisokon futtassuk le a GRANT EXECUTE ON Uzenet.SOAPService TO SOAPUser-t.

 

Geometria beállítás esetén további néhány táblához szükséges hozzáférést biztosítani ezek a következők:  Főkönyvi szám, Költséghely, Témaszám táblái: GRANT SELECT ON FSzam TO SOAPUser; GRANT SELECT ON TSzam TO SOAPUser;  GRANT SELECT ON Khely TO SOAPUser

 

5) URL Rewrite modul telepítése

Bizonyos verziókban eleve benne van az URL Rewrite modul, amely itt található:

/Ezt biztosan kell telepíteni, ha a config fáljban van rá utaló rész. (rewrite)/

Ha nincs telepítve a modul, akkor le kell tölteni ezt a kiegészítést az IIS-hez: http://www.iis.net/downloads/microsoft/url-rewrite

Az oldal alján vannak nyelvenként felsorolva a letöltések, ahol ki kell választani a nyelv és operációs rendszer szerint szükségeset, pl: English: WebPI / x86 / x64

x64-re kattintva letölthető a rewrite_amd64_en-US.msi amelyet futtatni kell:

 

6) Korlátok tulajdonságainak állítása az ASP tulajdonságaiban

Baloldalon a Default Web Site -on is és az érintett virtuális könyvtáron (virtual directory-n) állva is a jobb oldalon dupla klikkelve az ASP ikonra a "Korlátok tulajdonságai" (Limits Properties) részben a "Kérelem entitástörzsének korlátja" (Maximum Requesting Entity Body Limit) soron az alapértelmezett 200000 -t célszerű megnagyobbítani ennyire: 2147483647. (Ez a létező legnagyobb, ettől kisebb is lehet, de a csomag méreténél nagyobbat kell beállítani.)

 

 

7) Autentikáció beállítása

SOAP esetén: Névtelen hitelesítés (Anonymous)

Bal oldalon a virtual folderen állva a jobb oldalon duplaklikkelve a Hitelesítés (Authentication) ikonra a megjelenő táblázatban a Névtelen hitelesítés (Anonymous Authentication) értéknek Engedélyezettnek (Enabled) kell lennie.  

Ne felejtsük el újraindítani a szolgáltatást, ha változtattunk benne az IIS kezelőjében a jobb oldalon a Műveletek részben.

REST beállítás esetén: Egyszerű hitelesítés (Basic)

ShopRenter-hez való beállítás esetén: Névtelen hitelesítés (Anonymous)

 

 

8) IP címek korlátozása

Amennyiben pl. Shoprenter webshopot állítunk be javasolt lehet az IP címek korlátozása, hogy csak egy adott IP címről jövő adatokkal foglalkozzon a szerver, mert REST-ben beállítandó Egyszerű hitelesítés(Basic)-től eltérően ehhez Névtelen hitelesítés (Anonymous) kell: