Customer HubSSL-Zertifikat erneuern
Ein abgelaufenes SSL-Zertifikat des Servers hat Auswirkungen auf die Verwaltung von eingeschriebenen Geräten. Es ist daher wichtig, das SSL-Zertifikat rechtzeitig vor Ablauf zu aktualisieren, um einen reibungslosen Betrieb und fortlaufende Kontrolle über eingeschriebene Geräte sicherzustellen.
Die Vorgehensweise unterscheidet sich je nach Installation, Reverse Proxy und Herkunft des Zertifikats.
Anleitung nach Installation
| Installation | Let’s Encrypt | Gekauftes Zertifikat |
|---|---|---|
| Docker mit Traefik (Standard) | Traefik: Zertifikat erneuern → | Traefik: Zertifikat erneuern → |
| Docker mit nginx | nginx: Zertifikat erneuern → | nginx: Zertifikat erneuern → |
| Native Installation Windows oder Linux mit nginx (veraltet) | – | Native Installation: Zertifikat erneuern → |
Ein gekauftes Zertifikat wird vor dem Einbinden nach Gekauftes Zertifikat erneuern → vorbereitet.
Welcher Reverse Proxy eingesetzt wird, zeigt die Compose-Datei im Verzeichnis /opt/relution (compose.yaml, bei älteren Installationen docker-compose.yml): Sie enthält entweder einen traefik:- oder einen nginx:-Block.
Zertifikatsdateien
Wurde für das neue Zertifikat ein neues Schlüsselpaar erzeugt, wird in allen Varianten zusätzlich die Datei server.key durch den neuen privaten Schlüssel ersetzt. Wurde der bisherige private Schlüssel weiterverwendet (z. B. dieselbe CSR oder eine neue CSR mit dem bisherigen Schlüssel), bleibt server.key unverändert. Die Datei server.pem enthält das Serverzertifikat samt Zwischenzertifikaten; liegt das neue Zertifikat als PFX-Datei vor, wird es vorher umgewandelt, siehe Zertifikat in PEM umwandeln →.
Weitere Hinweise
Wird das SSL-Zertifikat zusätzlich als Signierungszertifikat für Apple-Geräte verwendet (siehe iOS-Signierungszertifikat →), werden die Dateien auch an dem dort konfigurierten Ort ersetzt (Docker/Linux: unter /opt/relution, Windows: im Installationsverzeichnis, bei Pfaden mit dem Präfix file: am angegebenen Ort). Relution liest das Signierungszertifikat nur beim Start ein; nach dem Austausch ist daher ein Neustart von Relution erforderlich.
Wird das Signierungszertifikat über die Umgebungsvariable KEYSTORE_IOS_SIGNER_PEM übergeben, wird stattdessen deren Inhalt mit dem neuen privaten Schlüssel und Zertifikat im PEM-Format aktualisiert. Da docker compose restart geänderte Umgebungsvariablen nicht übernimmt, wird der Container anschließend mit docker compose up -d neu erstellt.