Verschlüsselung per HTTPS

Für den produktiven Einsatz von Enginsight ist eine verschlüsselte Verbindung über HTTPS zur externen Kommunikation (z.B. für die Verbindung aus dem Internet) zwingend notwendig.

Dazu ist es nötig, nginx auf dem Enginsight Applikationsserver zu installieren, Ports für die interne Kommunikation zu definieren, ein SSL/TLS-Zertifikat zu erstellen und dieses in nginx einzurichten.

Bitte beachte: Bei der automatischen Installation des Applikationsservers wird nginx bereits mitinstalliert. Bei der manuellen Installation von Enginsight muss nginx separat installiert werden.

---

Schematischer Aufbau mit nginx

Der schematische Aufbau von Applikationsserver und Datenbankserver inklusive der verwendeten Protokolle und Ports sieht wie folgt aus:

Auf dem Applikationsserver laufen unter anderem die Docker-Container für die Enginsight Benutzeroberfläche (Container-Name: ui-m1) und für die Enginsight API (Container-Name: server-m2). Der Container ui-m1 verwendet dabei den Port 80, der Container server-m2 den Port 8080.

Diese Ports werden nun internen Ports zugeordnet, und zwar der Container-Port 80 dem internen Port 81 (127.0.0.1:81) und der Container-Port 8080 dem internen Port 82. Die interne Kommunikation läuft dabei über HTTP.

nginx sorgt dafür, dass diese Verbindungen mittels SSL/TLS-Zertifikaten über HTTPS verschlüsselt werden.

Dafür werden für die externe Kommunikation zwei Domains benötigt, die auf die IP-Adresse des Applikationsservers zeigen. Dies ist zum Einen die Domain für die Benutzeroberfläche, <DomainApp>, die auf Port 443 läuft, zum Anderen die Domain für die API, <DomainAPI>, die auf Port 80 läuft.

Wir empfehlen, ein SSL/TLS-Zertifikat der Zertifizierungsstelle Let's Encrypt zu verwenden. Die Nutzung eines eigenen, öffentlich signierten SSL/TLS-Zertifikats ist ebenfalls möglich.

Auch die Nutzung eines selbst signierten Zertifikats oder einer Windows PKI ist möglich, wir empfehlen jedoch, ein öffentlich signiertes Zertifikat zu verwenden.

---

Auf dem Applikationsserver anmelden

Achte darauf, dass du die folgenden Schritte auf dem Enginsight Applikationsserver durchführst.

Melde dich auf dem Enginsight Applikationsserver an, sofern du dies noch nicht getan hast.

Du kannst dies entweder direkt in der Konsole deiner Applikationsserver-VM oder per Fernzugriff über SSH (Secure Shell) von einer anderen Maschine aus tun.

Fahre nun mit den folgenden Schritten fort.

---

nginx installieren

Bitte beachte: Die manuelle Installation von nginx ist nur bei einer manuellen Enginsight Installation notwendig. Wenn du die die automatische Installation durchführst, wird nginx bereits auf dem Applikationsserver mitinstalliert und du kannst mit der Definierung von Ports für die interne Kommunikation weiter fortfahren.

Installiere nginx mit folgendem Befehl:

sudo apt install nginx

Bestätige deine Eingabe mit der Enter-Taste.

---

Ports für die interne Kommunikation definieren

Bitte beachte: Die Definition von Ports für die interne Kommunikation ist sowohl bei einer manuellen Enginsight Installation als auch bei einer automatischen Installation notwendig.

Damit die interne Kommunikation der Dienste reibungslos funktioniert, müssen die Ports der Docker-Container für die Enginsight Benutzeroberfläche (Container-Name: ui-m1; Port: 80) und für die Enginsight API (Container-Name: server-m2; Port: 8080) internen Ports zugeordnet werden.

Dies ist notwendig, da nginx ansonsten auch Port 80 belegen würde und es dadurch zu einem Fehler beim Systemstart kommen würde.

Nimm dazu die folgenden Schritte vor:

1

Navigiere mit folgendem Befehl in das Enginsight Installationsverzeichnis:

cd /opt/enginsight/enterprise

Bestätige deine Eingabe mit der Enter-Taste.

2

Öffne mit folgendem Befehl die Docker-Konfigurationsdatei docker-compose.yml :

sudo nano docker-compose.yml

Bestätige deine Eingabe mit der Enter-Taste.

