Zertifikatsaktualisierungsmethoden
clmBot unterstützt zwei Arten der Zertifikatsaktualisierung, die je nach Netzwerkumgebung des Servers ausgewählt werden können:
| Aktualisierungsmethode | Arbeitsmodus | Port-Anforderung | Anwendungsszenario |
|---|---|---|---|
| Cloud-Push | Push vom Verwaltungsbackend initiiert, clmBot-Server empfängt und aktualisiert | Eingehender Port 8862/tcp muss geöffnet sein | Netzwerkrichtlinien erlauben es, Aktualisierung soll sofort wirksam werden |
| Geplante Abrufe | clmBot wird regelmäßig über crontab oder Windows Aufgabenplanung ausgeführt und prüft auf Updates | Kein eingehender Port muss geöffnet werden | Server, bei denen eingehende Ports nicht geöffnet werden können (empfohlene Standardmethode) |
Beide Methoden stehen nicht in Konflikt; innerhalb derselben Servergruppe kann ein Teil per Push und ein Teil per geplantem Abruf aktualisiert werden.
Methode 1: Cloud-Push
clmBot-Server auf dem Server starten
./clm-bot-linux-amd64 server -a="0.0.0.0:8862"
-a Legen Sie die Überwachungsadresse und den Port fest, standardmäßig 0.0.0.0:8862. Nach dem Start läuft clmBot als Dienst kontinuierlich und wartet auf Cloud-Push.
- Sie müssen den eingehenden Port
8862/tcpin der Server-Firewall und der Cloud-Sicherheitsgruppe freigeben. - Der clmBot-Dienst aktiviert gegenseitige TLS-Authentifizierung für Cloud-Push-Verbindungen und akzeptiert nur Push-Zertifikate von Knoten, die die Aktivierungsintegration abgeschlossen haben.
Wenn Sie keinen eingehenden Port öffnen möchten, verwenden Sie Methode 2: Zeitgesteuertes Abrufen.
Der clmBot-Dienst muss kontinuierlich laufen, um Push-Empfang zu ermöglichen. In der Produktionsumgebung wird empfohlen, ihn als Systemdienst zu registrieren und den automatischen Start zu aktivieren, siehe Dienstbereitstellung und Upgrade.
Zertifikat über die Verwaltungskonsole pushen
Melden Sie sich bei der Verwaltungskonsole an, gehen Sie zur Installationspunktliste, finden Sie den Ziel-Installationspunkt, klicken Sie auf Zertifikat pushen, und nach der Bestätigung wird das neueste Zertifikat an den Server gepusht und automatisch aktualisiert.
Methode 2: Zeitgesteuertes Abrufen
Der zeitgesteuerte Abrufmodus erfordert keine Öffnung eingehender Ports und ist die empfohlene Standardmethode. clmBot enthält keinen Zyklus-Planer; die Update-Befehle müssen regelmäßig über crontab, Windows Aufgabenplanung oder ein vorhandenes Planungssystem ausgeführt werden.
Linux: crontab konfigurieren
Fügen Sie den clmBot-Update-Befehl zu crontab hinzu:
crontab -e
Fügen Sie eine Zeile hinzu (tägliche Prüfung auf Zertifikatsaktualisierungen um 3 Uhr morgens):
0 3 * * * cd /opt/clm-bot && ./clm-bot-linux-amd64 update-certificate >> update.log 2>&1
- Im Befehl muss zuerst
cdin das clmBot-Installationsverzeichnis gewechselt werden, da clmBot standardmäßigconfig.yamlaus dem aktuellen Verzeichnis liest. - Alternativ kann ohne Verzeichniswechsel der Pfad zur Konfigurationsdatei über den Parameter
-cangegeben werden:./clm-bot-linux-amd64 -c /opt/clm-bot/config.yaml update-certificate. - Bitte ersetzen Sie den Pfad durch das tatsächliche Installationsverzeichnis.
Die Ausgabe wird an update.log angehängt, und clmBot protokolliert die Ausführung im logs/clm-bot.log im Verzeichnis der Konfigurationsdatei.
Windows: Geplanten Task konfigurieren
Erstellen Sie auf dem Windows-Server einen geplanten Task, um die Ausführung zeitgesteuert durchzuführen:
cd /d C:\clm-bot && clm-bot-windows-amd64.exe update-certificate >> update.log 2>&1
Nach der Erstellung können Sie mit der rechten Maustaste auf die Aufgabe klicken und „Ausführen" wählen, um sie zu verifizieren. Anschließend können Sie im Installationsverzeichnis die Protokolle einsehen, um das Ausführungsergebnis zu bestätigen.
Automatische Zertifikatserneuerung und -aktualisierung
Die von clmBot aktualisierten Zertifikate stammen aus der automatischen Neuerstellung in der Cloud. Melden Sie sich im Verwaltungs-Backend an, rufen Sie die Detailseite des SSL-Zertifikats auf, wählen Sie im Bereich „Automatische Neuerung" den Erneuerungszeitraum (z. B. 30 Tage) aus oder geben Sie ihn ein und speichern Sie.
Die Gesamtwirkung nach der Einrichtung:
- Vor Ablauf des Zertifikats führt die Cloud automatisch die Neuerstellung gemäß dem Erneuerungszeitraum durch und generiert ein neues Zertifikat.
- clmBot erhält das neue Zertifikat über die konfigurierte Methode (Push oder geplantes Abrufen).
- clmBot führt die Aktualisierung des lokalen Zertifikats durch:
- Wenn das lokale Zertifikat mit dem neuesten Cloud-Zertifikat übereinstimmt, überspringt es die Aktualisierung.
- Bei Nichtübereinstimmung wird versucht, ein Backup mit Zeitstempel zu erstellen (
.bak), anschließend werdenbefore_scriptausgeführt, das neue Zertifikat geschrieben undafter_scriptausgeführt. Bei Fehlern beim Backup wird ein Fehler protokolliert, die Aktualisierung wird jedoch fortgesetzt; ob der Dienst vollständig neu geladen wurde, sollte anhand der Skriptausgabe und des Middleware-Status beurteilt werden.
Wenn Sie after_script ohne Aktualisierung des Zertifikats erzwungen ausführen möchten (z. B. zum Debuggen des Neuladungs-Skripts), können Sie den Parameter --force-after verwenden.