unable to get local issuer certificate: wenn nginx die Zertifikatskette unvollständig sendet

Welche Fehlermeldung zeigt eine unvollständige Kette?

Ein Server mit nginx liefert ein Zertifikat aus, und der Client bricht mit einer Fehlermeldung ab. Die Meldung hängt vom Client ab.

Was zeigt curl?

curl: (60) SSL certificate problem: unable to get local issuer certificate

Was zeigt openssl s_client?

Verify return code: 21 (unable to verify the first certificate)

oder, je nach Kettenform, bei derselben Ursache:

Verify return code: 20 (unable to get local issuer certificate)

Was zeigen Firefox und Chrome?

Firefox:

SEC_ERROR_UNKNOWN_ISSUER

Chrome zeigt sinngemäß NET::ERR_CERT_AUTHORITY_INVALID.

Was melden Java und Android?

Java:

sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

Android:

java.security.cert.CertPathValidatorException: Trust anchor for certification path not found.

Ist es immer eine unvollständige Kette?

Dieselbe curl-Meldung und dieselben openssl-Codes 20 und 21 entstehen auch, wenn der Client der Root nicht vertraut, auf die die gesendete Kette zurückgeht (eigene oder private CA). Liegt nur dieser andere Fall vor, hilft die Root-CA ist dem Client unbekannt. Beide Fälle können auch zugleich vorliegen.

Ob einer der beiden Fälle vorliegt, beide oder keiner von beiden, sagt die Meldung allein nicht; das zeigt die gesendete Kette, wenn der Prüfweg unter „Wie prüfe ich die gesendete Kette?“ zu einer Antwort kommt. Gemessen ist das für curl und openssl. Ob Firefox, Chrome, Java und Android in beiden Fällen dieselbe Meldung zeigen, ist nicht gemessen.

Warum funktioniert es im eigenen Browser und anderswo nicht?

Das ist der Punkt, an dem die Fehlersuche am häufigsten in die falsche Richtung läuft. Man öffnet die Seite im eigenen Desktop-Browser, das Schloss-Symbol ist grün, kein Warnhinweis - und schließt daraus, das Zertifikat sei in Ordnung.

Der Fehler müsse also woanders liegen: am curl-Aufruf, an der Java-Version, an der Android-App. Bei einer unvollständigen Kette ist diese Schlussfolgerung falsch, und zwar aus einem konkreten technischen Grund - der sich je nach Browser sogar unterscheidet, aber im Ergebnis gleich auswirkt.

Im Browser fällt eine fehlende Kette deshalb oft nicht auf: Chrome und Safari holen das Zertifikat nach, Firefox hat das Intermediate vorgeladen oder schon einmal gesehen.

Messung und Randfälle: Wie Browser ein fehlendes Zwischenzertifikat ersetzen
  • Chrome und Safari laden ein fehlendes Zwischenzertifikat unter Umständen automatisch nach: das Leaf-Zertifikat enthält oft eine AIA-Erweiterung (Authority Information Access) mit einer URL, unter der das ausstellende Intermediate-Zertifikat abrufbar ist, und der Browser holt es sich bei Bedarf selbst.
  • Firefox tut das nicht - Mozilla hat ein solches AIA-Nachladen nie umgesetzt. Stattdessen bringt Firefox seit Version 68 einen Vorrat bekannter Zwischenzertifikate über Remote Settings mit und ergänzt ihn um Intermediates aus früheren eigenen Verbindungen zu anderen Servern derselben CA.
  • Greift der jeweilige Weg nicht - etwa weil das Zertifikat keine AIA-URL trägt oder Firefox das Intermediate weder vorgeladen noch schon einmal gesehen hat -, zeigt auch der Browser einen Zertifikatsfehler.
  • Fehlt in der gesendeten Kette das Intermediate-Zertifikat, gibt es bei curl, openssl, der Java-Laufzeit und Android weder einen Nachlade-Mechanismus noch einen mitgebrachten Vorrat, und die Kette bricht ab.

Warum scheitern dann curl, Java und Android?

curl, openssl, die Java-Laufzeit und Android tun keins von beidem im Regelfall. Sie prüfen die gesendete Kette gegen ihren eigenen Trust-Store und holen nichts nach.

Fehlt das Intermediate-Zertifikat, ist der Server tatsächlich falsch konfiguriert; der Browser schließt die Lücke meist selbst.

Warum sendet nginx die Kette unvollständig?

nginx sendet in der TLS-Verbindung genau die Datei, die in ssl_certificate eingetragen ist - nicht mehr und nicht weniger. Es gibt keine eingebaute Logik, die fehlende Zwischenzertifikate ergänzt oder online nachlädt.

Zertifizierungsstellen liefern nach der Ausstellung meist zwei getrennte Dateien aus: das Leaf-Zertifikat (für die eigene Domain) und ein oder mehrere Intermediate-Zertifikate (die Zwischen-CA, die das Leaf signiert hat). Wer nur die erste Datei in ssl_certificate einträgt, liefert ein technisch gültiges, aber unvollständiges Zertifikat aus - ein Client, der die Zwischen-CA nicht bereits kennt, kann die Kette bis zu einer vertrauenswürdigen Root nicht schließen.

Wie muss fullchain.pem aufgebaut sein?

Für die kombinierte Datei, üblicherweise fullchain.pem genannt, gilt eine feste Reihenfolge: zuerst das Leaf-Zertifikat, danach die Intermediates in aufsteigender Reihenfolge (das Zertifikat, das das Leaf signiert hat, dann das nächsthöhere, und so weiter).

Das Root-Zertifikat gehört nicht in diese Datei - es muss beim Client bereits als vertrauenswürdig hinterlegt sein, sonst wäre es ohnehin wertlos, und ein mitgesendetes Root bringt nichts außer zusätzlichen Bytes bei jeder Verbindung.

Wie prüfe ich die gesendete Kette?

Der zuverlässigste Weg ist, die tatsächlich gesendete Kette direkt abzufragen, ohne den Umweg über einen Browser:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null

Die Ausgabe enthält den Block Certificate chain. Jeder Eintrag hat zwei Zeilen: s: nennt, wessen Zertifikat es ist, i: nennt, wer es ausgestellt hat. Eine Messung mit Wegwerf-CA (kein echter Server) zeigt für Blatt und ein Zwischenzertifikat:

