1. Konfiguracja http – przekierowanie
Aby konfiguracja przebiegła poprawnie są dwa rozwiązania, jeśli mamy program zainstalowany na porcie 80(domyślnym):
- przeniesienie programu BI Point na inny port (np. 81), jeśli mamy go zainstalowanego na porcie 80.
- w dalszym etapie konfiguracji utworzenie „site” na innym porcie niż 80 (przy czym w takim rozwiązaniu po zalogowaniu na stronę wymagane jest wpisywanie www.strona.pl:port)
W celu przekierowaniu nowo zainstalowanego BI Pointa na innym porcie można wykorzystać funkcjonalność IIS. W tym celu konieczne jest zainstalowanie dodatku Microsoft Application Request Routing 3.0. Następnie należy skonfigurować plik config.json znajdujący się w katalogu: C:\Program Files (x86)\Comarch\BI Point\instances\Nazwa_instancji\bipoint\config.json
Zgodnie z poniższym zrzutem ekranu:
Zmianę należy także uwzględnić na bazie BI Point w tabeli dbo.settings dla BIPointUrl. W SET_CustomValue należy wprowadzić nazwę witryny zgodną z adresem witryny po którym BI Point będzie hostowany.
W przypadku instancji które korzystają z silnika analitycznego należy również wpisać adres (taki jak w dbo.Settings) w pliku appsetings.json dostępnym w ścieżce: C:\Program Files (x86)\Comarch\BI Point\instances\Nazwa_instancji\engine\appsettings.json
Dla wpisu „ApiUrl”: „”
Kolejnym krokiem jest dodanie witryny na IIS. W tym celu po uruchomieniu – ‘Menadżera internetowych usług informacyjnych’ należy przejść do folderu witryny, a następnie wybrać ‘Dodaj witrynę sieci Web…’
W zależności od adresu na którym chcemy hostować BI Point uzupełniamy nazwę witryny (w opisywanym przypadku BI Point ma być dostępny pod adresem bipoint101.pl) oraz nazwę hosta. Ścieżka fizyczna jest dowolna z zaleceniem, aby podawać ścieżkę fizyczną do pustego katalogu.
Po wprowadzeniu wszystkich parametrów zatwierdzamy przyciskiem ‘OK’.
W kolejnym kroku należy dodać server farm, funkcjonalność jest dostępna po zainstalowaniu dodatku
ARR i restarcie IIS. W celu utworzenia server farm należy zgodnie z poniższym zrzutem ekranu wybrać
opcję – ‘Create Server Farm’.
W polu server Farm Name wpisujemy dowolną nazwę (zalecana nazwa powinna wskazywać jasno do jakiej aplikacji/witryny się odnosi). W advance settings tworzenia server farm należy wskazać port (w polu httpPort) na którym jest obecnie zainstalowany BI Point, który chcemy przekierować. W przypadku opisywanej instalacji BI Point został zainstalowany na porcie 81, dlatego w polu httpPort wprowadzony został ten port. W host name należy wpisać localhost, a w server address ip 127.0.0.1.
Po uzupełnieniu wszystkich parametrów należy zatwierdzić przyciskiem – ‘Add’, a następnie wybrać opcję – ‘Zakończ’.
Po dodaniu serwera wyświetli się pytanie o utworzenie reguły, które należy potwierdzić:
Efekt potwierdzenia powyższego komunikatu widoczny jest po przejściu do zakładki dom/home IIS > Url Rewrite. We wskazanej ścieżce po uruchomieniu URL Rewrite powinna być widoczna reguła zgodna z poniższym widokiem:
Po wejściu w jej edycje zostanie wyświetlony poniższy widok:
Pattern w zakładce Match URL powinien być uzupełniony symbolem „*”, chyba że konfigurowana jest instancja nazwana (patrz Konfiguracja http z prefixem URL). W zakładce – ‘Conditions’ należy wybrać opcję – ‘Add’. Po wybraniu opcji wyświetli się okno:
Jako „Condition input” podajemy {HTTP_HOST}, i jako „Pattern” wpisujemy adres, pod jakim BI Point ma być dostępny (Można użyć również * jako dowolny adres). Po wybraniu opcji ‘Test Pattern…’ można również zweryfikować czy wprowadzony wzór obejmuje docelowy adres URL BI Pointa:
Po zapisaniu konfiguracji, może być wymagany restart IIS / BI Pointa, lub kilka odświeżeń strony, po czym instancja BI Point powinna być dostępna pod skonfigurowanym adresem. Jeżeli wskazana witryna nie jest dostępna z sieci zewnętrznej (brak adresu publicznego) należy również uwzględnić adres strony w pliku host (C:\Windows\System32\drivers\etc\hosts). W Przypadku opisywanej instalacji należy uzupełnić zgodnie z poniższym zrzutem:
Po dodaniu witryny BI Point powinien być dostępny pod linkiem dodanej witryny:
2. Konfiguracja HTTPS
Konfiguracja HTTPS wymaga powyższej konfiguracji oraz certyfikatu SSL. Następnie, klikamy PPM na utworzoną witrynę, dla której chcemy skonfigurować https, i wybieramy opcję „Edytuj powiązania„. Tam należy dodać nowe powiązanie, z konfiguracją https. Wybieramy też odpowiedni certyfikat https.
Następnie po przejściu na ‘dom’ witryny wybieramy
I zaznaczamy ‘Wymagaj protokołu SSL’. Następnie przechodzimy do IIS ‘dom’ i wybieramy URL Rewrite.
Wybieramy opcje:
Następnie ‘add’ i wpisujemy nazwę – HTTP_X_FORWARDED_PROTO. Następnie przechodzimy do
reguły dodanej w pierwszym punkcie dokumentu:
I dodajemy w zakładce ‘Server Variables’:
Po ponownym restarcie IIS BI Point powinien być dostępny po https.
Ustawienie nagłówka HSTS
Gdy wykorzystujemy połączenie po HTTPS, należy włączyć ustawianie nagłówka HSTS. Opcja ta powoduje wymuszenie korzystania z protokołu HTTPS przez przeglądarkę. W konfiguracji aplikacji należy ustawić wartość flagi UseHsts na true. Dodatkowo należy określić port https ustawiając https_port.
Ustawienia w config.json
W celu prawidłowego wyświetlania strony należy w pliku config.json znajdującym się w ścieżce C:\Program Files (x86)\Comarch\BI Point\instances\Nazwa_instancji\bipoint\ Ustawić flagę UseForwardHeaders na true.
3. Konfiguracja http z prefiksem URL
Jeżeli na IIS skonfigurowane są inne witryny na Default Web Site istnieje możliwość skonfigurowania BI Pointa z prefiksem URL (tzn. adres URL przyjmuje przykładową postać: demo-xl.comarch.pl/bipoint). W tym celu w ramach konfiguracji należy utworzyć aplikację pod witryną ‘Default Web Site’. W pierwszej kolejności należy zmodyfikować plik config.json znajdujący się w ścieżce: C:\Program Files (x86)\Comarch\BI Point\instances\Nazwa_instancji\bipoint\config.json W pliku należy uwzględnić nazwę instancji w poniższym miejscu (w opisywanym przypadku instancja to bipoint)
Następnie z poziomu IIS należy dodać aplikację zgodnie z poniższym zrzutem:
Dodając aplikacje należy wskazać nazwę instancji (w opisywanym przypadku bipoint) i podać ścieżkę
do pustego katalogu.
W kolejnym kroku należy dodać server farm, funkcjonalność jest dostępna po zainstalowaniu dodatku ARR i restarcie IIS. W celu utworzenia server farm należy zgodnie z poniższym zrzutem ekranu wybrać opcję – ‘Create Server Farm’.
W polu server Farm Name wpisujemy dowolną nazwę (zalecana nazwa powinna wskazywać jasno do jakiej aplikacji/witryny się odnosi). W advance settings tworzenia server farm należy wskazać port (w polu httpPort) na którym jest obecnie zainstalowany BI Point, który chcemy przekierować. W przypadku opisywanej instalacji BI Point został zainstalowany na porcie 81, dlatego w polu httpPort wprowadzony został ten port. W host name należy wpisać localhost, a w server address ip 127.0.0.1.
Po uzupełnieniu wszystkich parametrów należy zatwierdzić przyciskiem – ‘Add’, a następnie
wybrać opcję – ‘Zakończ’.
Po dodaniu serwera wyświetli się pytanie o utworzenie reguły, które należy potwierdzić:
Efekt potwierdzenia powyższego komunikatu widoczny jest po przejściu do zakładki dom/home IIS > Url Rewrite. We wskazanej ścieżce po uruchomieniu URL Rewrite powinna być widoczna reguła zgodna z poniższym widokiem:
Regułę w opisywanym przypadku należy edytować zgodnie z poniższym widokiem:
W ‘Pattern’ należy wprowadzić wyrażenie, które obejmować będzie jedynie instancję BI Point, a nie inne witryny. W opisywanym przypadku wzór przyjmuje postać *bipoint*.