Zum Hauptinhalt springen

Schnellstart

Diese Seite führt Sie in 15 Minuten durch die Bereitstellung von clmBot und eine vollständige Zertifikatsaktualisierung.

Bevor Sie beginnen, stellen Sie sicher:

  • Der sslTrus CaaS-Dienst ist aktiviert und Sie können sich im Verwaltungsportal anmelden.
  • Der Zielserver kann ausgehende Verbindungen zum Cloud-Dienst herstellen.
  • Sie besitzen Administratorrechte auf dem Server (für Installation und Initialisierung von clmBot).

Schritt 1: AccessKey / AccessSecret generieren​

Melden Sie sich im Verwaltungsportal an, navigieren Sie zu sslTrus CaaS-Dienst -> Produktdetails -> SSL-Zertifikatsdetails, und klicken Sie auf 生成AK/SK, um AccessKey (AK) und AccessSecret (SK) zu erhalten.

Hinweis

Bewahren Sie AccessKey und AccessSecret sicher auf. Übermitteln Sie AccessSecret nicht an ein Git-Repository, schreiben Sie es nicht in öffentliche Skripte und senden Sie es nicht an unzuverlässige Drittsysteme; bei Verdacht auf Offenlegung generieren Sie es im Verwaltungsportal neu.

Schritt 2: clmBot herunterladen und auf den Server hochladen​

Laden Sie die Programmversion für Ihr System von der clmBot-Veröffentlichungsseite herunter:

clmBot herunterladen

Wählen Sie die Version entsprechend dem Betriebssystem und der Architektur des Servers (z. B. clm-bot-linux-amd64) und laden Sie sie auf den Server hoch. Es wird empfohlen, ein separates Installationsverzeichnis zu erstellen, z. B. /opt/clm-bot.

mkdir -p /opt/clm-bot && cd /opt/clm-bot
chmod 755 clm-bot-linux-amd64

Schritt 3: Anmeldung und Integration​

Führen Sie im Installationsverzeichnis den Befehl login aus, um die Integration abzuschließen:

./clm-bot-linux-amd64 login

Wählen Sie zuerst die Cloud-Adressnummer gemäß den Anweisungen aus (oder geben Sie die Cloud-Adresse direkt ein), und geben Sie dann nacheinander AccessKey und AccessSecret ein.

Nach erfolgreicher Anmeldung generiert clmBot eine config.yaml-Konfigurationsdatei im Installationsverzeichnis, die die Zugriffsinformationen speichert.

Schritt 4: Aktivieren Sie den Knoten im Verwaltungs-Backend​

Melden Sie sich im Verwaltungs-Backend an, gehen Sie zur Knotenliste von clmBot, und Sie sehen einen neu hinzugefügten clmBot-Knoten. Klicken Sie auf den Schalter Zugriff erlauben rechts neben dem Knoten, um ihn zu aktivieren.

Hinweis

Neu hinzugefügte Knoten sind standardmäßig deaktiviert. Erst nach der Aktivierung im Backend kann clmBot normal Zertifikate aus der Cloud abrufen.

Schritt 5: Entdecken Sie Zertifikate auf dem Server​

Führen Sie den Befehl zur Zertifikatserkennung aus, um automatisch alle auf dem Server bereitgestellten Zertifikate und deren Speicherpfade zu scannen:

./clm-bot-linux-amd64 discover-certificate

Nach der Ausführung des Befehls werden die gefundenen Zertifikatsinformationen (Quelle, Typ, Aussteller, Pfad, Domains usw.) in Tabellenform aufgelistet. Geben Sie die Seriennummer des Zertifikats ein, das Sie hochladen möchten, um die Aufnahme in die Backend-Verwaltung zu bestätigen:

  • all: Alle hochladen
  • none: Nicht hochladen
  • 1,3-5: Nach Seriennummer auswählen, Bereichsnotation wird unterstützt

Nach erfolgreichem Hochladen erscheinen diese Zertifikate als Installationspunkte im Verwaltungs-Backend. clmBot generiert im aktuellen Verzeichnis in der Datei config.yaml für jeden Installationspunkt die entsprechende Konfiguration.

Information

In der automatisch generierten Konfiguration enthält jeder Installationspunkt die Felder before_script und after_script. Dabei ist after_script das Neulade-Skript, das nach der Zertifikatsaktualisierung ausgeführt wird – bitte prüfen Sie, ob es in Ihrer tatsächlichen Umgebung verwendbar ist. Die Bedeutung der Felder finden Sie in der Konfigurationsreferenz.

Schritt 6: Erste Zertifikatsaktualisierung durchführen​

Nachdem im Verwaltungsportal für das Zertifikat ein automatischer Neuausstellungszyklus festgelegt wurde (siehe Zertifikatsaktualisierungsmethode), kann ein manueller Update ausgelöst werden, um den gesamten Ablauf zu überprüfen:

./clm-bot-linux-amd64 update-certificate

Nach der Ausführung prüft clmBot, ob in der Cloud eine neuere Version des Zertifikats vorliegt:

  • Lokales Zertifikat ist bereits aktuell: gibt einen Hinweis aus und überspringt den Vorgang.
  • Neues Zertifikat in der Cloud vorhanden: versucht, ein Backup mit .bak zu erstellen, schreibt das neue Zertifikat und führt gemäß Konfiguration after_script aus. Schlägt die Sicherung fehl, wird ein Fehler protokolliert, aber die Aktualisierung fortgesetzt; ob der Dienst vollständig neu geladen wurde, sollte anhand des Skriptergebnisses und des Middleware-Status beurteilt werden.

Nächste Schritte​

Letztes Update am