Certificate chain
 0 s:CN=localhost
   i:C=DE, O=Wegwerf GmbH, CN=Wegwerf Intermediate
 1 s:C=DE, O=Wegwerf GmbH, CN=Wegwerf Intermediate
   i:C=DE, O=Wegwerf GmbH, CN=Wegwerf Root A
Messung und Randfälle: Schreibweise der Namen
  • Die Schreibweise der Namen hängt vom openssl-Programm ab.
  • Gemessen sind OpenSSL 3.6.4 (C=DE, O=Wegwerf GmbH, CN=...) und LibreSSL 3.3.6 (/C=DE/O=Wegwerf GmbH/CN=...).
  • Wie andere Versionen schreiben, ist nicht gemessen.

Wie lese ich die Kette?

Die Kette wird in drei Schritten gelesen, in dieser Reihenfolge.

Schritt 1: Welcher gesendete Eintrag kommt als Nächstes?

Der Kette vom Blatt aus folgen. Bei Eintrag 0 beginnen. Genau einen noch nicht besuchten Eintrag suchen, dessen s: gleich der i:-Zeile des aktuellen Eintrags ist. Die so besuchten Einträge sind der Pfad.

  • Das Suchen wiederholt man, bis kein solcher Eintrag mehr passt oder ein Eintrag erreicht ist, dessen s: und i: gleich sind (gleiche Namen belegen noch keine Root, siehe Schritt 2).
  • Passen mehrere Einträge, gibt der Prüfweg keine Antwort (dann bleibt nur Verify return code).
  • Zu einem passenden Eintrag geht man erst weiter, wenn er den aktuellen Eintrag nachweislich signiert hat (Nachweis „Erstens“ unter „Hat der Aussteller den Vorgänger wirklich signiert?“). Der Nachweis läuft mit dem PEM-Block des aktuellen Eintrags als vorgaenger.pem und dem PEM-Block des passenden Eintrags als aussteller.pem, beide aus der -showcerts-Ausgabe.
  • Scheitert der Nachweis mit Fehler 20 oder 7, liegt der Eintrag nicht auf dem Pfad, auch wenn sein Name passt (etwa ein fremdes selbstsigniertes Zertifikat mit dem Namen des Ausstellers). Der Pfad endet dann beim aktuellen Eintrag, wie bei einem Aussteller, den die gesendeten Einträge nicht enthalten, und es geht mit Schritt 3 weiter.
Messung und Randfälle: Schritt 1 im Einzelnen
  • Passen mehrere Einträge, zeigt Verify return code, ob der Client die Kette schließt, aber nicht, welcher Fall vorliegt.
  • Jede andere Meldung des Nachweises beantwortet die Frage nicht, und der Prüfweg gibt keine Antwort (siehe „Erstens“).
  • Einträge, die nicht auf dem Pfad liegen, tragen zur Kette nichts bei.
  • Taucht ein schon besuchter Eintrag ein zweites Mal auf (die Folge läuft im Kreis), gibt der Prüfweg ebenfalls keine Antwort. Solche Ketten sind nicht gemessen.
  • Eine gebrochene Folge allein sagt nicht, ob eine Stufe fehlt: Was nach dem Bruch steht, kann ein Zertifikat einer anderen Kette sein, und ein Aussteller, der weiter unten als s: steht, kann seinerseits auf eine fehlende Stufe zeigen.
  • Das entscheiden erst die Schritte 2 und 3, angewandt auf das letzte Glied des Pfads.

Schritt 2: Endet der Pfad bei einem Eintrag, dessen s: und i: gleich sind?

Dann prüft diese Zeile für den als eintrag.pem gespeicherten PEM-Block des Eintrags, ob die Selbstsignatur trägt. Sie läuft mit demselben openssl-Programm wie s_client; der Block stammt aus der -showcerts-Ausgabe (von -----BEGIN CERTIFICATE----- bis -----END CERTIFICATE-----):

openssl verify -check_ss_sig -CAfile eintrag.pem eintrag.pem
  • Meldet sie eintrag.pem: OK (Exit-Code 0), ist es eine Root oder ein selbstsigniertes Blatt.
  • Steht im Trust-Store des Clients ein Zertifikat mit diesem Namen (Block weiter unten), ist ein Zertifikat dieses Namens vertraut. Ob der Client die Kette damit schließt, zeigt Verify return code (solange Sie in Schritt 3 noch kein Zertifikat besorgt haben; danach siehe das Ende von Schritt 3).
  • Bei 0 (ok) ist die Kette vollständig. Bei einer anderen Zahl ist es nicht das Zertifikat, das die Kette schließt (etwa weil unter dem Namen nur ein Zertifikat mit anderem Schlüssel steht), oder die Ursache liegt außerhalb beider Fälle, und der Prüfweg gibt keine Antwort.
  • Steht kein Zertifikat mit diesem Namen im Trust-Store des Clients, fehlt dem Client das Vertrauen und dem Server keine Stufe: das ist der Fall der fremden oder eigenen Root (eigene oder private CA, selbstsigniert), siehe wenn die Root-CA dem Client unbekannt ist.
  • Meldet sie in Tiefe 0 einen Fehler 7 (certificate signature failure) oder 20 (unable to get local issuer certificate), ist die Selbstsignatur nicht bestätigt; mehr sagt die Meldung nicht. Werten Sie den Eintrag dann nicht als Root, sondern gehen Sie mit Schritt 3 weiter, mit dem Namen aus der i:-Zeile dieses Eintrags als Aussteller.
Messung und Randfälle: Schritt 2 im Einzelnen
  • Gleiche Namen heißen nur, dass der Eintrag unter seinem eigenen Namen ausgestellt ist (self-issued, RFC 5280, Abschnitt 3.2), nicht, dass er sich selbst signiert hat: Bei einem Schlüsselwechsel kann eine CA ein neues Zertifikat unter demselben Namen ausstellen, signiert mit ihrem alten Schlüssel.
  • Ob nach einem Fehler 7 oder 20 ein Zertifikat mit demselben Namen fehlt, das den Eintrag signiert hat, zeigt erst die Prüfung gegen den besorgten Aussteller; lässt sich keiner besorgen, gibt der Prüfweg keine Antwort.
  • Jede andere Meldung, etwa ein abgelaufenes Zertifikat (Fehler 10), beantwortet die Frage nicht; dann gibt der Prüfweg keine Antwort.
