HTTP-Konfiguration – Umleitung
Die IIS-Funktionalität ermöglicht den Start von einigen BI Point-Instanzen auf dem Port 80 oder das Umleiten von einem neu installierten BI Point auf einem anderen Port.
Damit die Konfiguration korrekt abläuft, gibt es zwei Lösungen, wenn das Programm auf Port 80 (Standard) installiert ist:
- Verschieben des Programms BI Point auf einen anderen Port (z.B. 81), falls es auf Port 80 installiert ist
- In der weiteren Konfigurationsphase die Erstellung einer „Site“ auf einem anderen Port als 80 (wobei bei dieser Lösung nach dem Login auf der Seite die Eingabe von www.seite.de:port erforderlich ist).
Erforderliche Komponenten im Falle einer Konfiguration mittels IIS (Internet Information Services):
Zu diesem Zwecke ist die Installation des Add-Ins Microsoft Application Request Routing 3.0 erforderlich.
Im nächsten Schritt muss die config.json-Datei aus dem folgenden Verzeichnis konfiguriert werden:
…\instances\Instanzname\bipoint\config.json
Die oben genannte Änderung muss auch in der BI Point-Datenbank in der Tabelle dbo.settings für BIPointUrl berücksichtigt werden.
Wenn die Verbindung zu BI Point über eine ausgewählte Domäne/Subdomäne zugelassen werden soll, muss der Eintrag AllowedHosts entsprechend geändert werden.
Windows
"AllowedHosts": "bipoint.example.com"Linux
bipoint:
(...)
environment:
- AllowedHosts=bipoint.example.com;another.example.com
(...)Wenn mehrere Hosts definiert werden sollen, sind diese durch ein Semikolon ; zu trennen.
Die Änderung ist auch in der BI Point-Datenbank in der Tabelle dbo.settings für BIPointUrl zu berücksichtigen. Im Feld SET_CustomValue muss der Name der Website eingegeben werden, der der Adresse entspricht, unter der BI Point gehostet wird.
Bei Instanzen, die die Analyse-Engine nutzen, muss die Adresse (wie in dbo.Settings) auch in der Datei appsettings.json eingetragen werden, die sich unter folgendem Pfad befindet: C:\Program Files (x86)\Comarch\BI Point\instances\Instanzname\engine\appsettings.json für den Eintrag „ApiUrl“: „“.
Im nächsten Schritt fügen Sie die Website auf IIS hinzu.
Dazu muss nach dem Starten des Managers für Internetinformationsdienste zum Ordner der Website navigiert und anschließend Website hinzufügen… ausgewählt werden.
Abhängig von der Adresse, unter der BI Point gehostet werden soll, werden der Name der Website (im beschriebenen Fall soll BI Point unter der Adresse bipoint101.pl verfügbar sein) und der Hostname ergänzt. Der physische Pfad ist beliebig, es wird jedoch empfohlen, einen physischen Pfad zu einem leeren Verzeichnis anzugeben.
Nach Eingabe aller Parameter wird mit der Schaltfläche OK bestätigt.
Im nächsten Schritt fügen Sie eine Serverfarm hinzu – die Funktionalität wird nach der ARR-Add-In-Installation und dem IIS-Neustart verfügbar.
Um eine Serverfarm zu erstellen, wählen Sie gemäß dem untenstehenden Screenshot die Option – Create Server Farm.
Im Serverfarmfeld ergänzen Sie die IP des Servers, auf dem der BI Point installiert ist. In den erweiterten Einstellungen der Serverfarm zeigen Sie die aktuellen Ports, auf denen der BI Point aktuell installiert ist und den Sie umleiten möchten.
Im beschriebenen Installationsfall wurde BI Point auf Port 81 installiert, daher wurde dieser Port im Feld httpPort eingegeben. Im Feld Host name ist localhost einzugeben und im Feld Server address die IP 127.0.0.1.
Nachdem alle Parameter ausgefüllt wurden, ist dies mit der Schaltfläche Add zu bestätigen und anschließend die Option Fertigstellen auszuwählen.
Nach dem Hinzufügen des Servers werden Sie nach der Regelerstellung gefragt – bestätigen Sie mit Ja:
Der Effekt der Bestätigung der obigen Meldung ist sichtbar, wenn Sie zum Tab Home IIS > URL Rewrite navigieren. Im angegebenen Pfad sollte nach dem Starten von URL Rewrite eine Regel sichtbar sein, die der folgenden Ansicht entspricht:
Sobald der Bearbeitungsmodus aktiviert wird, erscheint die folgende Ansicht:
Das Pattern im Reiter Match URL sollte mit dem Symbol „*“ ergänzt werden, es sei denn, eine benannte Instanz wird konfiguriert (siehe HTTP-Konfiguration mit URL-Präfix).
Im Bearbeitungsfenster der Regel, im Feld Bedingungen klicken Sie Hinzufügen an:
Nach Auswahl der Option wird ein Fenster angezeigt:
In Condition input ergänzen Sie {HTTP_HOST} und unter Pattern die Adresse, wo der BI Point verfügbar wird. Nach dem Speichern der Konfiguration können ein Neustart von IIS / BI Point oder einige Websitesaktualisierungen angefordert werden. Danach wird die BI Point-Instanz unter der konfigurierten Adresse verfügbar.
Nach dem Speichern der Konfiguration kann ein Neustart von IIS/BI Point oder ein paar Seitenaktualisierungen erforderlich sein, wonach die BI Point-Instanz unter der konfigurierten Adresse verfügbar sein sollte. Wenn die angegebene Website nicht über ein externes Netzwerk erreichbar ist (keine öffentliche Adresse vorhanden ist), muss die Website-Adresse auch in der Host-Datei (C:\Windows\System32\drivers\etc\hosts) berücksichtigt werden. Im beschriebenen Installationsfall ist dies gemäß dem folgenden Screenshot zu ergänzen:
Nach dem Hinzufügen der Website sollte BI Point über den Link der hinzugefügten Website erreichbar sein:
HTTPS-Konfiguration
Die HTTP-Konfiguration erfordert die oben genannte Konfiguration. Anschließend klicken Sie mit der rechten Maustaste die erstellte Website an, für die Sie HTTP konfigurieren möchten und wählen Sie die Option Bindung bearbeiten aus. Dort fügen Sie die neue Bindung mit der HTTP-Konfiguration hinzu. Wählen Sie auch ein neues HTTP-Zertifikat aus.
Danach navigieren Sie zu Home der Website und wählen Sie die Option SSL-Protokoll erforderlich aus.
Anschließend in IIS „Home“ wählen Sie URL Rewrite. Wählen Sie die folgende Option aus:
Klicken Sie Hinzufügen an und ergänzen Sie den Namen – HTTP_X_FORWARDED_PROTO. Wählen Sie die im ersten Punkt hinzugefügte Regel aus:
und fügen Sie sie in der Registerkarte Servervariablen hinzu:
Nach dem IIS-Neustart wird BI Point unter HTTPS verfügbar sein.
Einstellung des HSTS-Headers
Wenn eine HTTPS-Verbindung verwendet wird, sollte die Einstellung des HSTS-Headers aktiviert werden. Diese Option erzwingt die Verwendung des HTTPS-Protokolls durch den Browser. In der Anwendungskonfiguration muss der Wert des Flags UseHsts auf true gesetzt werden. Zusätzlich muss der HTTPS-Port durch Setzen von https_port definiert werden.
Einstellungen in config.json
Um die Seite korrekt anzuzeigen, muss in der Datei config.json, die sich im Pfad C:\Program Files (x86)\Comarch\BI Point\instances\Instanzname\bipoint\ befindet, das Flag UseForwardHeaders auf true gesetzt werden.
HTTP-Konfiguration mit URL-Präfix
Wenn im IIS andere Websites auf der Default Web Site konfiguriert sind, besteht die Möglichkeit, BI Point mit einem URL-Präfix zu konfigurieren (d.h. die URL nimmt beispielsweise die Form demo-xl.comarch.de/bipoint an). Dazu muss im Rahmen der Konfiguration eine Anwendung unter der Website Default Web Site erstellt werden. Zunächst muss die Datei config.json, die sich im Pfad C:\Program Files (x86)\Comarch\BI Point\instances\Instanzname\bipoint\config.json befindet, geändert werden. In der Datei muss der Instanzname an der folgenden Stelle berücksichtigt werden (im beschriebenen Fall ist die Instanz bipoint):
Anschließend muss die Anwendung über IIS wie im folgenden Screenshot gezeigt hinzugefügt werden:
Beim Hinzufügen der Anwendung muss der Instanzname (im beschriebenen Fall bipoint) angegeben und der Pfad zu einem leeren Verzeichnis hinterlegt werden.
Im nächsten Schritt muss eine Serverfarm hinzugefügt werden; die Funktionalität ist nach der Installation des ARR-Add-ins und dem Neustart von IIS verfügbar. Um eine Serverfarm zu erstellen, wählen Sie gemäß dem untenstehenden Screenshot die Option Create Server Farm.
Im Feld Server Farm Name wird ein beliebiger Name eingegeben (ein empfohlener Name sollte klar auf die Anwendung/Website verweisen, auf die er sich bezieht). In den erweiterten Einstellungen der Serverfarm muss der Port (im Feld httpPort) angegeben werden, auf dem der BI Point aktuell installiert ist und der umgeleitet werden soll. Im beschriebenen Installationsfall wurde BI Point auf Port 81 installiert, daher wurde dieser Port im Feld httpPort eingegeben. Im Feld Host name ist localhost einzugeben und im Feld Server address die IP 127.0.0.1.
Nachdem alle Parameter ausgefüllt wurden, ist dies mit der Schaltfläche Add zu bestätigen und anschließend die Option Fertigstellen auszuwählen.
Nach dem Hinzufügen des Servers wird eine Frage zur Regelerstellung angezeigt, die bestätigt werden muss:
Der Effekt der Bestätigung der obigen Meldung ist sichtbar, wenn Sie zum Tab Home IIS > URL Rewrite navigieren. Im angegebenen Pfad sollte nach dem Starten von URL Rewrite eine Regel sichtbar sein, die der folgenden Ansicht entspricht:
Die Regel muss im beschriebenen Fall gemäß der folgenden Ansicht bearbeitet werden:
Im Feld Pattern muss ein Ausdruck eingegeben werden, der nur die BI Point-Instanz und keine anderen Websites umfasst. Im beschriebenen Fall nimmt das Muster die Form *bipoint* an.