Zertifikatskette mit openssl auf Gültigkeit prüfen

· 4 Min. Lesezeit

Im Browser sieht alles gut aus, aber eine App, ein Monitoring oder ein Mailserver meldet einen Zertifikatsfehler? Dann fehlt meist ein Zwischenzertifikat. Browser gleichen das stillschweigend aus, andere Programme nicht. Diese Anleitung zeigt, wie du die Kette mit openssl und curl prüfst, was die Verify return codes bedeuten und warum das openssl von macOS dabei in die Irre führen kann.

Kette, Hostname und Ablauf prüfen

Wähle, was du wissen willst, und setz den Hostnamen ein, so wie Besucher ihn aufrufen (mit oder ohne www). -servername sorgt dafür, dass der Server das Zertifikat für genau diesen Namen ausliefert.

Was prüfen?
Werkzeug

Wird nur in deinem Browser in die Befehle eingesetzt.

Kette prüfen · openssl · Linux, macOS

Die Kette, wie der Server sie sendet: s: ist der Inhaber, i: der Aussteller. Das i: jeder Stufe muss das s: der nächsten sein. Die letzte Zeile ist das Urteil; 0 (ok) heißt, die Kette führt lückenlos zu einem vertrauten Stammzertifikat.

Shell
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep -E "^ [0-9]+ s:|^   i:|Verify return code"
Beispielausgabe
 0 s:CN=example.com
   i:C=US, O=Example Trust, CN=Example Issuing CA 1
 1 s:C=US, O=Example Trust, CN=Example Issuing CA 1
   i:C=US, O=Example Trust, CN=Example Root CA
Verify return code: 0 (ok)

Kette prüfen · curl · Linux, macOS

curl prüft Kette und Hostnamen in einem Zug und fasst zusammen: „SSL certificate verify ok.“ oder „SSL certificate problem: …“ mit dem Grund. Die Kette selbst zeigt curl nicht.

Shell
curl -svI https://example.com 2>&1 | grep -E "subject:|issuer:|expire date|subjectAltName|SSL certificate"
Beispielausgabe
*  subject: CN=example.com
*  expire date: Dec 25 22:56:35 2026 GMT
*  subjectAltName: host "example.com" matched cert's "example.com"
*  issuer: C=US; O=Example Trust; CN=Example Issuing CA 1
*  SSL certificate verify ok.

Kette und Hostname · openssl · Linux, macOS

Ohne -verify_hostname prüft s_client nur die Kette. Erst mit der Option zählt auch, ob das Zertifikat für diesen Namen gilt; bei einem falschen Namen lautet das Ergebnis „62 (hostname mismatch)“. Nur OpenSSL, nicht LibreSSL.

Shell
openssl s_client -connect example.com:443 -servername example.com -verify_hostname example.com </dev/null 2>/dev/null | grep Verif
Beispielausgabe
Verification: OK
Verified peername: example.com
Verify return code: 0 (ok)

Kette und Hostname · curl · Linux, macOS

curl verbindet sich nur, wenn Kette und Name stimmen. „OK“ erscheint also nur bei gültigem Zertifikat; sonst endet curl mit Fehlercode 60.

Shell
curl -sI https://example.com -o /dev/null && echo OK
Beispielausgabe
OK

Ablaufdatum · openssl · Linux, macOS

-enddate nennt das Ablaufdatum, -checkend prüft, ob es innerhalb der nächsten 2592000 Sekunden (30 Tage) liegt, und setzt den Rückgabewert für Skripte. LibreSSL gibt nur das Datum aus, der Rückgabewert stimmt trotzdem.

Shell
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -enddate -checkend 2592000
Beispielausgabe
notAfter=Dec 25 22:56:35 2026 GMT
Certificate will not expire

Ablaufdatum · curl · Linux, macOS

Das Ablaufdatum des Serverzertifikats aus der ausführlichen Ausgabe von curl.

Shell
curl -svI https://example.com 2>&1 | grep "expire date"
Beispielausgabe
*  expire date: Dec 25 22:56:35 2026 GMT

Eine vollständige Kette besteht aus dem Serverzertifikat (Stufe 0) und allen Zwischenzertifikaten. Das Stammzertifikat muss der Server nicht mitsenden, es liegt im Zertifikatsspeicher des Clients.

Die Verify return codes

Die Zahl in der letzten Zeile sagt, woran die Prüfung gescheitert ist. Diese begegnen dir in der Praxis:

  • 0 (ok): Die Kette ist gültig. Über den Hostnamen sagt das ohne -verify_hostname nichts.
  • 20 (unable to get local issuer certificate): Zu einem Zertifikat der Kette fehlt der Aussteller. Fast immer liefert der Server das Zwischenzertifikat nicht mit.
  • 21 (unable to verify the first certificate): die Folge von 20 direkt beim Serverzertifikat. Der Server sendet nur sein eigenes Zertifikat.
  • 10 (certificate has expired): Ein Zertifikat der Kette ist abgelaufen. Meist das Serverzertifikat, gelegentlich ein veraltetes Zwischenzertifikat in der Konfiguration.
  • 18 (self-signed certificate): Das Serverzertifikat ist selbst signiert, es gibt keine Kette.
  • 19 (self-signed certificate in certificate chain): Die Kette endet bei einem Stammzertifikat, dem dein System nicht vertraut, etwa einer firmeneigenen CA oder einem TLS-Proxy im Netzwerk.
  • 62 (hostname mismatch): Nur mit -verify_hostname. Die Kette stimmt, das Zertifikat gilt aber nicht für diesen Namen.

