Einen Docker-Checkpoint installieren

Dieser Knowledge-Base-Artikel ist ein Setup Guide, um Windows Server 2022 oder 2019 als Host-Betriebssystem zu konfigurieren. Er erläutert auch, wie ein privater Docker-Container-Checkpoint eingerichtet wird.

Stelle vor der Installation sicher, dass alle Voraussetzungen und Einstellungen erfüllt sind. Uptrends wird dir die erforderlichen Dateien bereitstellen, um das Monitoring aufzunehmen.

Installationsskript

Uptrends stellt ein Installationsskript bereit, das du als .zip-Datei aus dem Private Locations Menü der Uptrends Anwendung herunterladen kannst. Dieses Skript ist für jeden deiner Private Locations verfügbar und führt die hauptsächlichen Installationsschritte aus. Diese Schritte umfassen die Installation von Docker und Docker Compose, Abrufen der Uptrends Container Images, Ausführen eines Start- und Aktualisierungs-Tasks und Starten des Container-Checkpoints.

Installationsschritte

Um einen Checkpoint anhand des Skripts zu installieren:

1. Rufe das Private Locations-Menü auf.
2. Solltest du noch keine Private Locations hinzugefügt haben, klicke auf Standort hinzufügen. Sobald der private Standort hinzugefügt wurde, sind standardmäßig zwei Checkpoints enthalten.
3. Klicke auf den Namen des privaten Standorts.
4. Wähle aus dem Drop-down-Menü Host Betriebssystem das erforderliche Betriebssystem.
5. Klicke auf die Schaltfläche Lade die Installations-Zip-Datei herunter.

5. Entpacke die heruntergeladene Datei an dem Ort, an dem du den privaten Checkpoint installieren möchtest.
6. Um zu verhindern, dass Screenshots in die Cloud geladen werden, kannst du die Docker-Compose-Datei bearbeiten , nachdem du die Dateien heruntergeladen und extrahiert hast.

7. Öffne eine PowerShell-Konsole und führe sie als Administrator aus. Führe das Skript ./install-checkpoint.ps1 im Uptrends (unzip)-Verzeichnis aus. Damit wird der Server einmal neu gestartet. Beachte, dass das Skript einen Task konfigurieren wird, der einmal pro Stunde läuft, um auf Aktualisierungen der Uptrends Container zu prüfen.

Die Checkpoints sind nun verfügbar und können auf dem Tab Checkpoints des Prüfobjekts gewählt werden. Du kannst die Checkpoints auch im Dialogfenster Kontrolldetails sehen, wenn du einen schnellen Test direkt in den Prüfobjekteinstellungen über die Schaltfläche Jetzt testen ausführst.

Privaten Checkpoint überwachen

Uptrends wird Änderungen an deinem Account vornehmen, um dich bei der Überwachung deiner privaten Checkpoints besser zu unterstützen. Bitte stelle sicher, dass deine privaten Checkpoint-Server, Firewall, Internetverbindung und andere unterstützende Systeme zugänglich bleiben.

Während der Einrichtung der privaten Checkpoints fügt Uptrends zusätzliche Prüfobjekte und Konfigurationen hinzu. Bitte ändere oder lösche diese in deinem Account nicht.

Weitere Informationen findest du im Knowledge-Base-Artikel Private Locations nutzen .

Die Installation von Client-Zertifikaten für Private Locations

Dieser Abschnitt ist ein optionaler Installationsleitfaden für Zertifikate auf Docker-basierten Private Locations. Diese Schritte müssen nur ausgeführt werden, wenn deine zu testenden Anwendungen die Installation eines Zertifikats erfordern.

Bevor du die Client-Zertifikate installierst, stelle sicher, dass du die oben genannten Schritte zur Installation befolgt hast. Beachte, dass Client Zertifikate bei Multi-Step API-Prüfobjekten und Client Zertifikate bei Private Locations sich unterscheiden und zwei verschieden Themen sind.

Client-Zertifikate installieren:

1. Öffne in deinem Verzeichnis (C:\UptrendsCheckpoints<checkpoint-name>\) das Skript des privaten Standorts. Standardmäßig siehst du mehrere Dateien, wie etwa die docker-comppose YAML-Datei und Windows PowerShell-Skripte. Diese Dateien sind für den Installationsprozess unerlässlich.
2. Klicke auf den Certificates-Ordner. Dieser Ordner enthält drei weitere Ordner und eine README Markdown-Datei.
3. Lege deine Zertifikate in den entsprechenden Certificates-Unterordnern ab:

• Client-Ordner – für alle Client-Zertifikat-Dateien (PKCS #7).
• Intermediate-Ordner – für alle Intermediate CA-Zertifikat-Dateien (PKCS #7).
• Root-Ordner – für alle Root Certificate Authority (CA)-Zertifikat-Dateien (PKCS #7).

4. Wenn du ein Client-Zertifikat hinzugefügt hast, erstelle eine JSON-Datei namens clientCertificates.json im Client-Unterordner. Diese JSON-Datei sollte alle deine Client-Zertifikate auflisten. Andernfalls fahre mit dem nächsten Schritt fort.

• Kopiere und bearbeite die JSON-Vorlage:

[
    {
        "File": "my-first-client-cert.p12",
        "Password": "letmein",
        "UrlPatterns": ["https://fake.sub.domain.example.com"]
    },
    {
        "File": "AcmeCert.pfx",
        "Password": "anvil123",
        "UrlPatterns": ["https://client.acmecorp.fake:1234", "[*.]acmecorp.real"]
    }
]

Beachte, dass das JSON-Snippet aus zwei Client-Zertifikaten besteht. Jedes Client-Zertifikat wird von einem JSON-Objekt mit drei Schlüssel-Wert-Paaren repräsentiert. Das erste Zertifikat, my-first-client-cert.p12, erlaubt nur eine bestimmte Subdomain. Das zweite Zertifikat, AcmeCert.pfx, ist für die Subdomain acmecorp.fake des Clients erlaubt, wenn mit HTTPS Port 1234 verbunden oder acmecorp.real oder eine ihrer Subdomains besucht wird.

Bearbeite die folgenden Werte entsprechend deinen Anforderungen:

• File – der Dateiname und die Dateierweiterung deines Client-Zertifikats.
• Password – das Passwort, das für den Zugriff auf die Daten im Zertifikats-Archiv erforderlich ist, zum Beispiel der private Schlüssel.
• UrlPatterns – die Liste erlaubter URL-Domains oder Subdomains, die das Client-Zertifikat nutzen werden. Diese Liste kann aus mehreren URL-Mustern bestehen, die eine einzelne Domain, Subdomain oder einen Platzhalter für eine Domain und alle ihre Subdomains sein können. Weitere Information findest du unter Enterprise policy URL pattern format (URL-Musterformat für Unternehmensrichtlinien).

5. Führe einen Neustart der Uptrends Checkpoint-Software aus, indem du das Skript update-images.ps1 aus dem Root-Verzeichnis der Installation ausführst.

6. Bestätige, dass sowohl das alte wie auch das neue Zertifikat erkannt werden und korrekt installiert sind. Sollte es Probleme geben, versuche diese grundlegenden Fehlerbehebungen:

• Prüfe, dass der JSON-Dateiname korrekt ist.
• Stelle sicher, dass alle JSON-Schlüssel-Wert-Paare der korrekten JSON-Syntax folgen.
• Prüfe auf Falschkonfigurationen oder Probleme mit Berechtigungen.