Chaîne de certificats incomplète : corrigez l'intermédiaire manquant

Chaîne de certificats incomplète : comment diagnostiquer et corriger l'intermédiaire manquant (Nginx / Apache)
Réponse directe : la plupart des « erreurs de chaîne de certificats » ne sont pas des certificats invalides — le serveur envoie simplement la feuille sans ses intermédiaires. Une commande tranche la question : comptez les certificats renvoyés avec openssl s_client -showcerts ; un seul certificat signifie une chaîne rompue. La correction est un seul fichier concaténé, feuille en premier, puis intermédiaires : pointez ssl_certificate de Nginx dessus, ou sur Apache 2.4.8+ placez la chaîne dans la cible SSLCertificateFile. N'envoyez pas la racine — les clients l'ont déjà.
Concepts essentiels
Les trois composants
| Composant | Rôle | Le serveur doit-il l'envoyer ? |
|---|---|---|
| Feuille (entité terminale) | Lie votre nom d'hôte | Oui |
| Intermédiaire | Relie la feuille à la racine | Oui — absent signifie chaîne rompue |
| Racine | L'ancre de confiance du client | Non, déjà dans le magasin de confiance |
Comment fonctionne la chaîne
Les clients font confiance aux racines directement. Votre feuille est signée par un intermédiaire absent de leur magasin de confiance, le serveur doit donc l'envoyer pendant la poignée de main pour que le client construise feuille → intermédiaire → racine. Pourquoi les intermédiaires doivent être envoyés : les clients ne font confiance qu'aux racines locales ; sans intermédiaires, aucun chemin ne peut être construit.
Pourquoi certains clients fonctionnent et d'autres échouent
Certains clients mettent en cache les intermédiaires ou récupèrent le lien manquant via l'extension AIA ; d'autres — Android plus ancien, Java/OpenJDK, curl, Node, agents de surveillance — échouent immédiatement. Le serveur ne doit jamais s'appuyer sur une réparation côté client : la récupération AIA est peu fiable car elle dépend de l'implémentation du client et de l'accessibilité réseau.
L'ordre compte
Feuille en premier, puis intermédiaires dans l'ordre de signature. Un ordre incorrect casse certains clients directement.
Hiérarchie actuelle de Let's Encrypt
En pratique une feuille ECDSA est servie avec un intermédiaire ECDSA, mais la signature inter-algorithmes est valide en X.509 : ce qui doit correspondre, c'est l'émetteur et la signature, pas le type de clé.
Corrigez en 6 étapes
Étape 1 — Voyez ce que le serveur envoie réellement
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/nullComptez les blocs BEGIN CERTIFICATE : 1 signifie feuille seule ; 2 ou plus est sain.
Étape 2 — Lisez le code de vérification
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/nullCode 20 = émetteur introuvable (intermédiaire manquant) ; 21 = impossible de vérifier le premier certificat ; 19 = auto-signé.
Étape 3 — Récupérez le bon intermédiaire
Récupérez le bon intermédiaire depuis le bundle de chaîne de votre AC, ou depuis l'extension Authority Information Access de la feuille. Ne mélangez jamais les générations — une feuille ECDSA a besoin d'un intermédiaire ECDSA. Le Décodeur de certificat affiche l'émetteur et l'AIA instantanément.
Étape 4 — Concaténez (feuille en premier, sans la racine)
cat leaf.crt intermediate.crt > fullchain.crtN'ajoutez pas la racine : les clients l'ont déjà dans leur magasin de confiance local.
Étape 5 — Configurez le serveur
Nginx : il n'y a que ssl_certificate et ssl_certificate_key ; aucune directive de chaîne séparée n'existe, donc les intermédiaires doivent résider dans le même fichier, feuille en premier.
ssl_certificate /etc/ssl/certs/fullchain.crt;
ssl_certificate_key /etc/ssl/private/example.com.key;Apache 2.4.8+ : SSLCertificateChainFile a été supprimé ; placez la chaîne dans le fichier référencé par SSLCertificateFile.
Utilisateurs de Certbot : cert.pem est la feuille seule (l'utiliser est la cause racine de ce bogue), chain.pem est les intermédiaires seuls, fullchain.pem est ce que vous configurez.
CDN : le CDN termine le TLS avec son propre certificat ; n'envoyer que la feuille transmet la même chaîne rompue aux visiteurs.
Étape 6 — Vérifiez
openssl verify -CAfile root.pem -untrusted intermediate.pem leaf.pem # attendu « leaf.pem: OK »Puis retestez de façon externe avec le Vérificateur SSL et depuis un profil de navigateur propre.
Liste de dépannage
| Symptôme / code | Signification | Correction |
|---|---|---|
| verify error:num=20 unable to get local issuer certificate | Intermédiaire manquant, ou racine absente localement | Vérifiez combien de certificats le serveur envoie |
| verify error:num=21 unable to verify the first certificate | Serveur n'envoyant pas les intermédiaires | Construisez le fullchain et rechargez |
| verify error:num=19 self signed certificate | Certificat auto-signé en usage | Basculer vers un certificat publiquement de confiance |
| Chrome NET::ERR_CERT_AUTHORITY_INVALID | Échec de construction du chemin | Même correction, puis retestez avec le cache vidé |
| Java PKIX path building failed | TrustStore sans AC ou intermédiaire non renvoyé | Envoyez la chaîne complète ; ne faites pas confiance à « ça s'ouvre dans un navigateur » |
| curl / Node échouent, le navigateur fonctionne | Le navigateur masque le problème | Traitez curl comme la vérité de référence |
| Seuls certains appareils Android échouent | Ancien magasin de confiance, pas de récupération AIA | Envoyez la chaîne complète |
| L'intermédiaire n'a pas signé la feuille | Mauvais intermédiaire dans le fichier de chaîne | Servez l'intermédiaire dont le subject correspond à l'issuer de la feuille |
| Vous avez configuré cert.pem | Feuille seule, sans intermédiaires | Basculer vers fullchain.pem |
| CDN / équilibreur de charge et origine en désaccord | Chaînes différentes de chaque côté | Mettez à jour le fullchain des deux côtés |
Pour aller plus loin
Outils : Vérificateur SSL vérifie la chaîne active · Décodeur de certificat affiche l'émetteur et l'AIA · Correspondance certificat et clé confirme aussi la paire certificat et clé
Articles liés : Explication des formats de certificats SSL · Vérifier si un certificat correspond à sa clé privée · ACME HTTP-01 contre DNS-01
Approfondir : Certificats SSL : le guide complet · Comparaison des types de certificats · sélecteur de certificat SSL
FAQ
Dois-je inclure la racine dans le fullchain ?
Non. Les clients l'ont déjà ; l'envoyer n'ajoute que des octets et de la confusion.
Pourquoi Chrome fonctionne-t-il alors que curl, Java ou Android échouent ?
Certains clients mettent en cache les intermédiaires ou les récupèrent via l'AIA ; d'autres non. Jugez avec curl, pas avec votre navigateur.
Un CDN masque-t-il ce problème ?
Non. Le CDN termine le TLS avec son propre certificat, donc n'envoyer que la feuille transmet la chaîne rompue aux visiteurs.
Quelle est la différence entre cert.pem, chain.pem et fullchain.pem ?
Dans le répertoire de Certbot : cert.pem est la feuille seule, chain.pem est les intermédiaires seuls, fullchain.pem est feuille + intermédiaires. Utilisez fullchain.pem dans Nginx/Apache.
Que dois-je faire pour les nouvelles racines de Let's Encrypt ?
Généralement rien manuellement — les clients reçoivent la nouvelle chaîne automatiquement. Assurez-vous simplement qu'aucune configuration n'épingle un intermédiaire précis, et que les magasins de confiance des clients plus anciens contiennent ISRG Root X1/X2.
Outils SSL/TLS gratuits
Vérifiez et inspectez vos certificats en quelques secondes.
Informations associées
En savoir plus sur le choix et l'achat de certificats SSL.