Instrukcja administratora > Portal dla pracowników > Uruchomienie modułu WWW

Drukuj

Uruchomienie modułu WWW

Aplikacja internetowa zawarta jest w wersji instalacyjnej programu. Podczas instalacji należy wybrać sposób INSTALACJA SZCZEGÓŁOWA i zaznaczyć komponent Moduł WWW - dostęp pracowników przez internet. Wymagane pliki pojawią się w podkatalogu WWW.

Pliki te można później pobrać i aktualizować ze strony https://pobierzprogram.symfonia.pl - do pobrania wybieramy Moduł WWW - dostęp pracowników przez internet i rozpakowujemy je w podkatalogu WWW (równoległym do podkatalogu BIN).

Zawsze przed aktualizacją modułu WWW należy najpierw zaktualizować sam program R2płatnikPRO.

Aplikacja internetowa z wbudowanym serwerem WWW może pracować w 2 wariantach:

jako program - z podkatalogu WWW uruchamiamy program wR2platnik.exe /GUI

jako usługa - z katalogu WWW rejestrujemy i uruchamiamy usługę wR2platnik.exe /install

(do późniejszego ewentualnego odinstalowania usługi służy parametr /uninstall)

Sam serwer wR2platnik.exe może obsłużyć maksymalnie 20 jednoczesnych sesji (czyli zalogowanych pracowników lub użytkowników). W przypadku większych wymagań należy uruchamiać moduł pośredniczący R2router.exe (zamiast programu wR2platnik.exe). Wtedy ograniczeniem jednoczesnej ilości sesji jest tylko fizyczna pamięć komputera. Moduł pośredniczący może również pracować w 2 wariantach:

jako program - z podkatalogu WWW uruchamiamy program R2router.exe /GUI

jako usługa - z katalogu WWW rejestrujemy i uruchamiamy usługę R2router.exe /install

(do późniejszego ewentualnego odinstalowania usługi służy parametr /uninstall)

W przypadku wykorzystania modułu pośredniczącego R2router.exe nie uruchamiamy samemu (ani nie instalujemy usługi) wR2platnik.exe, gdyż w takim przypadku jest on już wywoływany automatycznie poprzez pośredniczący router.

Po uruchomieniu aplikacji (lub routera) WWW w przeglądarce wpisujemy adres: http://127.0.0.1:80

21801

Jeśli otrzymamy komunikat: Wersja programu nie odpowiada wersji biblioteki API - zaktualizuj program i bibliotekę R2PApi.dll - oznacza to, że uruchomiliśmy nowszą wersję mudułu WWW niż sam program. W takim przypadku należy zaktualizować sam program RPlatnik.exe (patrz Aktualizacja programu), uruchomić go powtórnie i dopiero wtedy powtórnie uruchomić moduł WWW.

W przypadku, gdy na komputerze jest już uruchomiony inny serwer WWW (słuchający na porcie 80), wbudowany serwer można skonfigurować do słuchania na innym porcie. W tym celu w pliku konfiguracyjnym RPlatnik.ini (znajdującym się w równoległym podkatalogu BIN) należy dopisać sekcję [www] z parametrem Port=NowyNumerPortu, przykładowo:

[www]

Port=81

wtedy w przeglądarce należy wpisać adres http://localhost:81 lub http://127:0:0:1:81

Lista parametrów konfiguracyjnych w sekcji [www]:

Serwer

oAppName - nazwa usługi, pod którą rejestrowany jest wR2platnik.exe jako usługa (z parametrem /install), ustawiamy tylko w przypadku kilku fizycznych instalacji modułu WWW na tym samym komputerze, czyli w innych katalogach z dostępem do innych baz danych (standardowo AppName=R2platnikPRO)

Raz ustalonej nazwy nie zmieniamy po rejestracji usługi, gdyż nie będzie jej można ani uruchomić, ani odinstalować.

oPort - port, na którym słucha usługa wR2platnik.exe lub R2router.exe (standardowo Port=80)