3

Navigiere zum Abschnitt ui-m1, um den internen Port für die Enginsight Benutzeroberfläche wie folgt anzupassen:

ui-m1:
    image: registry.enginsight.com/enginsight/ui-m1:x.x.x
    ports:
    - "127.0.0.1:81:80"
    restart: always
    volumes:
    - "./conf/ui-m1/environment.js.production:/opt/enginsight/ui-m1/config/environment.js"

4

Navigiere zum Abschnitt server-m2, um den internen Port für die Enginsight API wie folgt anzupassen:

server-m2:
    image: registry.enginsight.com/enginsight/server-m2:x.x.x
    networks:
    - redis
    ports:
    - "127.0.0.1:82:8080"

5

Speichere die Änderungen in der Konfigurationsdatei (Strg+o) und bestätige den Speicherprozess. Schließe die Datei (Strg+x).

6

Stoppe nun mit folgendem Befehl die Docker-Instanz, damit Port 80 frei wird, um die Konfigurationsänderungen zu übernehmen:

sudo docker compose down

Bestätige deine Eingabe mit der Enter-Taste.

7

Aktiviere nun nginx mit folgendem Befehl um sicherzustellen, dass es beim Systemstart mitstartet:

sudo systemctl enable nginx

Bestätige deine Eingabe mit der Enter-Taste.

8

Nun musst du das Setup-Skript für den Applikationsserver noch einmal ausführen, um deine Anpassungen zu übernehmen.

Navigiere dazu mit folgendem Befehl in das Enginsight Installationsverzeichnis:

cd /opt/enginsight/enterprise

Bestätige deine Eingabe mit der Enter-Taste.

9

Führe nun mit folgendem Befehl das Setup-Skript neu aus und bestätige alle Abfragen mit der Enter-Taste:

sudo ./setup.sh

---

Optional: SSL/TLS-Zertifikat von Let's Encrypt erstellen

Bitte beachte: Wenn du ein eigenes, öffentlich signiertes SSL/TLS-Zertifikat verwenden möchtest, kannst du dieses Teilkapitel überspringen und direkt hier weiter fortfahren. Ansonsten ist die Erstellung eines SSL/TLS-Zertifikats von Let's Encrypt sowohl bei einer manuellen Enginsight Installation als auch bei einer automatischen Installation notwendig.

Um die externe Kommunikation per HTTPS absichern zu können, benötigst du ein SSL/TLS-Zertifikat. Wir empfehlen, ein Zertifikat von Let's Encrypt zu verwenden.

Bitte beachte: SSL/TLS-Zertifikate von Let's Encrypt sind immer nur 3 Monate lang gültig und müssen entsprechend erneuert werden.

Mehr Informationen, wie du ein SSL/TLS von Let's Encrypt erneuerst, findest du in unserer Knowledge Base: Wie aktualisiere ich in Enginsight ein SSL/TLS-Zertifikat von Let's Encrypt?

Nimm folgende Schritte vor, um ein SSL/TLS-Zertifikat von Let's Encrypt zu erstellen:

1

Öffne mit folgendem Befehlen die nginx-Konfigurationsdatei:

• Befehl bei einer automatischen Installation:

sudo nano /etc/nginx/sites-available/ngs.conf

Bestätige deine Eingabe mit der Enter-Taste.

• Befehl bei einer manuellen Installation:

sudo nano /etc/nginx/sites-available/default

Bestätige deine Eingabe mit der Enter-Taste.

2

Kopiere folgende Vorlage in die Konsole oder das Terminal und ersetze die Platzhalter <DomainAPI> und <DomainApp> entsprechend:

server {
        listen 80;
        listen [::]:80;
 
        location ~ /.well-known {
                allow all;
        }
 
        location / {
                return 302 https://<DomainAPI>;
        }
 
        root /var/www/<DomainAPI>;
 
        server_name <DomainAPI>;
}
 
server {
        listen 80;
        listen [::]:80;
 
        location ~ /.well-known {
                allow all;
        }
 
        location / {
                return 302 https://<DomainApp>;
        }
 
        root /var/www/<DomainApp>;
 
        server_name <DomainApp>;
}

3

Speichere die Änderungen in der Konfigurationsdatei (Strg + o) und bestätige den Speicherprozess. Schließe die Datei (Strg + x).

4

