Unvollständige Zertifikatskette: Das fehlende Intermediate beheben

Unvollständige Zertifikatskette: Das fehlende Intermediate diagnostizieren und beheben (Nginx / Apache)
Direkte Antwort: Die meisten "Zertifikatsketten-Fehler" sind keine ungültigen Zertifikate — der Server sendet schlicht das Leaf ohne seine Intermediates. Ein Befehl entscheidet es: Zählen Sie die zurückgegebenen Zertifikate mit openssl s_client -showcerts; ein einzelnes Zertifikat bedeutet eine kaputte Kette. Die Lösung ist eine einzige zusammengefügte Datei, zuerst das Leaf, dann die Intermediates: Verweisen Sie Nginx ssl_certificate darauf, oder legen Sie bei Apache 2.4.8+ die Kette in das SSLCertificateFile-Ziel. Senden Sie das Root nicht — Clients haben es bereits.
Grundlagen
Die drei Bestandteile
| Bestandteil | Rolle | Soll der Server ihn senden? |
|---|---|---|
| Leaf (End-Entity) | Bindet Ihren Hostnamen | Ja |
| Intermediate | Verbindet Leaf mit Root | Ja — fehlt es, ist die Kette kaputt |
| Root | Der Trust Anchor des Clients | Nein, bereits im Trust Store |
Wie die Kette funktioniert
Clients vertrauen Roots direkt. Ihr Leaf ist von einem Intermediate signiert, das nicht in deren Trust Store liegt, daher muss der Server es während des Handshakes senden, damit der Client Leaf → Intermediate → Root aufbauen kann. Warum Intermediates gesendet werden müssen: Clients vertrauen nur lokalen Roots; ohne Intermediates lässt sich kein Pfad aufbauen.
Warum manche Clients funktionieren und andere fehlschlagen
Manche Clients cachen Intermediates oder holen das fehlende Glied über die AIA-Erweiterung nach; andere — ältere Android-Versionen, Java/OpenJDK, curl, Node, Monitoring-Agents — scheitern sofort. Der Server darf sich nie auf clientseitige Reparatur verlassen: AIA-Nachladen ist unzuverlässig, weil es von Client-Implementierung und Netz-Erreichbarkeit abhängt.
Die Reihenfolge zählt
Zuerst das Leaf, dann die Intermediates in Signierreihenfolge. Falsche Reihenfolge bricht manche Clients komplett.
Let's Encrypts aktuelle Hierarchie
In der Praxis wird ein ECDSA-Leaf mit einem ECDSA-Intermediate ausgeliefert, aber algorithmusübergreifende Signaturen sind in X.509 gültig — passen müssen Aussteller und Signatur, nicht der Schlüsseltyp.
In 6 Schritten beheben
Schritt 1 — Sehen Sie, was der Server tatsächlich sendet
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/nullZählen Sie BEGIN CERTIFICATE-Blöcke: 1 bedeutet nur Leaf; 2 oder mehr ist gesund.
Schritt 2 — Lesen Sie den Verify-Code
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/nullCode 20 = Issuer nicht gefunden (fehlendes Intermediate); 21 = erstes Zertifikat nicht verifizierbar; 19 = selbstsigniert.
Schritt 3 — Das richtige Intermediate besorgen
Holen Sie das richtige Intermediate aus dem Kette-Bundle Ihrer CA oder aus der Authority-Information-Access-Erweiterung des Leafs. Mischen Sie nie Generationen — ein ECDSA-Leaf braucht ein ECDSA-Intermediate. Der Zertifikats-Decoder zeigt Issuer und AIA sofort.
Schritt 4 — Zusammenfügen (Leaf zuerst, kein Root)
cat leaf.crt intermediate.crt > fullchain.crtHängen Sie das Root nicht an: Clients haben es bereits in ihrem lokalen Trust Store.
Schritt 5 — Server konfigurieren
Nginx: Es gibt nur ssl_certificate und ssl_certificate_key; keine separate Chain-Direktive, daher müssen die Intermediates in derselben Datei liegen, Leaf zuerst.
ssl_certificate /etc/ssl/certs/fullchain.crt;
ssl_certificate_key /etc/ssl/private/example.com.key;Apache 2.4.8+: SSLCertificateChainFile wurde entfernt; legen Sie die Kette in die Datei, auf die SSLCertificateFile verweist.
Certbot-Nutzer: cert.pem ist nur das Leaf (seine Verwendung ist die Hauptursache dieses Fehlers), chain.pem nur die Intermediates, fullchain.pem ist die zu konfigurierende Datei.
CDN: Das CDN beendet TLS mit seinem eigenen Zertifikat; das Hochladen nur des Leafs leitet dieselbe kaputte Kette an Besucher weiter.
Schritt 6 — Verifizieren
openssl verify -CAfile root.pem -untrusted intermediate.pem leaf.pem # expect "leaf.pem: OK"Dann extern mit dem SSL Checker und aus einem sauberen Browser-Profil erneut testen.
Checkliste zur Fehlerbehebung
| Symptom / Code | Bedeutung | Lösung |
|---|---|---|
| verify error:num=20 unable to get local issuer certificate | Fehlendes Intermediate oder Root lokal nicht vorhanden | Prüfen, wie viele Zertifikate der Server sendet |
| verify error:num=21 unable to verify the first certificate | Server sendet keine Intermediates | Fullchain bauen und neu laden |
| verify error:num=19 self signed certificate | Selbstsigniertes Zertifikat im Einsatz | Auf ein öffentlich vertrauenswürdiges Zertifikat wechseln |
| Chrome NET::ERR_CERT_AUTHORITY_INVALID | Pfadaufbau fehlgeschlagen | Gleiche Lösung, dann mit geleertem Cache erneut testen |
| Java PKIX path building failed | TrustStore ohne CA oder Intermediate nicht ausgeliefert | Vollständige Kette senden; nicht darauf vertrauen, dass es "im Browser aufgeht" |
| curl / Node fehlschlagend, Browser funktioniert | Browser maskiert das Problem | curl als Realität behandeln |
| Nur manche Android-Geräte scheitern | Alter Trust Store, kein AIA-Nachladen | Vollständige Kette senden |
| Intermediate hat das Leaf nicht signiert | Falsches Intermediate in der Kette | Das Intermediate ausliefern, dessen Subject zum Issuer des Leafs passt |
| Sie haben cert.pem konfiguriert | Nur Leaf, keine Intermediates | Auf fullchain.pem wechseln |
| CDN / Load Balancer und Origin uneinig | Unterschiedliche Ketten auf jeder Seite | Fullchain auf beiden Seiten aktualisieren |
Weiterführende Informationen
Tools: SSL Checker prüft die Live-Kette · Zertifikats-Decoder zeigt Issuer und AIA · Zertifikats- & Key-Matcher bestätigt zusätzlich das Zertifikat-Key-Paar
Verwandt: SSL-Zertifikatformate erklärt · Prüfen, ob ein Zertifikat zum privaten Key passt · ACME HTTP-01 vs. DNS-01
Mehr erfahren: SSL-Zertifikate: Der komplette Leitfaden · Zertifikatstypen im Vergleich · SSL-Zertifikatsfinder
FAQ
Sollte ich das Root in die Fullchain aufnehmen?
Nein. Clients haben es bereits; das Senden fügt nur Bytes und Verwirrung hinzu.
Warum funktioniert Chrome, während curl, Java oder Android fehlschlagen?
Manche Clients cachen Intermediates oder holen sie über AIA nach; andere tun das nicht. Beurteilen Sie nach curl, nicht nach Ihrem Browser.
Verdeckt ein CDN das Problem?
Nein. Das CDN beendet TLS mit seinem eigenen Zertifikat, daher reicht das Hochladen nur des Leafs die kaputte Kette an Besucher weiter.
Was ist der Unterschied zwischen cert.pem, chain.pem und fullchain.pem?
Im Certbot-Verzeichnis: cert.pem ist nur das Leaf, chain.pem nur die Intermediates, fullchain.pem ist Leaf + Intermediates. Verwenden Sie fullchain.pem in Nginx/Apache.
Was muss ich wegen Let's Encrypts neuen Roots tun?
Meist nichts manuell — Clients erhalten die neue Kette automatisch. Achten Sie nur darauf, dass keine Konfiguration ein bestimmtes Intermediate fixiert, und dass die Trust Stores älterer Clients ISRG Root X1/X2 enthalten.
Kostenlose SSL/TLS-Tools
Prüfen Sie Ihre Zertifikate in Sekunden.
Zertifikat-Informationen
Erfahren Sie mehr über Auswahl und Kauf von SSL-Zertifikaten.