Navigation
clmBot ist ein leichtgewichtiger Client, der auf Ihrem internen Server bereitgestellt wird und automatisch die Bereitstellung und Aktualisierung von SSL-Zertifikaten übernimmt: Es bezieht die neuesten Zertifikate aus der Cloud, schreibt sie an die Zertifikatsinstallationspunkte auf dem Server und führt je nach Konfiguration Skripte aus, um die Middleware-Dienste neu zu laden.
Funktionsweise
Der Zertifikatsaktualisierungsprozess von clmBot läuft wie folgt ab:
- Vor Ablauf des Zertifikats führt die Cloud automatisch eine erneute Signierung durch und erstellt ein neues Zertifikat.
- clmBot bezieht das neueste Zertifikat über Cloud-Push oder zeitgesteuertes Abrufen.
- clmBot versucht, die lokalen Zertifikatsdateien auf dem Server zu sichern und zu ersetzen; ein Fehler bei der Sicherung wird protokolliert, verhindert aber nicht die anschließende Aktualisierung.
- clmBot führt je nach Konfiguration das Neulade-Skript aus (
after_script); ob es wirksam wird, hängt vom Ergebnis der Skriptausführung und dem Zustand der Middleware ab.
Der gesamte Prozess erfordert kein manuelles Einloggen auf den Server zum Ersetzen von Zertifikaten und setzt keine Verwaltungsschnittstelle des Servers nach außen hin aus.
Unterstützte Aktualisierungsmethoden
clmBot unterstützt zwei Methoden zur Zertifikatsaktualisierung, die auf verschiedenen Servern jeweils ausgewählt werden können:
| Aktualisierungsmethode | Arbeitsmodus | Port-Anforderungen | Anwendungsszenarien |
|---|---|---|---|
| Cloud-Push | Der Push wird vom Verwaltungs-Backend initiiert; der clmBot-Dienst auf dem Server empfängt und aktualisiert das Zertifikat | Eingehender Port 8862/tcp muss geöffnet sein | Geeignet, wenn die Netzwerkrichtlinie eingehende Ports erlaubt und eine sofortige Aktualisierung gewünscht ist |
| Zeitgesteuertes Abrufen | clmBot läuft zeitgesteuert über crontab oder Windows Task Scheduler und prüft und bezieht das neueste Zertifikat | Kein eingehender Port erforderlich; nur ausgehender Zugriff auf die Cloud nötig | Geeignet für Server, die keine eingehenden Ports öffnen können (standardmäßig empfohlen) |
Für die detaillierte Konfiguration siehe Zertifikatsaktualisierungsmethode.
Unterstützte Plattformen und Middleware
Unterstützte Betriebssysteme:
- Linux (amd64, arm64)
- macOS (amd64, arm64)
- Windows (amd64; ältere Windows-Versionen verwenden das Legacy-Kompatibilitätspaket)
Unterstützte Middleware und Zertifikatsformate:
| Middleware | Zertifikatsformat | Beschreibung |
|---|---|---|
| nginx | PEM | Getrennte Bereitstellung von Zertifikat, CA-Kette und privatem Schlüssel |
| Apache HTTP Server | PEM | Getrennte Bereitstellung von Zertifikat, CA-Kette und privatem Schlüssel |
| Tomcat | PEM / JKS | Unterstützt PEM-Zertifikate oder JKS-Keystore |
| IIS | IIS | Importiert PFX über integrierte Skripte und aktualisiert Site-Bindungen; Administratorrechte erforderlich |
| Exchange | Exchange | Nur Aktualisierung unterstützt; keine Erkennung, Abfrage oder sync-server; Administratorrechte erforderlich |
| Andere (benutzerdefinierte Skripte) | PFX usw. | Unterstützt beliebige Szenarien über benutzerdefinierte after_script |
Dokumentationsauswahl
| Anwendungsszenario | Empfohlene Seite |
|---|---|
| Erste Verwendung, schnelle Bereitstellung und Durchführung einer Zertifikatsaktualisierung | Schnellstart |
| Detaillierte Konfiguration der beiden Aktualisierungsmethoden kennenlernen | Zertifikatsaktualisierungsmethode |
| Manuelles Hinzufügen von Installationspunkten, Synchronisieren von Installationspunkten über das Backend, Verwendung der lokalen Web-Konfigurationsseite | Installationspunktverwaltung |
| clmBot config.yaml Feldbedeutung, Skriptvorlagenvariablen anzeigen | Konfigurationsreferenz |
| Vollständige Beispiele für Zertifikatsinstallation und -neuladen für Middleware wie nginx, Apache, Tomcat anzeigen | Konfigurationsbeispiele |
| clmBot-Berechtigungen in Produktionsumgebung einschränken, sudoers konfigurieren | Berechtigungsanforderungen |
| clmBot als Systemdienst registrieren, Version aktualisieren, Logs anzeigen | Dienstbasierte Bereitstellung und Upgrade |
Schnellstart
Wenn Sie clmBot zum ersten Mal verwenden, wird folgender Ablauf empfohlen:
- Generieren Sie AccessKey / AccessSecret im Verwaltungs-Backend.
- Laden Sie clmBot herunter und laden Sie es auf den Server hoch.
- Führen Sie
loginaus, um die Verbindung herzustellen, und aktivieren Sie den Knoten im Backend. - Führen Sie
discover-certificateaus, um Zertifikate auf dem Server automatisch zu erkennen. - Konfigurieren Sie die Aktualisierungsmethode (Push oder geplante Abfrage).
Die vollständigen Schritte finden Sie unter Schnellstart.