Validiere die Änderungen an der nginx-Konfiguration mit folgendem Befehl und bestätige deine Eingabe mit der Enter-Taste:

sudo nginx -t

Wenn die Konfigurationsänderungen erfolgreich sind, erhältst du folgende Meldung:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

5

Starte nun nginx mit folgendem Befehl neu:

sudo systemctl restart nginx

Bestätige deine Eingabe mit der Enter-Taste.

6

Installiere nun Certbot. Dies ist ein Tool, das die Erstellung und Installation von SSL/TLS-Zertifikaten von Let's Encrypt automatisiert. Gib dazu folgenden Befehl ein:

sudo apt-get install certbot

Bestätige deine Eingabe mit der Enter-Taste.

7

Lege nun mit folgenden Befehlen für die Subdomains ngs-api und ngs-app jeweils einen Ordner an, in dem die Zertifikats-Dateien abgelegt werden:

sudo mkdir -p /var/www/<DomainAPI>

sudo mkdir -p /var/www/<DomainApp>

Vergiss dabei nicht, <DomainAPI> und <DomainApp> entsprechend zu ersetzen.

Bestätige deine Eingaben mit der Enter-Taste.

8

Erstelle und speichere mit folgenden Befehlen die jeweiligen Zertifikats-Dateien:

sudo certbot certonly --rsa-key-size 4096 --webroot -w /var/www/<DomainAPI> -d <DomainAPI>

sudo certbot certonly --rsa-key-size 4096 --webroot -w /var/www/<DomainApp> -d <DomainApp>

Vergiss dabei nicht, <DomainAPI> und <DomainApp> entsprechend zu ersetzen.

Bestätige deine Eingaben jeweils mit der Enter-Taste.

9

Generiere nun mit folgendem Befehl die Diffie Hellman (DH)-Parameter, mit denen geheime Schlüssel gesichert über einen unsicheren Kommunikationskanal ausgetauscht werden können:

sudo openssl dhparam -out dhparam.pem 4096

Bestätige deine Eingabe mit der Enter-Taste.

Bitte beachte: Abhängig von der Leistung und Auslastung deines Systems kann die Generierung der DH-Parameter einige Zeit in Anspruch nehmen. Warte ab, bis der Prozess abgeschlossen ist.

---

SSL/TLS-Zertifikat in nginx hinterlegen

Nun muss das SSL/TLS-Zertifikat in die nginx-Konfigurationsdatei übernommen werden. Die Schritte hierfür unterscheiden sich je nachdem, ob du ein Zertifikat von Let's Encrypt oder ein eigenes öffentlich signiertes Zertifikat verwendest.

Verwendung eines Zertifikats von Let's Encrypt

Bitte beachte: Zertifkate von Let's Encrypt sind 3 Monate gültig. Aktualisiere dein Zertifikat rechtzeitig.

Mehr Informationen, wie du ein SSL/TLS von Let's Encrypt erneuerst, findest du in unserer Knowledge Base: Wie aktualisiere ich in Enginsight ein SSL/TLS-Zertifikat von Let's Encrypt?

Nimm folgende Schritte vor, wenn du ein Zertifikat von Let's Encrypt verwendest:

1

Öffne mit folgendem Befehlen die nginx-Konfigurationsdatei:

• Befehl bei einer automatischen Installation:

sudo nano /etc/nginx/sites-available/ngs.conf

Bestätige deine Eingabe mit der Enter-Taste.

• Befehl bei einer manuellen Installation:

sudo nano /etc/nginx/sites-available/default

Bestätige deine Eingabe mit der Enter-Taste.

2

Vergleiche folgende Vorlage mit der Konfigurationsdatei und bearbeite die markierten Zeilen wie folgt:

• Ersetze die Platzhalter <DomainAPI> und <DomainApp> entsprechend.

• Ersetze in den Zeilen, die mit proxy_pass beginnen, die internen Ports gemäß der Angabe.

Bitte beachte: Der Diffie-Hellman-Parameter (dhparam) ist nicht standardmäßig vorhanden und muss erst erstellt werden, da nginx sonst einen Fehler ausgibt. Wie du einen dhparam-Parameter erstellst, findest du im vorherigen Abschnitt Optional: SSL/TLS-Zertifikat von Let's Encrypt erstellen unter Schritt 9.

