Watchdog: SSL-Zertifikat
Überwacht die Restlaufzeit von TLS-Zertifikaten mehrerer Hosts mit Warn- und Fehlerschwelle in Tagen. Typ ssl_cert, Runner Dashboard. Felder, Status, Meldungen.
Watchdog: SSL-Zertifikat
Der Check öffnet eine TLS-Verbindung zu jedem ausgewählten Host, liest das Zertifikat und berechnet die Restlaufzeit in Tagen.
| Eigenschaft | Wert |
|---|---|
| Typ-Kennung | ssl_cert |
| Runner | Dashboard |
| Ziel in der E-Mail | Hosts (Hostnamen, kommagetrennt) |
Felder
| Feld | Schlüssel | Standard | Bedeutung |
|---|---|---|---|
| URLs to check | hosts |
Pflicht. Auswahl aus den URLs des Clients, gespeichert wird der Hostname der URL | |
| Port | port |
443 |
TCP-Port der TLS-Verbindung, gilt für alle Hosts |
| Warn threshold (days) | warn_days |
14 |
WARN, wenn das Zertifikat in höchstens so vielen Tagen abläuft |
| Fail threshold (days) | fail_days |
3 |
FAIL, wenn das Zertifikat in höchstens so vielen Tagen abläuft |
| Timeout (seconds) | timeout |
10 |
Zeitlimit der Verbindung |
| Allow self-signed | allow_self_signed |
aus | Selbstsignierte und interne CA-Zertifikate akzeptieren |
Die Fehlerschwelle sollte kleiner sein als die Warnschwelle. Das Formular prüft das nicht.
Das Formular überträgt für die Option Allow self-signed einen leeren Wert, den die Speicherlogik überspringt. Die Option lässt sich in der Oberfläche deshalb nicht aktivieren, der Check läuft immer mit vollständiger Zertifikatsprüfung.
Ablauf
Die Verbindung prüft die Zertifikatskette und den Hostnamen (verify_peer, verify_peer_name). Aus dem Ablaufdatum berechnet der Check die verbleibenden Tage, aufgerundet.
| Restlaufzeit je Host | Status | Meldung |
|---|---|---|
| Mehr als die Warnschwelle | OK |
<Host>: valid for <n> day(s) |
| Höchstens die Warnschwelle | WARN |
<Host>: expires in <n> day(s) |
| Höchstens die Fehlerschwelle | FAIL |
<Host>: expires in <n> day(s) |
| Abgelaufen | FAIL |
<Host>: expired |
| Verbindung oder TLS-Prüfung scheitert | FAIL |
Connection to <Host>:<Port> failed: <Grund> |
| Zertifikat nicht lesbar | FAIL |
No SSL options in stream context after handshake, No peer certificate captured, Failed to parse certificate oder Certificate has no validTo_time_t field |
| Kein Host konfiguriert | UNKNOWN |
No hosts configured |
Bei mehreren Hosts gilt der schlechteste Status. Die Meldung führt die Problem-Hosts auf und zählt die in Ordnung befindlichen ((2 OK)). Sind alle in Ordnung, lautet sie N hosts — all OK (min. Xd) mit der kürzesten Restlaufzeit.
Zertifikate, deren Kette nicht verifiziert werden kann (etwa von einer privaten CA), führen zu FAIL mit der Fehlermeldung der Verbindung.