OfficeServerJs/SSL-SETUP.md

🔒 SSL-Konfiguration für DOCX Template Server

✅ Server ist für Ihre Zertifikate konfiguriert!

Der Server erwartet Ihre SSL-Zertifikate im Projektverzeichnis:

• Zertifikat: /home/OfficeServerJS/203_cert.pem
• Privater Schlüssel: /home/OfficeServerJS/203_key.pem

🚀 SSL aktivieren

Schritt 1: Zertifikate bereitstellen

Kopieren Sie Ihre Zertifikatsdateien ins Projektverzeichnis:

# Wechseln ins Projektverzeichnis
cd /home/OfficeServerJS

# Prüfen ob Zertifikate vorhanden sind
ls -la 203_cert.pem 203_key.pem

# Falls sie woanders liegen, kopieren Sie sie:
# cp /pfad/zu/ihrem/203_cert.pem /home/OfficeServerJS/
# cp /pfad/zu/ihrem/203_key.pem /home/OfficeServerJS/

# Berechtigungen setzen (empfohlen)
chmod 600 203_key.pem
chmod 644 203_cert.pem

Schritt 2: Server mit SSL starten

# Option 1: Mit SSL-Check-Script
cd /home/OfficeServerJS
./start-ssl.sh

# Option 2: Normal starten (erkennt SSL automatisch)
./start.sh

🌐 Endpunkte nach SSL-Aktivierung

HTTP (immer verfügbar):

• Web-Interface: http://localhost:80
• Templates: http://localhost:80/templates/
• Dokumente: http://localhost:80/documents/

HTTPS (nach SSL-Aktivierung):

• Web-Interface: https://localhost:443
• Templates: https://localhost:443/templates/
• Dokumente: https://localhost:443/documents/

🔧 Zertifikat-Validierung

Das start-ssl.sh Script prüft automatisch:

• ✅ Existenz der Zertifikatsdateien
• ✅ Gültigkeit des Zertifikats
• ✅ Kompatibilität zwischen Zertifikat und Schlüssel
• ✅ Gültigkeitsdauer

📋 Produktions-Checkliste

Für den Einsatz in der Produktion:

Firewall-Konfiguration:

# Ports öffnen
ufw allow 80/tcp
ufw allow 443/tcp

DNS-Konfiguration:

• A-Record Ihrer Domain auf Server-IP setzen
• Falls Wildcard-Zertifikat: Subdomains konfigurieren

Automatischer Start:

# Systemd Service erstellen
sudo cp /home/OfficeServerJS/systemd-service-template.service /etc/systemd/system/docx-server.service
sudo systemctl enable docx-server
sudo systemctl start docx-server

Zertifikat-Erneuerung:

• Automatische Erneuerung einrichten (falls Let's Encrypt)
• Monitoring für Zertifikat-Ablauf

🚨 Troubleshooting

Zertifikat wird nicht erkannt:

# Pfade prüfen
cd /home/OfficeServerJS
ls -la 203_*.pem

# Berechtigungen prüfen
chmod 600 203_key.pem
chmod 644 203_cert.pem

# Zertifikat-Format prüfen
openssl x509 -in 203_cert.pem -text -noout

Port 443 bereits belegt:

# Prüfen was Port 443 belegt
sudo netstat -tlnp | grep :443
sudo lsof -i :443

# Falls Apache/Nginx läuft, stoppen oder Port ändern
sudo systemctl stop apache2
sudo systemctl stop nginx

SSL-Handshake-Fehler:

• Zertifikat-Kette vollständig? (Intermediate-Zertifikate)
• Zertifikat für richtige Domain ausgestellt?
• Privater Schlüssel passt zum Zertifikat?

✅ Status-Check

Nach dem Start sollten Sie sehen:

✅ Zertifikat gefunden: /home/OfficeServerJS/203_cert.pem
✅ Privater Schlüssel gefunden: /home/OfficeServerJS/203_key.pem
✅ Zertifikat und privater Schlüssel passen zusammen
🔒 HTTPS Server läuft auf Port 443

Ihre SSL-Konfiguration ist bereit! Platzieren Sie die Zertifikate im /home/OfficeServerJS/ Verzeichnis.