Zum Hauptinhalt springen

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:

  1. Vor Ablauf des Zertifikats führt die Cloud automatisch eine erneute Signierung durch und erstellt ein neues Zertifikat.
  2. clmBot bezieht das neueste Zertifikat über Cloud-Push oder zeitgesteuertes Abrufen.
  3. 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.
  4. 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:

AktualisierungsmethodeArbeitsmodusPort-AnforderungenAnwendungsszenarien
Cloud-PushDer Push wird vom Verwaltungs-Backend initiiert; der clmBot-Dienst auf dem Server empfängt und aktualisiert das ZertifikatEingehender Port 8862/tcp muss geöffnet seinGeeignet, wenn die Netzwerkrichtlinie eingehende Ports erlaubt und eine sofortige Aktualisierung gewünscht ist
Zeitgesteuertes AbrufenclmBot läuft zeitgesteuert über crontab oder Windows Task Scheduler und prüft und bezieht das neueste ZertifikatKein eingehender Port erforderlich; nur ausgehender Zugriff auf die Cloud nötigGeeignet 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:

MiddlewareZertifikatsformatBeschreibung
nginxPEMGetrennte Bereitstellung von Zertifikat, CA-Kette und privatem Schlüssel
Apache HTTP ServerPEMGetrennte Bereitstellung von Zertifikat, CA-Kette und privatem Schlüssel
TomcatPEM / JKSUnterstützt PEM-Zertifikate oder JKS-Keystore
IISIISImportiert PFX über integrierte Skripte und aktualisiert Site-Bindungen; Administratorrechte erforderlich
ExchangeExchangeNur 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​

AnwendungsszenarioEmpfohlene Seite
Erste Verwendung, schnelle Bereitstellung und Durchführung einer ZertifikatsaktualisierungSchnellstart
Detaillierte Konfiguration der beiden Aktualisierungsmethoden kennenlernenZertifikatsaktualisierungsmethode
Manuelles Hinzufügen von Installationspunkten, Synchronisieren von Installationspunkten über das Backend, Verwendung der lokalen Web-KonfigurationsseiteInstallationspunktverwaltung
clmBot config.yaml Feldbedeutung, Skriptvorlagenvariablen anzeigenKonfigurationsreferenz
Vollständige Beispiele für Zertifikatsinstallation und -neuladen für Middleware wie nginx, Apache, Tomcat anzeigenKonfigurationsbeispiele
clmBot-Berechtigungen in Produktionsumgebung einschränken, sudoers konfigurierenBerechtigungsanforderungen
clmBot als Systemdienst registrieren, Version aktualisieren, Logs anzeigenDienstbasierte Bereitstellung und Upgrade

Schnellstart​

Wenn Sie clmBot zum ersten Mal verwenden, wird folgender Ablauf empfohlen:

  1. Generieren Sie AccessKey / AccessSecret im Verwaltungs-Backend.
  2. Laden Sie clmBot herunter und laden Sie es auf den Server hoch.
  3. Führen Sie login aus, um die Verbindung herzustellen, und aktivieren Sie den Knoten im Backend.
  4. Führen Sie discover-certificate aus, um Zertifikate auf dem Server automatisch zu erkennen.
  5. Konfigurieren Sie die Aktualisierungsmethode (Push oder geplante Abfrage).

Die vollständigen Schritte finden Sie unter Schnellstart.