wiki.groszek.pl

Konfiguracja IIS: Różnice pomiędzy wersjami

← poprzednia edycja
Michalp (dyskusja | edycje)
restricted
6814 edycji
 
(Nie pokazano 117 wersji utworzonych przez 4 użytkowników)
Linia 1: Linia 1:
Dokument zawiera opis konfiguracji serwera usug internetowych - [https://www.iis.net/|Internet Information Services (IIS)]. Z IIS korzystamy w celu uruchomienia usługi ePodatki.
Dokument zawiera opis konfiguracji serwera usług internetowych - [https://www.iis.net/ Internet Information Services (IIS)]. Z IIS korzystamy m.in. w celu uruchomienia aplikacji [[:Kategoria:eAdmin|eAdmin]], [[:Kategoria:eWizja|eWizja]] oraz [[:Kategoria:ePodatki|ePodatki]].


{{Uwaga}}
{{Uwaga}}
:Zrzuty okien systemu Windows i adresy ścieżki umieszczamy z wersji Windows 10.   
:*Zrzuty okien i adresy ścieżki przygotowano na podstawie systemu Windows 10,
:*Filmy prezentujące konfigurowanie IIS znajdziemy na portalu [https://www.youtube.com/results?search_query=configuring+iis YouTube].   


==Wymagania==
==Instalacja IIS==
* Komputer z systemem Windows,
Przechodzimy do okna ''Programy i funkcje'' poprzez wciśnięcie kombinacji klawiszy ''Windows + R'', w wyświetlonym oknie wpisujemy ''appwiz.cpl'' i zatwierdzamy klikając ''OK'' lub wciskając ''Enter''.  
* Konto z uprawnieniami administratora (lub przynależność konta do grupy administratorów) w systemie operacyjnym, na którym będziemy uruchamiać IIS,
* Zakupiony program ePodatki,
* Stały adres IP od ISP.


==Przygotowanie==
[[Plik:Konfiguracja IIS winr.png]]
* Pobranie ze strony [https://groszek.pl groszek.pl] stabilnej wersji programów:
** ''epodatkiui'' (ePodatki UI [Usługa Internetowa]),
** ''epodatkiro'' (ePodatki RO [Rejestr Osób]),
** ''admin''.
* Pobranie serwera bazy danych Firebird w wersji 2.5 (stan wersji aktualny na: {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}}) dla wersji systemu Windows na jakiej to będzie uruchomiony IIS.


==Wstępna konfiguracja==
W oknie ''Programy i funkcje'' wybieramy opcję ''Włącz lub wyłącz funkcje systemu Windows''.
*Instalujemy serwer bazy danych Firebird na maszynie, na której będzie włączony serwer IIS. W sytuacji problemów z serwerem bazy, zalecamy zapoznać się z instrukcją: [[Firebird zarządzanie]],
*Paczkę z programem ''epodatkiui'' rozpakowujemy i zalecamy umieścić na dysku C: w głównym korzeniu katalogu.


==IIS==
[[Plik:Konfiguracja IIS programy i funkcje.png]]
===Włączenie===
Uruchamiamy: ''Panel Sterowania'' (naciskamy WIN, wpisujemy ''panel sterowania'', wybieramy i uruchamiamy) > ''Programy i funkcja'' > ''Włącz lub wyłącz funkcje systemu Windows''. Zaznaczamy checkboxy, jak na poniższym zrzucie ekranu.


[[File: windows_wycinek_wlacz_lub_wylacz_funkcje_windows_iis.png|400px]]
Odnajdujemy na liście ''Internetowe usługi informacyjne'' i zaznaczamy zgodnie z poniższymi zrzutami ekranu, a następnie zatwierdzamy klikając na przycisk ''OK''.
<gallery>
Plik:Konfiguracja IIS Funkcje systemu Windows 1.png
Plik:Konfiguracja IIS Funkcje systemu Windows 2.png
</gallery>


===Status===
Po kilku chwilach usługa powinna zostać pomyślnie zainstalowana, co system Windows potwierdzi wyświetlając stosowny komunikat.
Po zastosowaniu zmian, usługa IIS powinna zostać domyślnie włączona. Status sprawdzimy wpisując naciskając kombinację WIN+r przez co na przystawce zostanie wyświetlona lista usług. Usługa, której szukamy nazywa się: ''Usługa publikowania w sieci WWW''. Powinna działać, wycinek poniżej.


[[File: windows_wycinek_uslug_stan_www.png|600px]]
[[Plik:Konfiguracja IIS koniec.png]]


===Przystawka inetmgr===
===Status usługi===
Naciskamy WIN+r i wpisujemy: ''inetmgr''. Wyświetlona przystawka, jest oknem zarządzania IIS.
Po zastosowaniu zmian, usługa IIS powinna zostać automatycznie uruchomiona. Status usługi sprawdzimy naciskając kombinację klawiszy ''Windows + R'', w wyświetlonym oknie wpisujemy ''services.msc'' i zatwierdzamy klikając ''OK'' lub wciskając ''Enter''. Uruchomione zostanie okno ''Usługi'', na liście szukamy pozycji ''Usługa publikowania w sieci WWW''. Powinna działać, wycinek poniżej.


[[File: windows_okno_inetmgr.png|600px]]
[[Plik:Konfiguracja IIS status.png]]
 
==Menedżer internetowych usług informacyjnych (IIS)==
Naciskając kombinację klawiszy ''Windows + R'', w wyświetlonym oknie wpisujemy ''inetmgr'' i zatwierdzamy klikając ''OK'' lub wciskając ''Enter''. Uruchomiony zostanie Menedżer internetowych usług informacyjnych, czyli okno służące do zarządzania usługą IIS.
 
[[Plik:Konfiguracja IIS Menedżer.png|600px]]


===Dodawanie nowej witryny===
===Dodawanie nowej witryny===
# Klikamy ppm na ''Witryny'', wybieramy z menu kontekstowego ''Dodaj witryne wieci Web...''
[[Plik:Konfiguracja IIS Dodawanie witryny.png|thumb|Menedżer internetowych usług informacyjnych > Dodaj witrynę sieci Web]]
## Nazwa witryny: uzupełniamy dowolną nazwą. Można korzystać z naszej wewnętrznej nazwy: ServInfoSysAP,
W celu utworzenia nowej witryny w IIS przechodzimy do [[Konfiguracja IIS#Menedżer internetowych usług informacyjnych (IIS)|Menedżera internetowych usług informacyjnych (IIS)]] > w sekcji ''Połączenia'' (lewa strona) klikamy PPM > wybieramy ''Dodaj witrynę sieci Web''.
## Ścieżka fizyczna: podajemy lokalizację do pliku ''ServInfoSysAP.exe'', który zgodnie z zaleceniami powinien znajdować się katalogu w głównej gałęzi na dysku C,
 
## port: ustawiamy dowolny port wedle naszych potrzeb.
<gallery>
[[File: windows_okno_iis_dodawanie_nowej_witryny.png]]
Plik:Konfiguracja IIS Dodawanie witryny WebAdmin.png|thumb|Dodawanie witryny sieci Web
Plik:Iis pula aplikacji.png|thumb|Wybór puli aplikacji
</gallery>
Wykonujemy kolejno kroki:
#Pole ''Nazwa witryny'' uzupełniamy dowolną nazwą, np. INFO-SYSTEM.  
#Pula aplikacja - wybieramy pulę aplikacji, która ma wersję środowiska '''''.Net CLR: 4.0''''' oraz ''Tryb potokowy: '''Zintegrowany'''''. Możemy utworzyć pulę aplikacji o takich parametrach i nazwać ją ''INFO-SYSTEM''.
#''Ścieżka fizyczna'' to lokalizacja folderu wspólnego, w którym będą znajdowały się aplikacje INFO-SYSTEM.
#Wybieramy typ połączenia HTTP lub HTTPS (jeśli aplikacja ma być dostępna poza siecią lokalną zalecamy wybór protokołu HTTPS, aby dowiedzieć się więcej klikamy [[Konfiguracja_IIS#HTTPS/SSL|tutaj]]).
#Zatwierdzamy klikając na przycisk ''OK''.
 
===HTTPS/SSL===
{{Uwaga}} Jeśli chcemy, aby nasza aplikacja była dostępna poza siecią lokalną zalecamy stosowanie protokołu SSL.  
 
[[Plik:IIS Konfiguracja SSL.PNG|thumb|Dodawanie certyfikatów serwera]]
 
====Certyfikaty serwera====
W [[Konfiguracja IIS#Menedżer internetowych usług informacyjnych (IIS)|''Menedżerze internetowych usług informacyjnych'']] znajdujemy i wchodzimy w opcję ''Certyfikaty serwera''. Z prawej strony okna, w sekcji ''Akcje'' dostępne są opcje importowania oraz tworzenia certyfikatów.


===Ogranicznie ISAPI i CGI===
====Dodawanie witryny====
Klikamy przycisk ''Dodaj'' i dodajemy ścieżkę do pliku wykonywalnego dla naszej witryny.
Podczas dodawania nowej witryny typ połączenia ustawiamy jako HTTPS, a następnie wybieramy wcześniej dodany certyfikat SSL i zatwierdzamy klikając na przycisk ''OK''.


[[File:windows_iis_ograniczenia_uprawnienie_cgi_dll.png|400px]]
[[Plik:Konfiguracja iis dodawanie witryny certyfikat ssl.png]]


{{Uwaga}}
====Ustawienia protokołu SSL====
:''ePodatkiUI'' może być wykonywana przez serwer IIS jako plik ''exe'' (obsługuje wolno żądania) lub jako biblioteka ładowana dynamicznie ''dll'' (obsługuje więcej żądań i szybciej).
W [[Konfiguracja IIS#Menedżer internetowych usług informacyjnych (IIS)|''Menedżerze internetowych usług informacyjnych'']] wybieramy wcześniej utworzoną witrynę, wchodzimy w pozycję ''Ustawienia protokołu SSL'', a następnie zaznaczamy opcję ''Wymagaj protokołu SSL'' oraz wybieramy ''Ignoruj''. Dzięki takiemu ustawieniu dostęp do naszej aplikacji będzie możliwy tylko i wyłącznie poprzez protokół SSL.
: W celu obsługi jako dll, wybieramy plik ''ServInfoSysISAPI.dll'' z podkatalogu ''isapi''.
 
{{Uwaga}} Jeśli nasz certyfikat SSL nie został wystawiony przez zaufanego wystawce niezbędne będzie dodanie w przeglądarce wyjątku aby uruchomić aplikację.
 
[[Plik:Konfiguracja iis ustawienia protokolu ssl.png|ramka|brak|Ustawienia protokołu SSL]]
 
==Usługa sieciowa Finn==
===Wymagane biblioteki===
Do działania aplikacji niezbędne jest doinstalowanie bibliotek umożliwiających uruchamianie w systemie Windows aplikacji stworzonych przy pomocy narzędzi programistycznych firmy Microsoft:
*'''.NET Framework w wersji 4.6.2''' lub wyższej ([https://www.microsoft.com/net/download/dotnet-framework-runtime do pobrania ze strony Microsoft]),
*'''Microsoft Visual C++ 2017 Redistributable''' w [https://aka.ms/vs/15/release/vc_redist.x86.exe wersji x86] (wersja x86 i x64 mogą być zainstalowane równolegle).
 
===Usługi WCF===
Do poprawnego działania usługi wymagane jest aktywowanie dodatkowej funkcji systemu Windows: ''.NET Framework 4.x > Usługi WCF > Aktywacja HTTP''.
 
[[Plik:IIS Uslugi WCF Aktywacja HTTP.png|brak|ramka|.NET Framework 4.x > Usługi WCF > Aktywacja HTTP]]
 
===Dodawanie nowej witryny do IIS===
#Wypakowujemy pliki usługi sieciowej do wybranej lokalizacji, np. ''C:\inetpub\FinnServiceClient'' (ścieżka domyślna witryn IIS to ''C:\inetpub\<katalog_aplikacji>'').
#Dodajemy nową witrynę w IIS:
##Uruchamiamy [[Konfiguracja IIS#Menedżer internetowych usług informacyjnych (IIS)|Menedżer internetowych usług informacyjnych (IIS)]] > w sekcji ''Połączenia'' (lewa strona) klikamy PPM > wybieramy ''Dodaj witrynę sieci Web''.[[Plik:Konfiguracja IIS Dodawanie witryny.png|brak|ramka|Menedżer internetowych usług informacyjnych > Dodaj witrynę sieci Web]]
##Pole ''Nazwa witryny'' uzupełniamy dowolną nazwą, np. ''FinnServiceClient''. ''Ścieżka fizyczna'' to lokalizacja folderu, do którego wypakowaliśmy pliki usługi sieciowej ''FinnServiceClient''.[[Plik:IIS FinnServiceClient.png|brak|ramka|Dodawanie witryny sieci Web]]
##W sekcji ''Powiązanie'' typ połączenia zmieniamy na ''https'', ''Port'' ustawiamy na 44316, a następnie wybieramy nasz ''Certyfikat SSL''.
##Zatwierdzamy klikając na przycisk ''OK''.
====Powiązania / Porty====
Aby usługa działała musimy prawidłowo ustawić numery portów powiązanych z usługą w IIS.
 
[[Plik:IIS FinnServiceClient porty.png|brak|ramka|Porty zdefiniowane w pliku Web.config]]
 
We wcześniejszym kroku ustawiliśmy już port ''44316'' dla ''https'', pozostało nam ustawić port ''55852'' dla protokołu ''http''. W tym celu w [[Konfiguracja IIS#Menedżer internetowych usług informacyjnych (IIS)|''Menedżerze internetowych usług informacyjnych'']] wchodzimy w dodaną witrynę. Z prawej strony okna, w sekcji ''Akcje'' klikamy na opcje ''Powiązania''. Dodajemy tam nowe powiązanie, w którym ''Typ'' to ''http'', a ''Port'' to ''55852''.
 
[[Plik:IIS FinnServiceClient powiazania.png|brak|ramka|Witryna FinnServiceClient > Powiązania]]
 
===Web.config - parametry===
Edytując plik ''Web.config'' ustawiamy parametry usługi sieciowej.
 
====connectionStrings====
W sekcji ''connectionStrings'' podajemy ścieżkę bazy danych oraz nazwę użytkownika i hasło dostępu. Możemy również aktywować zapisywanie logów.
<syntaxhighlight lang="xml">
<connectionStrings>
<add name="FbConnection" connectionString="User=SYSDBA;Password=masterkey;Database=D:\Baza_danych\is_pdk.GDB;DataSource=localhost;Port=3050;Dialect=3;Charset=NONE;Role=;Connection lifetime=15;Pooling=true;MinPoolSize=0;MaxPoolSize=50;Packet Size=8192;ServerType=0;" providerName="FirebirdSql.Data.FirebirdClient" />
<add name="FbSecure" connectionString="true" />
<add name="LogFile" connectionString="C:\inetpub\FinnSoapService\log\Log.txt" />
<add name="Log" connectionString="true" />
</connectionStrings>
</syntaxhighlight>
{{Uwaga}} Zapisywanie logów w pliku Log.txt wymaga nadanie uprawnień do zapisu dla folderu ''log'' dla użytkownika ''IIS_WPG''.


===Uprawnienia do katalogu===
====Rozmiar przesyłanych plików====
Katalog z aplikacją ePodatiUI powinien posiadać dodane odpowiednie uprawnienia. Klikamy ppm na katalogu, następnie zakładka ''Zabezpieczenia'', klikamy ''Dodaj'':
Sekcja ''bindings'' określa maksymalny rozmiar pliku, który może zostać przesłany.
* Klikamy ''Typy obiektów'', zaznaczamy ''Konta usług'', i ''OK'',
<syntaxhighlight lang="xml">
* Wprowadzamy nazwę  ''IIS_WPG'' w pole ''Wprowadź nazwy obiektów do wybrania i dodajemy'', szukamy i dodajemy.
<bindings>
[[File: windows_okno_uprawnienia_katalogu_iis.png|400px]]
<basicHttpBinding>
* Dodajemy użytkownika ''IIS_WPG'',
<binding maxReceivedMessageSize="300485760">
* W/w użytkownikowi ustawiamy ''Modyfikacja'' na ''Zezwalaj''.
</binding>
</basicHttpBinding>
<basicHttpsBinding>
<binding maxReceivedMessageSize="300485760">
</binding>
</basicHttpsBinding>
</bindings>
</syntaxhighlight>


==Ustawienia po stronie ePodatków==
===Status usługi sieciowej===
* W pliku ''ServInfoSys.xml'' podajemy ścieżkę do bazy danych,
Status usługi sieciowej możemy sprawdzić wchodząc na stronę https://localhost:44316/BrokerWebService.svc, jeśli wyświetli się strona jak na obrazku poniżej oznacza to, że usługa działa prawidłowo.
* W programie ''ePodatki Rejestr Osób'' podajemy w pliku ''RejestrOsb.xml'' ścieżkę do bazy danych z której usługa ePodatki będzie pobierała dane (tą ścieżkę, którą podaliśmy w punkcie poprzednim). Jest to istotne, ponieważ ''ePodatki Rejestr Osób'' zawiera skrypty spt, które są koniecznie do wykonania na bazie danych w celu poprawnego działania usługi,
*Programem ''Admin'' dla osób, które będę korzystały z programu ''ePodatki Rejestr Osób'' i zajmowały się potwierdzaniem tożsamości użytkowników, dodajemy uprawnienie ''admin44'',
* Przechodzimy do katalogu z ePodatkami (zalecana ścieżka: C:\ePodatki) i uruchamiamy program serwisowy ''ServInfoSysCfg.exe''. Wybieramy klucz ''RSA'', kodowanie ''PEM'' genereujemy i zapisujemy. W drugiej zakładce tego programu ustawiamy parametry serwera poczty dla osób, które chcę odzyskać hasło.


{{Uwaga}}
[[Plik:FinnWebService Usługa.png|brak|thumb|Działająca usługa FinnServiceClient]]
:Katalog zawiera plik wykonywalny do sprawdzenia połączenia się z usługą.


===Konfiguracja po stronie Podatków===
Pozostaje skonfigurować EOB w aplikacji ''Podatki'', opis znajduje się na stronie [[ViDok konfiguracja obiegu dokumentów#Finn]].


[[Category:ePodatki]]
[[Category:Aneks]]
[[Category:Aneks]]
[[Kategoria:IIS]]
[[Kategoria: Metadane produkty]]
Źródło: „https://wiki.groszek.pl/index.php/Konfiguracja_IIS”