Zum Hauptinhalt springen

Zertifikatsaktualisierungsmethoden

clmBot unterstützt zwei Arten der Zertifikatsaktualisierung, die je nach Netzwerkumgebung des Servers ausgewählt werden können:

AktualisierungsmethodeArbeitsmodusPort-AnforderungAnwendungsszenario
Cloud-PushPush vom Verwaltungsbackend initiiert, clmBot-Server empfängt und aktualisiertEingehender Port 8862/tcp muss geöffnet seinNetzwerkrichtlinien erlauben es, Aktualisierung soll sofort wirksam werden
Geplante AbrufeclmBot wird regelmäßig über crontab oder Windows Aufgabenplanung ausgeführt und prüft auf UpdatesKein eingehender Port muss geöffnet werdenServer, 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.

Hinweis
  • Sie müssen den eingehenden Port 8862/tcp in 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.

Information

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
Hinweis
  • Im Befehl muss zuerst cd in das clmBot-Installationsverzeichnis gewechselt werden, da clmBot standardmäßig config.yaml aus dem aktuellen Verzeichnis liest.
  • Alternativ kann ohne Verzeichniswechsel der Pfad zur Konfigurationsdatei über den Parameter -c angegeben 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:

  1. Vor Ablauf des Zertifikats führt die Cloud automatisch die Neuerstellung gemäß dem Erneuerungszeitraum durch und generiert ein neues Zertifikat.
  2. clmBot erhält das neue Zertifikat über die konfigurierte Methode (Push oder geplantes Abrufen).
  3. 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 werden before_script ausgeführt, das neue Zertifikat geschrieben und after_script ausgefü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.
Hinweis

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.