In unserem Beispiel geben wir zudem eine Schlüssellänge von 2048 Bits an. Diese ist zwar sicher, wir empfehlen jedoch eine Schlüssellänge von 3072 Bits oder 4096 Bits. Passe die Schlüssellänge bei Bedarf entsprechend an. Wir weisen jedoch daraufhin, dass die Erstellung des Schlüssels in diesem Fall wesentlich mehr Zeit in Anspruch nimmt!

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}
server {
        listen 80;
        listen [::]:80;
 
        location ~ /.well-known {
                allow all;
        }
 
        location / {
                return 302 https://<DomainAPI>;
        }
 
        root /var/www/<DomainAPI>;
 
        server_name <DomainAPI>;
}
 
server {
        listen 80;
        listen [::]:80;
 
        location ~ /.well-known {
                allow all;
        }
 
        location / {
                return 302 https://<DomainApp>;
        }
 
        root /var/www/<DomainApp>;
 
        server_name <DomainApp>;
}
server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;

    server_name <DomainApp>;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers on;
    ssl_ciphers "ECDHE+AESGCM+AES256";
    ssl_ecdh_curve secp384r1;
    ssl_session_cache shared:SSL:10m;
    ssl_session_tickets off;
    ssl_stapling on;
    ssl_stapling_verify on;
    resolver 8.8.8.8 8.8.4.4 valid=300s;
    resolver_timeout 5s;

    # Erstellung von dhparam.pem:
    #$ sudo mkdir /etc/nginx/ssl -p
    #$ sudo openssl dhparam -out /etc/nginx/ssl/dhparam.pem 2048
  
    ssl_dhparam /etc/nginx/ssl/dhparam.pem;
    
    ssl_certificate /etc/letsencrypt/live/<DomainApp>/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/<DomainApp>/privkey.pem;

    client_max_body_size 200m;

    location / {
        proxy_pass http://127.0.0.1:81;
        proxy_set_header Host              $host;
        proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header X-Real-IP         $remote_addr;
        proxy_set_header X-Forwarded-Proto "https";
        proxy_set_header X-Forwarded-Ssl   "on";
        proxy_set_header Upgrade           $http_upgrade;
        proxy_set_header Connection        $connection_upgrade;
    }
}

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;

    server_name <DomainAPI>;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers on;
    ssl_ciphers "ECDHE+AESGCM+AES256";
    ssl_ecdh_curve secp384r1;
    ssl_session_cache shared:SSL:10m;
    ssl_session_tickets off;
    ssl_stapling on;
    ssl_stapling_verify on;
    resolver 8.8.8.8 8.8.4.4 valid=300s;
    resolver_timeout 5s;

    # Erstellung von dhparam.pem:
    #$ sudo mkdir /etc/nginx/ssl -p
    #$ sudo openssl dhparam -out /etc/nginx/ssl/dhparam.pem 2048

    ssl_dhparam /etc/nginx/ssl/dhparam.pem;
    
    ssl_certificate /etc/letsencrypt/live/<DomainAPI>/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/<DomainAPI>/privkey.pem;

    client_max_body_size 200m;

    location / {
        proxy_pass http://127.0.0.1:82;
        proxy_set_header Host              $host;
        proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header X-Real-IP         $remote_addr;
        proxy_set_header X-Forwarded-Proto "https";
        proxy_set_header X-Forwarded-Ssl   "on";
        proxy_set_header Upgrade           $http_upgrade;
        proxy_set_header Connection        $connection_upgrade;
    }
}

3

Speichere die Änderungen in der Konfigurationsdatei (Strg + o) und bestätige den Speicherprozess. Schließe die Datei (Strg + x).

4

Validiere die Änderungen an der nginx-Konfiguration mit folgendem Befehl und bestätige deine Eingabe mit der Enter-Taste:

sudo nginx -t

Wenn die Konfigurationsänderungen erfolgreich sind, erhältst du folgende Meldung:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

5

Starte nginx mit folgendem Befehl neu:

sudo systemctl restart nginx

Bestätige deine Eingabe mit der Enter-Taste.

6

Nun musst du das Setup-Skript für den Applikationsserver noch einmal ausführen, um die App-URL sowie die API-URL auf HTTPS umzustellen.

Navigiere dazu mit folgendem Befehl in das Enginsight Installationsverzeichnis:

cd /opt/enginsight/enterprise

Bestätige deine Eingabe mit der Enter-Taste.

7

Führe mit folgendem Befehl das Setup-Skript neu aus:

sudo ./setup.sh

Gib bei der Abfrage der URIs und URLs die URLs für die Enginsight Benutzeroberfläche und die API wie folgt an:

• Enter App URL: https://<DomainApp>

• Enter API URL: https://<DomainAPI>

Bestätige deine Eingaben jeweils mit der Enter-Taste.

Bitte beachte: Wird diese Anpassung nicht vorgenommen oder trägst du versehentlich http:// ein, bleibt die Enginsight Instanz weiterhin nur per HTTP erreichbar, obwohl nginx bereits eine gesicherte Verbindung per HTTPS zur Verfügung stellt!

8

Fahre nun mit dem Setup des Applikationsservers fort.

Verwendung eines eigenen öffentlich signierten Zertifikats

Bitte beachte: Das Zertifikat muss als komplette Zertifikatskette mit gesondertem Private Key und im PEM-Format vorliegen.

Nimm folgende Schritte vor, wenn du ein eigenes öffentlich signiertes Zertifikat verwendest:

1

Navigiere auf dem System, auf dem dein eigenes Zertifikat liegt, mit folgendem Befehl in den Ordner, der alle Zertifikats-Dateien enthält:

cd /<BenutzerdefinierterVerzeichnispfad>/<OrdnerZertifikatsdateien>

Vergiss dabei nicht, <BenutzerdefinierterVerzeichnispfad> und <OrdnerZertifikatsdateien> entsprechend zu ersetzen.

Bestätige deine Eingabe mit der Enter-Taste.

2

Lade die Zertifikats-Dateien mit folgendem Befehl auf den Applikationsserver in ein Zielverzeichnis deiner Wahl hoch:

<OrdnerZertifikatsdateien> % scp * <BenutzernameApplikationsserver>@<IPAdresseApplikationsserver>:<ZielverzeichnisApplikationsserver>

Vergiss dabei nicht, die folgenden Platzhalter in <> entsprechend zu ersetzen:

• <OrdnerZertifikatsdateien>

• <BenutzernameApplikationsserver>

• <IPAdresseApplikationsserver>

• <ZielverzeichnisApplikationsserver>

Bestätige deine Eingabe mit der Enter-Taste.

3

Da die hochgeladenen Zertifikats-Dateien bisher nur für den gerade angemeldeten Benutzer des Applikationsservers, aber nicht für den Webserver lesbar sind, müssen die Zugriffsrechte entsprechend angepasst werden.

Gib dafür folgenden Befehl ein:

sudo chown root: *.pem

Bestätige deine Eingabe mit der Enter-Taste.

4

Nun kannst du die Konfiguration von nginx anpassen. Öffne dazu mit folgendem Befehl die nginx-Konfigurationsdatei:

• Befehl bei einer automatischen Installation:

sudo nano /etc/nginx/sites-available/ngs.conf

Bestätige deine Eingabe mit der Enter-Taste.

• Befehl bei einer manuellen Installation:

sudo nano /etc/nginx/sites-available/default

Bestätige deine Eingabe mit der Enter-Taste.

5

Vergleiche folgende Vorlage mit der Konfigurationsdatei und bearbeite die markierten Zeilen wie folgt:

• Ersetze die Platzhalter <DomainApp> und <DomainAPI> entsprechend.

• Setze für <URLEigenerVerzeichnispfad> jeweils die URL des Pfads ein, der zu den Zertifikats-Dateien führt.