Messung und Randfälle: Selbstsignatur-Prüfung

Gemessen ist das mit einer Wegwerf-PKI (Root, altes CA-Zertifikat, neues CA-Zertifikat unter demselben Namen mit dem alten Schlüssel signiert, Blatt darunter), mit OpenSSL 3.6.4 und LibreSSL 3.3.6 als Client:

  • Sendet der Server Blatt und neues CA-Zertifikat ohne das alte, meldet s_client den Code 20, die Zeile oben für das neue CA-Zertifikat den Fehler 20, für eine gesendete Root und für ein selbstsigniertes Blatt OK.
  • Trägt das neue CA-Zertifikat keine Authority-Key-Identifier-Erweiterung, meldet s_client den Code 19 (self-signed certificate in certificate chain), obwohl nichts sich selbst signiert hat, und openssl verify meldet ohne -check_ss_sig für diesen Eintrag OK; deshalb der Schalter.
  • Die Zeile oben meldet für diesen Eintrag den Fehler 7, mit beiden Programmen; in der vollständigen Meldung stehen dabei auch Fehlerzeilen der rsa routines (bei OpenSSL 3.6.4 wie bei LibreSSL 3.3.6).
  • Ein Fehler 7 belegt keinen fehlenden Aussteller: Bei einer Selbstsignatur, in der ein Byte geändert ist, meldet die Zeile oben ebenfalls den Fehler 7, s_client den Code 18 (self-signed certificate), und openssl verify ohne -check_ss_sig meldet OK.
  • Sendet der Server beide CA-Zertifikate, meldet s_client den Code 0; dann passen für die i:-Zeile des Blatts zwei Einträge, und Schritt 1 gibt keine Antwort.
  • Andere Versionen und Clients sind nicht gemessen.

Schritt 3: Was, wenn der Aussteller nicht gesendet wurde?

Sonst endet der Pfad bei einem Aussteller, den die gesendeten Einträge nicht enthalten. Ein Eintrag, der den Namen des Ausstellers trägt, aber im Nachweis (Fehler 20 oder 7) nicht als Signierer bestätigt wird, gilt als nicht enthalten.

  • Steht im Trust-Store des Clients ein Zertifikat mit dem Namen aus der letzten i:-Zeile des Pfads, ist ein Zertifikat dieses Namens vertraut.
  • Ob der Client die Kette damit schließt, zeigt Verify return code (solange Sie noch nichts besorgt haben; danach siehe das Ende dieses Schritts): bei 0 (ok) ist die Kette vollständig, bei einer anderen Zahl gibt der Prüfweg keine Antwort (etwa weil unter dem Namen nur ein Zertifikat mit anderem Schlüssel steht).
  • Steht kein Zertifikat dieses Namens im Trust-Store des Clients, entscheidet, was dieser Aussteller ist. Das zeigt erst sein Zertifikat, das Sie dazu besorgen müssen (wie, steht unter „Wie besorge ich das Zertifikat des Ausstellers?“).
  • Eine Root, deren Selbstsignatur bestätigt ist und der der Client nicht vertraut: dann ist es der Fall der fremden oder eigenen Root, siehe wenn die Root-CA dem Client unbekannt ist.
  • Ein Zwischenzertifikat: dann fehlt es auf dem Server, und das ist das fehlende Zwischenzertifikat. Ob der Client der Kette danach vertraut, ist damit noch nicht gesagt.

Schritt 3 (Fortsetzung): Wie geht es weiter, wenn das Zertifikat besorgt ist?

  • Das besorgte Zertifikat ist, nach dem Nachweis (siehe „Hat der Aussteller den Vorgänger wirklich signiert?“), das nächste Glied der Kette. Suchen Sie dessen Aussteller zuerst in der Liste der gesendeten Einträge, unter den noch nicht besuchten, und gehen Sie dort wie in Schritt 1 weiter, einschließlich des Nachweises: Das besorgte Zertifikat ist dabei vorgaenger.pem.
  • Ein Aussteller fehlt auf dem Server, wenn kein Eintrag der Liste seinen Namen trägt oder der Eintrag, der ihn trägt, nicht sein Signierer ist (Fehler 20 oder 7 im Nachweis); den besorgen Sie auf demselben Weg, und so geht es weiter.
  • Am Ende entscheidet der Trust-Store wie in den Schritten 2 und 3: Steht darin ein Zertifikat mit dem Namen des letzten Ausstellers oder der letzten Root, ist die Kette mit den nachgetragenen Zwischenzertifikaten vollständig, sofern es dasselbe Zertifikat ist. Ob der Client sie dann schließt, zeigt Verify return code nach dem Nachtragen („Wie behebe ich es?“, fünftens).
  • Bis dahin entscheidet der aktuelle Verify return code nichts: Sobald Sie ein Zertifikat besorgt haben, ist er nicht 0 (jede Zeile „fehlendes Zwischenzertifikat“ der Tabelle zeigt eine andere Zahl), und es zählt der Code nach dem Nachtragen.
  • Ist nachgewiesen, dass ein Zwischenzertifikat fehlte, und endet die Kette nach dem Nachtragen bei einer Root, der der Client nicht vertraut, liegen beide Fälle zugleich vor: die Zwischenzertifikate sind nachzutragen und das Vertrauen zu klären.
Messung und Randfälle: Schritt 3 im Einzelnen
  • Ein Zwischenzertifikat mit gleichem Subject und Issuer gilt erst als fehlend, wenn ein weiteres besorgtes Zertifikat es nachweislich signiert hat (siehe „Zweitens“ weiter unten).
  • Zum Pfadende gehört auch ein Eintrag, der seinen Namen trägt, aber nicht sein Signierer ist (Fehler 20 oder 7 im Nachweis von Schritt 1): Er gilt als nicht enthalten. Dasselbe gilt für einen Eintrag, dessen Selbstsignatur Schritt 2 nicht bestätigt hat; sein Aussteller trägt dann denselben Namen wie er selbst, ist aber ein anderes Zertifikat.
  • Ob der Server dieses Zertifikat nur nicht gesendet hat, steht damit noch nicht fest: Ein Fehler 7 aus Schritt 2 kann auch ein beschädigtes Zertifikat anzeigen, zu dem es gar keinen Aussteller gibt (dann gibt der Prüfweg keine Antwort).
  • Taucht dabei ein Zertifikat ein zweites Mal auf, oder passen mehrere noch nicht besuchte Einträge, gibt der Prüfweg auch hier keine Antwort (siehe Schritt 1).
  • Lässt sich das Zertifikat eines Ausstellers nicht besorgen, gibt der Prüfweg ebenfalls keine Antwort; dann bleibt nur Verify return code, mit derselben Grenze.