Bei 20 und 21 behebst du den Fehler am Server: Trag statt des einzelnen Zertifikats die vollständige Kette ein, bei Let's Encrypt die Datei fullchain.pem statt cert.pem. Die Reihenfolge ist Serverzertifikat zuerst, dann die Zwischenzertifikate.

Zertifikatsdateien vor dem Einspielen prüfen

Hast du Zertifikat und Kette als Dateien bekommen, prüfst du sie, bevor sie auf den Server kommen. -untrusted übergibt die Zwischenzertifikate, -show_chain zeigt die gebaute Kette.

Shell
$ openssl verify -show_chain -untrusted chain.pem cert.pem
cert.pem: OK
Chain:
depth=0: CN=example.com (untrusted)
depth=1: C=US, O=Example Trust, CN=Example Issuing CA 1 (untrusted)
depth=2: C=US, O=Example Trust, CN=Example Root CA

$ openssl verify cert.pem
CN=example.com
error 20 at 0 depth lookup: unable to get local issuer certificate
error cert.pem: verification failed

„(untrusted)“ heißt hier nur: aus der übergebenen Datei, nicht aus dem Zertifikatsspeicher. Der zweite Aufruf ohne Kette zeigt genau den Fehler, den Clients sehen, wenn der Server das Zwischenzertifikat nicht mitliefert. Wie viele Zertifikate in einer Datei stecken, zählt grep -c "BEGIN CERTIFICATE" chain.pem.

Vorsicht mit dem openssl von macOS

Unter /usr/bin/openssl liegt bei macOS LibreSSL. Beim Test gegen einen Server mit fehlendem Zwischenzertifikat schrieb LibreSSL 3.3.6 zwar „verify error:num=20“ und „num=21“ in die Ausgabe, schloss aber mit „Verify return code: 0 (ok)“. Wer nur die letzte Zeile liest, hält die Kette für gültig. OpenSSL 3 meldete für denselben Server korrekt 21.

Auch curl urteilt je nach System verschieden: Das curl von macOS meldete für denselben Server „SSL certificate verify ok.“, das curl unter Debian „unable to get local issuer certificate“. Verlass dich bei der Kettenprüfung deshalb auf ein aktuelles OpenSSL (über Homebrew: brew install openssl) oder auf einen Test unter Linux, und achte auf Zeilen mit „verify error“ weiter oben in der Ausgabe.

  • Namen: OpenSSL ab 3.2 schreibt „s:CN=example.com“, ältere Versionen wie 1.1.1 und 3.0 „s:CN = example.com“ mit Leerzeichen, LibreSSL „s:/CN=example.com“.
  • -verify_hostname und -brief kennt LibreSSL nicht („unknown option“).
  • -verify_return_error bricht bei OpenSSL den Handshake mit Fehlercode ab, sobald die Prüfung scheitert. Damit lässt sich das Ergebnis im Skript am Rückgabewert ablesen.
  • openssl x509 -ext subjectAltName gibt es nur bei OpenSSL; unter LibreSSL hilft -text.

Ohne Kommandozeile prüfen

Der SSL Checker baut die Verbindung mit SNI auf, prüft die Kette gegen die gängigen Stammzertifikate und zeigt Aussteller, Gültigkeit, alternative Namen und die ausgehandelte Protokollversion, auf Wunsch auch für Mailserver-Ports. Weitere openssl-Befehle zum Auslesen von Zertifikaten stehen in der Anleitung „SSL-Zertifikat mit openssl prüfen“; was eine Zertifikatskette ist, erklärt das Glossar.

Häufige Fragen

Wie prüfe ich mit openssl, ob die Zertifikatskette gültig ist?
openssl s_client -connect example.com:443 -servername example.com < /dev/null und auf die Zeile „Verify return code“ achten. 0 (ok) bedeutet gültig, 20 oder 21 ein fehlendes Zwischenzertifikat. Für Dateien: openssl verify -untrusted chain.pem cert.pem.
Was bedeutet „Verify return code: 21 (unable to verify the first certificate)“?
Der Server sendet nur sein eigenes Zertifikat ohne das Zwischenzertifikat. Clients ohne eigene Kopie können die Kette nicht bilden. Trag am Server die vollständige Kette ein (fullchain).
Warum funktioniert die Seite im Browser trotz unvollständiger Kette?
Browser merken sich Zwischenzertifikate aus früheren Verbindungen oder laden sie über die im Zertifikat genannte Adresse nach. Kommandozeilenwerkzeuge, Apps, Mailserver und viele Bibliotheken tun das nicht.
Was bedeutet „Verify return code: 19“?
Die Kette endet bei einem Stammzertifikat, das dein System nicht kennt. Ursache ist entweder eine private CA oder ein Gerät im Netzwerk, das TLS-Verbindungen aufbricht und neu signiert.
Jetzt prüfen

SSL-Zertifikat kostenlos prüfen: Ablaufdatum, Aussteller, Kette, Hostname und TLS-Version, auch am Mailserver. Erkennt abgelaufene und falsche Zertifikate.

DomainWarn prüft die Zertifikate aller Kundendomains regelmäßig, auch auf Mailports, und meldet Ablauf, falsche Hostnamen und unvollständige Ketten, bevor Besucher eine Warnung sehen.

Diese Domain dauerhaft überwachen14 Tage kostenlos testen, keine Kreditkarte.

Weitere Anleitungen