• Ersetze in den Zeilen, die mit proxy_pass beginnen, die internen Ports gemäß der Angabe.

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;

    server_name <DomainApp>;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers on;
    ssl_ciphers "ECDHE+AESGCM+AES256";
    ssl_ecdh_curve secp384r1;
    ssl_session_cache shared:SSL:10m;
    ssl_session_tickets off;
    ssl_stapling on;
    ssl_stapling_verify on;
    resolver 8.8.8.8 8.8.4.4 valid=300s;
    resolver_timeout 5s;

    # Erstellung von dhparam.pem:
    #$ sudo mkdir /etc/nginx/ssl -p
    #$ sudo openssl dhparam -out /etc/nginx/ssl/dhparam.pem 2048
    
    ssl_dhparam /etc/nginx/ssl/dhparam.pem;
    
    ssl_certificate /<URLEigenerVerzeichnispfad>/fullchain.pem;
    ssl_certificate_key /<URLEigenerVerzeichnispfad>/privkey.pem;

    client_max_body_size 200m;

    location / {
        proxy_pass http://127.0.0.1:81;
        proxy_set_header Host              $host;
        proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header X-Real-IP         $remote_addr;
        proxy_set_header X-Forwarded-Proto "https";
        proxy_set_header X-Forwarded-Ssl   "on";
        proxy_set_header Upgrade           $http_upgrade;
        proxy_set_header Connection        $connection_upgrade;
    }
}

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;

    server_name <DomainAPI>;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers on;
    ssl_ciphers "ECDHE+AESGCM+AES256";
    ssl_ecdh_curve secp384r1;
    ssl_session_cache shared:SSL:10m;
    ssl_session_tickets off;
    ssl_stapling on;
    ssl_stapling_verify on;
    resolver 8.8.8.8 8.8.4.4 valid=300s;
    resolver_timeout 5s;

    # Erstellung von dhparam.pem:
    #$ sudo mkdir /etc/nginx/ssl -p
    #$ sudo openssl dhparam -out /etc/nginx/ssl/dhparam.pem 2048
    
    ssl_dhparam /etc/nginx/ssl/dhparam.pem;
    
    ssl_certificate /<URLEigenerVerzeichnispfad>/fullchain.pem;
    ssl_certificate_key /<URLEigenerVerzeichnispfad>/privkey.pem;

    client_max_body_size 200m;

    location / {
        proxy_pass http://127.0.0.1:82;
        proxy_set_header Host              $host;
        proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header X-Real-IP         $remote_addr;
        proxy_set_header X-Forwarded-Proto "https";
        proxy_set_header X-Forwarded-Ssl   "on";
        proxy_set_header Upgrade           $http_upgrade;
        proxy_set_header Connection        $connection_upgrade;
    }
}

6

Speichere die Änderungen in der Konfigurationsdatei (Strg + o) und bestätige den Speicherprozess. Schließe die Datei (Strg + x).

7

Validiere die Änderungen an der nginx-Konfiguration mit folgendem Befehl und bestätige deine Eingabe mit der Enter-Taste:

sudo nginx -t

Wenn die Konfigurationsänderungen erfolgreich sind, erhältst du folgende Meldung:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

8

Starte nginx mit folgendem Befehl neu:

sudo systemctl restart nginx

Bestätige deine Eingabe mit der Enter-Taste.

9

Nun musst du das Setup-Skript für den Applikationsserver noch einmal ausführen, um die App-URL sowie die API-URL auf HTTPS umzustellen.

Navigiere dazu mit folgendem Befehl in das Enginsight Installationsverzeichnis:

cd /opt/enginsight/enterprise

Bestätige deine Eingabe mit der Enter-Taste.

10

Führe mit folgendem Befehl das Setup-Skript neu aus:

sudo ./setup.sh

Gib bei der Abfrage der URIs und URLs die URLs für die Enginsight Benutzeroberfläche und die API wie folgt an:

• Enter App URL: https://<DomainApp>

• Enter API URL: https://<DomainAPI>

Bestätige deine Eingaben jeweils mit der Enter-Taste.

Bitte beachte: Wird diese Anpassung nicht vorgenommen oder trägst du versehentlich http:// ein, bleibt die Enginsight Instanz weiterhin nur per HTTP erreichbar, obwohl nginx bereits eine gesicherte Verbindung per HTTPS zur Verfügung stellt!

11

Fahre nun mit dem Setup des Applikationsservers fort.

Verwendung eines selbst signierten Zertifikats oder einer Windows PKI

Mehr Informationen, wie du bei der Verwendung eines selbst signierten Zertifikats oder einer Windows PKI (Public Key Infrastructure) vorgehen musst, findest du in unserer Knowledge Base: Wie hinterlege und konfiguriere ich in Enginsight ein selbst signiertes SSL/TLS-Zertifikat?

---

Weitere Ressourcen

Knowledge Base

• Wie aktualisiere ich in Enginsight ein SSL/TLS-Zertifikat von Let's Encrypt?

• Wie hinterlege und konfiguriere ich in Enginsight ein selbst signiertes SSL/TLS-Zertifikat?

• Wie tausche ich in Enginsight ein selbst signiertes SSL/TLS-Zertifikat aus?

• Welche Anpassungen muss ich vornehmen, wenn sich meine Enginsight Domain ändert?

---