Was, wenn die Datei falsch sortiert ist?

Liegen die Pfad-Einträge nicht als Einträge 0, 1, 2 … direkt hintereinander am Anfang der Liste, ist die Datei falsch sortiert; die Behebung ist „Wie behebe ich es?“, zweitens (die Kette in der richtigen Reihenfolge zusammensetzen). Das gilt auch neben den anderen Fällen: fehlt zusätzlich ein Zwischenzertifikat oder vertraut der Client der Root nicht, ist zusätzlich zu sortieren.

Steht der Aussteller im Trust-Store des Clients?

Ob ein Name im Trust-Store steht, zeigt dieser Block. Der Name steht dabei in einem Here-Document statt im Befehl, denn ein Apostroph im Namen (etwa O=Let's Encrypt) beendet sonst die Zeichenkette in der Shell:

openssl crl2pkcs7 -nocrl -certfile ca-bundle.pem | openssl pkcs7 -print_certs -noout | grep -c '^subject='
read -r issuer <<'EOF'
C=DE, O=Wegwerf GmbH, CN=Wegwerf Intermediate
EOF
openssl crl2pkcs7 -nocrl -certfile ca-bundle.pem | openssl pkcs7 -print_certs -noout | sed 's/[[:space:]]*$//' | grep -Fx -- "subject=$issuer"
  • ca-bundle.pem ist die CA-Bündeldatei, gegen die der Client prüft. Wo sie liegt, legt der Client fest; bei curl und openssl lässt sie sich mit --cacert und -CAfile vorgeben.
  • Die erste Zeile ist die Kontrolle und muss eine Zahl größer 0 liefern. Bei 0 hat der Befehl nichts gelesen (gemessen bei leerer Datei und bei falschem Dateipfad), und ein leeres Ergebnis der letzten Zeile sagt dann nichts.
  • Ersetzen Sie die Beispielzeile zwischen <<'EOF' und EOF durch den Text hinter i: aus der letzten i:-Zeile des Pfads, Zeichen für Zeichen; der Block lässt sich dann am Stück einfügen.
  • Eine ausgegebene Zeile heißt: der Name steht im Bündel, bis auf Leerraum am Ende. Keine Ausgabe heißt: er steht nicht darin.
  • Beide openssl-Zeilen mit demselben openssl-Programm laufen lassen wie s_client.
Messung und Randfälle: Eingabe, Leerraum und Sonderzeichen im Namensvergleich
  • Der Name steht im Befehl selbst, read wartet auf keine Eingabe und kann keine Zeile der Folge verschlucken.
  • Eine eigene Zeile read -r issuer, die auf Eingabe wartet, würde beim Einfügen am Stück die nächste Zeile als Namen lesen; die Prüfzeile liefe nicht, und ausgegeben würde nur die Kontrollzahl (gemessen). Das wäre ein stilles Ergebnis, das wie „nicht gefunden“ aussieht.
  • read -r übernimmt einen Backslash buchstäblich und entfernt führenden und nachgestellten Leerraum des Textes, etwa ein beim Kopieren mitgenommenes Leerzeichen; Leerraum im Innern des Namens bleibt.
  • Das sed entfernt Leerraum am Ende der Zeilen des Bündels, damit auch ein Name gefunden wird, der selbst mit einem Leerzeichen endet (gemessen mit CN= Wegwerf Rand CA ).
  • Wegen des Here-Documents mit 'EOF' wertet die Shell den Text nicht aus, ein $ oder ein Backslash im Namen bleibt also buchstäblich erhalten. -Fx vergleicht die ganze Zeile als festen Text, nicht als Muster.
  • Der Preis: Zwei Namen, die sich nur im Leerraum am Ende unterscheiden, trennt der Vergleich nicht (gemessen: die Eingabe mit Leerzeichen am Ende findet ein Bündel, das nur den Namen ohne enthält, und umgekehrt).
  • Mit IFS= read -r ohne das sed wäre es andersherum: der Name mit Leerzeichen am Ende würde gefunden, ein beim Kopieren mitgenommenes Randleerzeichen ließe aber den Treffer ausfallen, und der Befehl gäbe nichts aus, obwohl der Name im Bündel steht; read -r allein, ohne das sed, verfehlte dagegen einen Namen, der selbst mit Leerraum endet.
Messung und Randfälle: Gemessene Namensformen im Namensvergleich

Gemessen heißt das, in bash 3.2 und zsh 5.9, mit OpenSSL 3.6.4 und LibreSSL 3.3.6, gegen Testbündel mit Wegwerf-Zertifikaten, mit dem ganzen Block als ein Stück über eine Pipe an die Shell:

  • Ein Name mit Apostroph (Let's Encrypt, in einem zweiten Fall zwei Apostrophe) wird gefunden, und fehlt er im Bündel, kommt keine Ausgabe.
  • Ein Name, der nur Anfang eines längeren ist (Wegwerf Intermediate gegen Wegwerf Intermediate Backup), und ein Name mit Sonderzeichen wie Wegwerf CA (Test) 1.0 neben einem Doppelgänger (1x0) liefern keine falschen Treffer.
  • Ein Name mit $WEGWERF_X oder mit einem Backslash wird buchstäblich verglichen und nicht ausgewertet.
  • Ein Name mit zwei Leerzeichen im Innern (Wegwerf CA) wird gefunden, und ein eingegebenes Leerzeichen vor oder hinter dem Namen ändert das Ergebnis nicht.
  • Ein Name, der selbst mit einem Leerzeichen endet, wird gefunden, und fehlt er im Bündel, kommt keine Ausgabe.
  • Nicht gemessen sind Namen mit Leerraum direkt hinter subject=.
Messung und Randfälle: openssl-Programme und Namenstreffer
  • Gemessen stimmen die i:-Zeile aus s_client und die subject=-Zeile zeichengenau überein, wenn beide vom selben Programm kommen (OpenSSL 3.6.4 oder LibreSSL 3.3.6); mischt man die beiden Programme, weichen sie ab, weil sie die Namen verschieden schreiben.
  • Die Zeilen sind gegen Testbündel gemessen, mit beiden Programmen; gegen System-Bündel ist der Block nicht gemessen, und das Einfügen in ein Terminalfenster auch nicht (der Block kam über eine Pipe an die Shell). Für die Trust-Stores von Browsern, Java und Android sind sie nicht gemessen.
  • Der Namensvergleich ersetzt nicht die Prüfung des Clients: Ob der Client die Kette schließt, zeigt erst die Zeile Verify return code (siehe unten); welcher Fall vorliegt, zeigt sie nicht.
  • Ein Namenstreffer belegt auch nicht den Schlüssel: Gemessen findet der Block (mit OpenSSL 3.6.4 und LibreSSL 3.3.6) den Namen einer Root auch dann, wenn der Trust-Store unter diesem Namen eine Root mit einem anderen Schlüssel enthält, und openssl verify (OpenSSL 3.6.4) gegen diesen Trust-Store meldet für Blatt und Zwischenzertifikat den Fehler 20 (unable to get local issuer certificate); mit der richtigen Root meldet es OK.

Wie besorge ich das Zertifikat des Ausstellers?

Ob der Aussteller eine Root oder ein Zwischenzertifikat ist, zeigt s_client nicht, weil der Server sein Zertifikat nicht sendet. Es steht in seinem eigenen Zertifikat, das Sie besorgen müssen: bei einer öffentlichen CA über die AIA-Angabe CA Issuers im Zertifikat des letzten Pfad-Eintrags (Befehl unter „Wie behebe ich es?“, erstens, dort für das Blatt) oder von der Webseite der CA, bei einer eigenen CA hat man es ohnehin.

Für den Nachweis speichern Sie das Zertifikat, das der Aussteller sein soll, als PEM-Datei aussteller.pem und das Zertifikat, dessen Aussteller es sein soll, als vorgaenger.pem. Beides läuft mit demselben openssl-Programm wie s_client; nur der Nachweis nicht, denn LibreSSL 3.3.6 kennt -partial_chain nicht (Einzelheiten unter „Andere Meldungen des Nachweises“). Für jedes weitere Glied, das Schritt 3 verlangt, gilt dasselbe.

Messung und Randfälle: Was vorgaenger.pem und aussteller.pem sind
  • Der Nachweis wird an zwei Stellen gebraucht: in Schritt 1 für einen gesendeten Eintrag, der nach Namen passt, und in Schritt 3 für ein besorgtes Zertifikat. In beiden Fällen ist aussteller.pem der passende gesendete Eintrag oder das besorgte Zertifikat.
  • vorgaenger.pem ist immer das bisher letzte Glied des Pfads, das Zertifikat, dessen Aussteller gesucht wird, gleich ob es gesendet oder besorgt wurde: der PEM-Block eines gesendeten Eintrags aus der -showcerts-Ausgabe oder das zuletzt besorgte Zertifikat.
  • Ein Zertifikat zählt erst dann als nächstes Glied des Pfads, wenn es vorgaenger.pem nachweislich signiert hat; ein besorgtes wird danach eingeordnet.

Hat der Aussteller den Vorgänger wirklich signiert?

Erstens der Nachweis, dass aussteller.pem den Vorgänger signiert hat:

openssl verify -partial_chain -CAfile aussteller.pem vorgaenger.pem
  • Meldet sie vorgaenger.pem: OK (Exit-Code 0), ist aussteller.pem ein Glied der Kette.
  • Meldet sie in Tiefe 0 einen Fehler 20 (unable to get local issuer certificate) oder 7 (certificate signature failure), ist aussteller.pem nicht der Aussteller des Vorgängers, auch wenn sein Name zur i:-Zeile des Vorgängers passt. Bei einem gesendeten Eintrag (Schritt 1) heißt das, dass er nicht auf dem Pfad liegt und es mit Schritt 3 weitergeht; bei einem besorgten Zertifikat (Schritt 3) gibt der Prüfweg keine Antwort.
  • Jede andere Meldung beantwortet die Frage nicht, und der Prüfweg gibt keine Antwort.
Messung und Randfälle: Andere Meldungen des Nachweises
  • Ein Zertifikat mit gleichem Namen muss den Vorgänger nicht signiert haben (Schlüsselwechsel, ein Zertifikat einer anderen Kette, ein fremdes selbstsigniertes Zertifikat mit gleichem Namen).
  • Bei einer anderen Meldung gibt der Prüfweg keine Antwort, bei einem gesendeten Eintrag wie bei einem besorgten Zertifikat.
  • Fehler 79 (invalid CA certificate, in Tiefe 1 gemeldet) sagt, dass aussteller.pem den Vorgänger signiert hat, aber kein CA-Zertifikat ist.
  • Fehler 18 (self-signed certificate) sagt, dass der Vorgänger selbst self-issued ist (etwa ein beschädigtes selbstsigniertes Zertifikat).
  • Ein abgelaufenes Zertifikat (Fehler 10) sagt nichts darüber, wer signiert hat.
  • Ohne -partial_chain nimmt openssl verify nur eine Root als Vertrauensanker; mit einem Zwischenzertifikat als aussteller.pem scheitert die Zeile dann mit Fehler 2 (gemessen).
  • LibreSSL 3.3.6 kennt -partial_chain nicht: Die Zeile liest nur Zertifikatsdateien und gibt keine Namen aus, ein OpenSSL 3.x führt sie deshalb auch dann aus, wenn s_client von LibreSSL kam.

Ist es eine Root oder ein Zwischenzertifikat?

Zweitens die Einordnung, erst nach dem Nachweis. Haben Subject und Issuer von aussteller.pem verschiedene Namen, ist es ein Zwischenzertifikat und fehlt auf dem Server. Haben sie gleiche Namen, genügt das nicht, um es eine Root zu nennen (self-issued, siehe Schritt 2); dann prüft diese Zeile die Selbstsignatur:

openssl verify -check_ss_sig -CAfile aussteller.pem aussteller.pem
  • Meldet sie aussteller.pem: OK, ist es eine Root (oder ein selbstsigniertes Blatt).
  • Meldet sie in Tiefe 0 einen Fehler 7 oder 20, ist die Selbstsignatur nicht bestätigt, und die Einordnung bleibt offen: Das Zertifikat kann ein Zwischenzertifikat sein, das ein anderes Zertifikat mit demselben Namen signiert hat. Besorgen Sie dieses Zertifikat, speichern Sie es als aussteller.pem (das bisherige wird zu vorgaenger.pem) und beginnen Sie wieder bei „Erstens“.
Messung und Randfälle: Wenn die Selbstsignatur nicht bestätigt ist
  • Gelingt der Nachweis dort, ist das bisherige Zertifikat ein Zwischenzertifikat, das auf dem Server fehlt, und das neue das nächste Glied (weiter mit Schritt 3).
  • Gelingt er nicht oder lässt sich kein solches Zertifikat besorgen, gibt der Prüfweg keine Antwort.
  • Jede andere Meldung der Selbstsignatur-Zeile, etwa ein abgelaufenes Zertifikat (Fehler 10), beantwortet die Frage ebenfalls nicht; dann gibt der Prüfweg keine Antwort.
Messung und Randfälle: Nachweis und Einordnung des Ausstellers, Ende zu Ende

Gemessen ist das von Ende zu Ende mit der Wegwerf-PKI aus Schritt 2 (Root, altes und neues CA-Zertifikat unter demselben Namen, Zwischenzertifikat, Blätter darunter), mit OpenSSL 3.6.4 und LibreSSL 3.3.6 als Programm für die Einordnung und OpenSSL 3.6.4 für den Nachweis; beide Läufe liefern dasselbe.

Die Selbstsignatur-Zeile meldet für eine Root und für ein selbstsigniertes Blatt OK, für das neue CA-Zertifikat unter demselben Namen Fehler 20 und für ein selbstsigniertes Zertifikat mit einem geänderten Byte Fehler 7.

  1. Sendet der Server ein Zertifikat mit beschädigter Selbstsignatur (ein Byte geändert) und wird sein unbeschädigtes Original besorgt (gleicher Name, gleicher Schlüssel), meldet der Nachweis Fehler 18 und Exit-Code 2: keine Antwort.
  2. Sendet der Server das neue CA-Zertifikat und wird das alte besorgt, meldet der Nachweis OK; das alte ist ein Zwischenzertifikat und fehlt. Wird danach dessen Root besorgt, meldet der Nachweis wieder OK, und sie ist eine Root.
  3. Fehlt einem Blatt sein Zwischenzertifikat und wird es besorgt, meldet der Nachweis OK; es fehlt.
  4. Ist der besorgte Aussteller eine Root, die der Client nicht vertraut, meldet der Nachweis OK, und sie ist eine Root: der Fall der fremden oder eigenen Root.
Messung und Randfälle: Nachweis und Einordnung des Ausstellers, Fälle ohne Antwort

Keine Antwort mit Exit-Code 2 meldet der Nachweis außerdem in diesen Fällen:

  • Das besorgte Zertifikat trägt einen anderen Namen und hat den Vorgänger nicht signiert (Fehler 20).
  • Es trägt den Namen des richtigen, aber einen anderen Schlüssel (Fehler 20).
  • Es hat den Vorgänger zwar signiert, ist aber kein CA-Zertifikat (Fehler 79, invalid CA certificate).
  • Beim weiteren Besorgen kommt eine Root mit dem Namen, aber nicht mit dem Schlüssel der richtigen (Fehler 20).
Messung und Randfälle: Nachweis und Einordnung des Ausstellers, Fall 5

Drei weitere Formen, gebaut in einer Wegwerf-PKI (EC-Schlüssel; eine Root mit getrennten Zweigen, dazu das fremde selbstsignierte Zertifikat aus Fall 5; OpenSSL 3.6.4 und LibreSSL 3.3.6 als Client, der Nachweis mit OpenSSL 3.6.4, mit beiden dieselben Verdikte):

Fall 5: Der Server sendet das Blatt und ein fremdes selbstsigniertes Zertifikat, das den Aussteller-Namen des Blatts trägt (anderer Schlüssel), das echte Zwischenzertifikat fehlt, und der Client vertraut der Root:

  • s_client meldet Code 21 (bei einem Blatt ohne Authority-Key-Identifier-Erweiterung: Code 7 mit OpenSSL 3.6.4, Code 19 mit LibreSSL 3.3.6).
  • Der Nachweis aus Schritt 1 (fremder Eintrag als aussteller.pem, Blatt als vorgaenger.pem) meldet Fehler 20 und Exit-Code 2 (ohne die Erweiterung Fehler 7), der fremde Eintrag liegt also nicht auf dem Pfad.
  • Schritt 3 besorgt das echte Zwischenzertifikat, der Nachweis meldet OK, und das ist der Fall des fehlenden Zwischenzertifikats; openssl verify gegen die Root meldet mit dem echten Zwischenzertifikat OK und mit dem fremden Fehler 20.
  • Ohne den Nachweis endet die Lesart beim fremden Zertifikat im Fall der fremden oder eigenen Root (-check_ss_sig meldet OK, der Name steht nicht im Trust-Store).
  • Lässt sich das echte Zwischenzertifikat nicht besorgen, oder ist das einzige besorgbare Zertifikat unter diesem Namen das fremde (sein Nachweis scheitert), gibt der Prüfweg keine Antwort.
  • Wird stattdessen das echte Zwischenzertifikat gesendet, meldet s_client Code 0 und der Nachweis OK.
Messung und Randfälle: Nachweis und Einordnung des Ausstellers, Fall 6

Fall 6: Die Kette ist Root, I3, I2, I1, Blatt, der Server sendet das Blatt und I2, und der Client vertraut der Root:

  • s_client meldet Code 21, der Nachweis meldet OK für I1 gegen das Blatt, für I2 gegen I1 und für I3 gegen I2, und I1 und I3 fehlen: der Fall des fehlenden Zwischenzertifikats.
  • Mit dem zuvor besorgten I1 als vorgaenger.pem für I3 meldet der Nachweis Fehler 20 und Exit-Code 2.
  • Werden I1, I2 und I3 gesendet, meldet s_client Code 0.
Messung und Randfälle: Nachweis und Einordnung des Ausstellers, Fall 7

Fall 7: Der Server sendet das Blatt und ein Zertifikat mit dem Aussteller-Namen, das das Blatt signiert hat, aber kein CA-Zertifikat ist (ein CA-Zertifikat mit gleichem Schlüssel und Namen lässt sich besorgen), und der Client vertraut der Root:

  • s_client meldet Code 26 mit OpenSSL 3.6.4 und Code 24 mit LibreSSL 3.3.6, und der Nachweis aus Schritt 1 meldet Fehler 79 in Tiefe 1 und Exit-Code 2, der Prüfweg gibt also keine Antwort.
  • Eine Lesart, die jeden gescheiterten Nachweis als „nicht auf dem Pfad“ nähme, besorgte in Schritt 3 das CA-Zertifikat und läse hier „fehlendes Zwischenzertifikat“.
Messung und Randfälle: Nachweis und Einordnung des Ausstellers, Grenzen
  • Die Kette aus Schritt 2 mit beiden gesendeten CA-Zertifikaten gibt weiter keine Antwort, weil zwei Einträge nach Namen passen, bevor der Nachweis erreicht wird (s_client Code 0).
  • Nicht gemessen sind ein besorgtes Zertifikat ohne Authority-Key-Identifier-Erweiterung, eine öffentliche CA und, in Schritt 1, ein nach Namen passender Eintrag, dessen Nachweis eine andere Meldung als Fehler 20, 7 oder 79 gibt (etwa ein abgelaufenes Zertifikat, Fehler 10); nach der Regel gibt der Prüfweg dort keine Antwort.

Was sagt der Verify return code?

Am Ende der Ausgabe steht die Zeile Verify return code. 0 (ok) heißt: der Client hat die Kette geschlossen. Jede andere Zahl heißt: er hat es nicht, aber ob einer der beiden Fälle vorliegt, beide zugleich oder die Ursache außerhalb beider Fälle liegt, sagt die Zahl nicht:

FallKettenform (was der Server sendet; wem der Client vertraut)openssl-Codecurl (Exit-Code)
vollständigBlatt + Zwischenzertifikat; Root vertraut0 (ok)0
vollständigBlatt + zwei Zwischenzertifikate; Root vertraut0 (ok)0
vollständigBlatt + Zwischenzertifikat + Root mitgesendet; Root vertraut0 (ok)0
vollständignur Blatt, direkt von einer Root ausgestellt; Root vertraut0 (ok)0
vollständignur Blatt, selbstsigniert; als vertraut hinterlegt0 (ok)0
fehlendes Zwischenzertifikatnur Blatt, Zwischenzertifikat fehlt; Root vertraut21 (unable to verify the first certificate)60
fehlendes ZwischenzertifikatBlatt + unteres von zwei Zwischenzertifikaten, oberes fehlt; Root vertraut20 (unable to get local issuer certificate)60
fehlendes ZwischenzertifikatBlatt + oberes von zwei Zwischenzertifikaten, unteres fehlt; Root vertraut21 (unable to verify the first certificate)60
fehlendes ZwischenzertifikatBlatt + Root, Zwischenzertifikat dazwischen fehlt; Root vertraut21 (unable to verify the first certificate)60
fehlendes ZwischenzertifikatBlatt + oberstes und unteres von drei Zwischenzertifikaten, mittleres fehlt; Root vertraut20 (unable to get local issuer certificate)60
fehlendes Zwischenzertifikat und fremde/eigene RootBlatt + unteres von zwei Zwischenzertifikaten, oberes fehlt; Root nicht vertraut20 (unable to get local issuer certificate)60
falsch sortiertBlatt + beide Zwischenzertifikate, in vertauschter Reihenfolge; Root vertraut0 (ok)0
fremde/eigene RootBlatt + Zwischenzertifikat; Root nicht vertraut20 (unable to get local issuer certificate)60
fremde/eigene Rootnur Blatt, direkt von einer Root ausgestellt; Root nicht vertraut21 (unable to verify the first certificate)60
fremde/eigene RootBlatt + Zwischenzertifikat + Root mitgesendet; Root nicht vertraut19 (self-signed certificate in certificate chain)60
fremde/eigene Rootnur Blatt, selbstsigniert; nicht vertraut18 (self-signed certificate)60
fremde/eigene RootBlatt + Zwischenzertifikat einer fremden Kette; Root des Blatts nicht vertraut21 (unable to verify the first certificate)60
fremde/eigene RootBlatt + fremde Root mitgesendet, die der Client vertraut; Root des Blatts nicht vertraut21 (unable to verify the first certificate)60
fremde/eigene RootBlatt + beide Zwischenzertifikate, in vertauschter Reihenfolge; Root nicht vertraut20 (unable to get local issuer certificate)60

In der Tabelle heißt eine Zeile nur dann „falsch sortiert“, wenn die Kette sonst vollständig wäre.

Messung und Randfälle: Messaufbau und Zeilen der Tabelle

Zum Messaufbau und zu den einzelnen Zeilen:

  • Gemessen mit OpenSSL 3.6.4 (s_client) und curl 8.7.1 (SecureTransport, LibreSSL 3.3.6) auf macOS (Darwin arm64).
  • Der Client prüfte nicht gegen den System-Trust-Store, sondern nur gegen die Wegwerf-Root (s_client mit -CAfile <Wegwerf-Root> -no-CApath -no-CAstore, curl mit --cacert <Wegwerf-Root>); der Server war openssl s_server, nicht nginx.
  • Die Spalte „Fall“ ist die Lesart oben, angewandt auf die gesendete Kette.
  • Der Nachweis in Schritt 1 ändert keine Zeile: Alle 19 Kettenformen sind noch einmal durch die ganze Lesart gelaufen, mit OpenSSL 3.6.4 und mit LibreSSL 3.3.6 als Client (der Nachweis mit OpenSSL 3.6.4), und jede behält ihren Fall und ihren Code; bei 12 der 19 betritt der Pfad in Schritt 1 einen gesendeten Eintrag nach Namen und führt dort den Nachweis, und bei keiner der 19 scheitert dieser Nachweis.
  • Ketten, bei denen der Prüfweg keine Antwort gibt (mehrere passende Einträge, ein Kreis, ein Ausstellerzertifikat, das sich nicht besorgen lässt oder dessen Nachweis scheitert), stehen nicht in der Tabelle; dort bleibt nur Verify return code, mit derselben Grenze.
  • Der Code allein trennt die Fälle nicht: 21 steht bei „fehlendes Zwischenzertifikat“ und bei „fremde/eigene Root“, ebenso 20, auch in der Zeile, in der beides zugleich zutrifft, und bei 20 und 21 lautet die curl-Meldung in allen gemessenen Zeilen unable to get local issuer certificate.
  • Die Zeile „falsch sortiert“: die s:/i:-Folge ist in der Listenreihenfolge gebrochen, der Pfad vom Blatt aus findet aber alle Zertifikate, und OpenSSL 3.6.4 wie curl 8.7.1 nahmen die Kette an. Strengere Clients sind nicht gemessen. In richtiger Reihenfolge (zweite Zeile der Tabelle) lautet der Code ebenfalls 0.
  • Die Zeile mit drei Zwischenzertifikaten ist der Gegenfall: Die Folge ist gebrochen, und der Aussteller des Blatts steht weiter unten als s: (Eintrag 2), trotzdem fehlt eine Stufe, denn nach Eintrag 2 folgt ein Aussteller, den niemand sendet.
  • Es fehlt das mittlere der drei Zertifikate; dessen Aussteller steht als Eintrag 1 in der Liste. Der Pfad läuft dort über die Einträge 0 und 2 und, nach dem fehlenden Zertifikat, über Eintrag 1, die Datei ist also zusätzlich falsch sortiert.
  • In der Zeile „fehlendes Zwischenzertifikat und fremde/eigene Root“ trifft beides zugleich zu: Die Folge bricht beim fehlenden Zwischenzertifikat, und die Root darüber, auf die die Kette zurückgeht, vertraut der Client nicht. Gemessen scheitert dort auch openssl verify gegen denselben Trust-Store mit allen Zwischenzertifikaten der Wegwerf-CA; das Nachtragen des Zwischenzertifikats allein behebt den Fehler also nicht.
  • In der letzten Zeile ist die Datei zusätzlich falsch sortiert (der Pfad läuft über die Einträge 0, 2, 1), und der Client vertraut der Root nicht: das ist der Fall der fremden oder eigenen Root.
  • In den beiden Zeilen mit einem fremden Zertifikat liegt der zweite Eintrag nicht auf dem Pfad: Er gehört nicht zur Kette des Blatts.
  • Andere Versionen und andere Clients sind nicht gemessen.
Messung und Randfälle: Warum curl -vI die Kette nicht zeigt
  • Der Befehl curl -vI https://example.com 2>&1 | grep -i "certificate\|issuer" zeigt keine Kette (gemessen mit curl 8.7.1, SecureTransport: bei fehlendem Zwischenzertifikat die Fehlermeldung, bei vollständiger Kette eine Zeile issuer: mit dem Aussteller des Blatts).
  • Für die Lesart oben braucht man openssl s_client.

Wie behebe ich es?

Erstens: Wie komme ich an das fehlende Zwischenzertifikat?

Meist stellt die Zertifizierungsstelle es zusammen mit dem Leaf-Zertifikat zum Download bereit, oft als separate Datei oder direkt als vorgefertigte fullchain.pem. Fehlt diese Datei, lässt sich die Ausstellerstelle auch aus dem Leaf-Zertifikat selbst auslesen, über die AIA-Erweiterung:

openssl x509 -in leaf.pem -noout -text | grep -A1 "CA Issuers"

Die dort genannte URL liefert das fehlende Zwischenzertifikat im DER- oder PEM-Format zum direkten Herunterladen. Vor dem Zusammensetzen muss ein DER-Download erst umgewandelt werden - ein PEM-Download taugt direkt. Woran man die beiden unterscheidet: eine PEM-Datei ist Text und beginnt mit -----BEGIN CERTIFICATE-----, eine DER-Datei ist binär.

openssl x509 -inform DER -in intermediate.der -out intermediate.pem

Zweitens: Wie setze ich die Kette zusammen?

Leaf zuerst, danach die Intermediates aufsteigend, kein Root:

cat leaf.pem intermediate.pem > fullchain.pem

Sind mehrere Intermediates nötig, werden sie in derselben Datei in der richtigen Reihenfolge angehängt.

Drittens: Wie zeige ich nginx die vollständige Kette?

In der Server-Konfiguration muss ssl_certificate auf fullchain.pem verweisen, nicht auf das Leaf-Zertifikat allein:

ssl_certificate     /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/privkey.pem;

Viertens: Wie lade ich die Konfiguration neu?

Testen und neu laden, damit die Änderung ohne Verbindungsabbruch aktiv wird:

nginx -t && nginx -s reload

Fünftens: Wie messe ich nach?

Denselben openssl s_client-Befehl wie oben erneut ausführen und prüfen, dass der Pfad vom Blatt aus die Einträge 0, 1, 2 … in dieser Reihenfolge durchläuft und bei einem Aussteller endet, der im Trust-Store des Clients steht, und dass die letzte Zeile Verify return code: 0 (ok) lautet.

Hilft ein Werkzeug beim Sortieren?

Die Schritte oben funktionieren vollständig mit den Bordmitteln jedes Systems, auf dem OpenSSL installiert ist - ein zusätzliches Werkzeug ist dafür nicht Voraussetzung. Wer die Zertifikatsdateien in beliebiger Reihenfolge vorliegen hat und die Sortierung sowie das Erkennen fehlender Intermediates nicht von Hand nachvollziehen möchte, findet die entsprechende Funktion in unserem PKI-Toolkit. Es läuft vollständig im Browser und lädt kein Zertifikat auf einen Server hoch.

Lassen Sie uns sprechen

Kostenlose Erstberatung - kein Verkaufsgespräch, sondern ehrliche Einschätzung.

Beratungsgespräch anfragen →