Eigenes SSL-Zertifikat einspielen

Kurz erklärt

Bei der Standardinstallation nutzt Wice CRM ein von der Wice GmbH signiertes SSL-Zertifikat. Sie können es durch ein eigenes Zertifikat (eigene CA oder öffentliche CA) ersetzen — typisch für produktive Inhouse-Installationen mit firmeneigenem Hostnamen.

Ergebnis: Browser und Clients vertrauen Ihrem Mandanten-URL unter dem neuen Zertifikat.

Voraussetzungen

Voraussetzung	Hinweis
Gültiges Zertifikat inkl. Private Key	Formate siehe Schritt 1
Wice-Installer / Update-Berechtigung	Einspielen erfolgt über reguläres Wice-Update
Geplanter Wartungsfenster	Kurze Unterbrechung während des Updates möglich

Checkliste vor dem Update

Alte server.crt und server.key gesichert
Neues Zertifikat + Private Key passen zusammen (PEM-Format)
Intermediate-Zertifikate für ca.crt bereit
Wartungsfenster kommuniziert

PEM-Format (Beispiel): Dateien beginnen mit -----BEGIN CERTIFICATE----- bzw. -----BEGIN PRIVATE KEY-----.

Schritt 1: Zertifikatsdateien ablegen

Legen Sie auf dem Wice-Server folgende Dateien ab:

Datei	Inhalt
`/home/wice/etc/server.crt`	Server-Zertifikat
`/home/wice/etc/server.key`	Private Key
`/home/wice/etc/ca.crt`	Zertifikatskette (optional, je nach CA-Typ)

Wichtig: Bestehende server.crt und server.key werden überschrieben. Sichern Sie die alten Dateien vorher.

Schritt 2: Wice-Update ausführen

Schritt	Aktion
1	Wice-Installer starten (wie im Installation Guide)
2	Update vollständig durchlaufen lassen
3	Installer liest `server.crt`, `server.key` und optional `ca.crt` ein

Schritt 3: HTTPS im Browser prüfen

Öffnen Sie die Mandanten-URL per https://.
Prüfen Sie das Zertifikat im Browser (Aussteller, Gültigkeit, Hostname).
Melden Sie sich an und testen Sie eine Standardfunktion (z. B. Dashboard laden).

Ergebnis prüfen

Browser zeigt keine Zertifikatswarnung für Ihren Hostnamen.
Login und Navigation funktionieren wie vor dem Zertifikatswechsel.
Hostname im Zertifikat = Mandanten-URL.
Falls Base-URL geändert: Anpassen der Wice Base-URL konsistent halten.

Wenn etwas nicht funktioniert

Symptom	Häufige Ursache	Lösung
Browser-Warnung „nicht vertrauenswürdig“	Unvollständige Chain (`ca.crt` fehlt)	Intermediate-Zertifikate der CA als `ca.crt` ergänzen, Update wiederholen
„Private key does not match“	Key passt nicht zu `server.crt`	Key/Cert-Paar der CA erneut exportieren
Seite lädt nicht (HTTPS)	Falscher Key oder beschädigte Datei	Dateien prüfen (PEM-Format), Backup zurückspielen, erneut versuchen
Nach Update weiter altes Zertifikat	Update nicht abgeschlossen oder falscher Pfad	Pfade unter `/home/wice/etc/` prüfen, Installer-Log und Wice-Log-Datei lesen