Projektarbeit-MYP/docs/SSL_KONFIGURATION.md

SSL-Konfiguration für das MYP-System

Dieses Dokument beschreibt die SSL-Konfiguration für das Mercedes-Benz 3D-Druck-Management-System (MYP) am Standort Berlin Werk 040.

Übersicht

Das System besteht aus zwei Hauptkomponenten:

1. Backend (Flask-Anwendung)

   • Hostname: raspberrypi
   • Ports: 443 (HTTPS), 80 (HTTP-Fallback)
   • SSL: Selbstsigniertes Zertifikat

2. Frontend (Next.js-Anwendung mit Caddy-Proxy)

   • Hostname: m040tbaraspi001.de040.corpintra.net
   • Port: 443 (HTTPS)
   • SSL: Selbstsigniertes Zertifikat durch Caddy

Voraussetzungen

• Docker und Docker Compose müssen installiert sein
• OpenSSL für die Zertifikatgenerierung
• Administratorrechte für das Einrichten der Hostnamen

Einrichtung

1. Hostnamen konfigurieren

Für die korrekte Funktion des Systems müssen die folgenden Hostnamen in der /etc/hosts (Linux/macOS) oder C:\Windows\System32\drivers\etc\hosts (Windows) Datei eingerichtet werden:

127.0.0.1 m040tbaraspi001.de040.corpintra.net m040tbaraspi001
127.0.0.1 raspberrypi

Verwenden Sie für die automatische Konfiguration die bereitgestellten Skripte:

• Windows: setup_hosts.ps1 (als Administrator ausführen)
• Linux/macOS: setup_hosts.sh (mit sudo ausführen)

2. SSL-Zertifikate generieren

Für die HTTPS-Kommunikation werden selbstsignierte Zertifikate verwendet:

• Windows: generate_ssl_certs.ps1 (als Administrator ausführen)
• Linux/macOS: generate_ssl_certs.sh (mit sudo ausführen)

Die Zertifikate werden im Verzeichnis backend/instance/ssl/ gespeichert:

• Backend: myp.crt und myp.key
• Frontend: frontend.crt und frontend.key

3. System starten

Nach der Konfiguration kann das System mit folgendem Befehl gestartet werden:

docker-compose up -d

Zugriff auf das System

• Backend-API: https://raspberrypi/
• Frontend-Anwendung: https://m040tbaraspi001.de040.corpintra.net/

Beim ersten Zugriff wird der Browser eine Sicherheitswarnung anzeigen, da selbstsignierte Zertifikate verwendet werden. Diese Warnung kann akzeptiert werden, um fortzufahren.

Konfigurationsdateien

Die SSL-Konfiguration ist in folgenden Dateien definiert:

• backend/app/config/settings.py: Backend-SSL-Konfiguration
• frontend/docker/caddy/Caddyfile: Frontend-Proxy-Konfiguration mit SSL
• docker-compose.yml: Docker-Container-Konfiguration mit Hostnamen und Ports

Fehlerbehebung

Zertifikatsprobleme

Falls die SSL-Zertifikate nicht richtig funktionieren, führen Sie folgende Schritte aus:

1. Überprüfen Sie, ob die Zertifikate im Verzeichnis backend/instance/ssl/ existieren
2. Führen Sie die Skripte zur Zertifikatgenerierung erneut aus
3. Starten Sie die Container neu: docker-compose restart

Hostnamenprobleme

Falls die Hostnamen nicht aufgelöst werden können:

1. Überprüfen Sie die Einträge in der Hosts-Datei mit cat /etc/hosts (Linux/macOS) oder type C:\Windows\System32\drivers\etc\hosts (Windows)
2. Führen Sie die Hostnamen-Setup-Skripte erneut aus
3. Überprüfen Sie die Netzwerkkonfiguration in docker-compose.yml

Sicherheitshinweise

• Die selbstsignierten Zertifikate sind für Entwicklungs- und interne Zwecke geeignet
• Für Produktionsumgebungen sollten offiziell signierte Zertifikate verwendet werden
• Der HTTP-Port 80 beim Backend dient nur als Fallback und sollte in kritischen Umgebungen deaktiviert werden