Retour aux articles
Dépannage2026-06-18•5 min de lecture•Équipe CSR.plus

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

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

ComposantRôleLe serveur doit-il l'envoyer ?
Feuille (entité terminale)Lie votre nom d'hôteOui
IntermédiaireRelie la feuille à la racineOui — absent signifie chaîne rompue
RacineL'ancre de confiance du clientNon, 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/null

Comptez 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/null

Code 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.crt

N'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 / codeSignificationCorrection
verify error:num=20 unable to get local issuer certificateIntermédiaire manquant, ou racine absente localementVérifiez combien de certificats le serveur envoie
verify error:num=21 unable to verify the first certificateServeur n'envoyant pas les intermédiairesConstruisez le fullchain et rechargez
verify error:num=19 self signed certificateCertificat auto-signé en usageBasculer vers un certificat publiquement de confiance
Chrome NET::ERR_CERT_AUTHORITY_INVALIDÉchec de construction du cheminMême correction, puis retestez avec le cache vidé
Java PKIX path building failedTrustStore 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 fonctionneLe navigateur masque le problèmeTraitez curl comme la vérité de référence
Seuls certains appareils Android échouentAncien magasin de confiance, pas de récupération AIAEnvoyez la chaîne complète
L'intermédiaire n'a pas signé la feuilleMauvais intermédiaire dans le fichier de chaîneServez l'intermédiaire dont le subject correspond à l'issuer de la feuille
Vous avez configuré cert.pemFeuille seule, sans intermédiairesBasculer vers fullchain.pem
CDN / équilibreur de charge et origine en désaccordChaî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.