oSSLPort - port bezpiecznego połączenia SSL (standardowo 0, czyli niedostępny) (np. SSLPort=443)

oSSLPass - hasło certyfikatu SSL (np. SSLPass=alamakota)

oBoundIP - ograniczenie adresu IP, na którym słucha usługa (standardowo na wszytkich adresach danego komputera) (np. BoundIP=127.0.0.1)

Sesje

oSessionTimeout - czas wygaśnięcia sesji w minutach (standardowo SessionTimeout=10)

oMaxSessions - limit ilości jednocześnie otwartych sesji dla jednego serwera wR2platnik.exe (standardowo MaxSessions=20)

oAllowMultipleSessionsPerUser - zmiana na 1 udostępni możliwość uruchomienia kilku sesji na tym samym komputerze (standardowo AllowMultipleSessionsPerUser=0)

oLog=0 - zmiana na 1 włączy zapisywanie zdarzeń i błędów w sesji w pliku log.txt, (standardowo Log=0)

oLowMemory - zmiana na 1 spowoduje oszczędne gospodarowanie pamięcią operacyjną (standardowo LowMemory=0)

oCachePath - ustawienie niestandardowego katalogu tymczasowego sesji, katalog ten można wtedy wyłączyć z antywirusowego skanowania online (np. CachePath=C:\RESET2\Platnik.10x\WWW\Files)

oAllowMobile - udostępnienie portalu dla pracowników w wersji mobilnej na smartfonie (standardowo AllowMobile=0)

Router

oRouterPortFrom - dolny zakres portów lokalnych routera (standardowo RouterPortFrom=2000)

oRouterPortTo - górny zakres portów lokalnych routera (standardowo RouterPortTo=2050)

Standardowo zmiany wszystkich parametrów konfiguracyjnych dokonujemy przez portal, po zalogowaniu się jako użytkownik o prawach administratora w menu Ustawienia-Środowisko - patrz Środowisko WWW. Plik RPlatnik.ini modyfikujemy tylko w przypadku, gdy portal nie jest jeszcze uruchomiony. Zmiany parametrów konfiguracyjnych wymagają restartu programu lub usługi.

Możliwe jest również wywołanie przy pomocy bezpiecznego połączenia https (https://127.0.0.1:443), lecz wymaga to wcześniejszego przygotowania certyfikatu SSL:

zainstalować certyfikat SSL do magazynu certyfikatów

z magazynu certyfikatów wyeksportować certyfikat w formacie PFX (z kluczem prywatnym i całą ścieżką certyfikacji) (np. certyfikat.pfx)

pobranym z internetu narzędziem OpenSSL przekonwertować certyfikat do formatu PEM (w trakcie nadać hasło do certyfikatu) (np. openssl.exe pkcs12 -aes256 –in certyfikat.pfx –out certyfikat.pem

zawartość pliku PEM rozdzielić w notatniku na 3 pliki:
key.pem - zawartość klucza od
-----BEGIN RSA PRIVATE KEY----- do -----END RSA PRIVATE KEY-----
cert.pem - zawartość certyfikatu od
-----BEGIN CERTIFICATE----- do -----END CERTIFICATE-----
root.pem - zawartość certyfikatów ze ścieżki certyfikacji od kolejnego
-----BEGIN CERTIFICATE----- do ostatniego -----END CERTIFICATE-----

przygotowane pliki key.pem, cert.pem i root.pem wgrać do katalogu usługi WWW

dograć wymagane przy połączeniu SSL biblioteki OpenSSL: libeay32.dll, libssl32.dll, ssleay32.dll

w pliku konfiguracyjnym określić SSLPort i SSLPass

Po uruchomieniu bezpiecznego połączenia https (np. SSLPort=443) zalecane jest wyłączenie połączenia http: Port=0. Uniemożliwi to nawiązanie niezaszyfrowanego połączenia z portalem.