Catena di certificati incompleta: correggi l'intermedio mancante

Catena di certificati incompleta: come diagnosticare e correggere l'intermedio mancante (Nginx / Apache)
Risposta diretta: la maggior parte degli "errori della catena di certificati" non sono certificati non validi: il server invia semplicemente la foglia senza i suoi intermediari. Un comando risolve il problema: conta i certificati restituiti con openssl s_client -showcerts; un singolo certificato significa una catena spezzata. La correzione è un file concatenato, prima la foglia, poi gli intermedi: puntare Nginx ssl_certificate su di esso o su Apache 2.4.8+ inserire la catena all'interno del target SSLCertificateFile. Non inviare il root: i client ce l'hanno già.
Concetti fondamentali
Le tre componenti
| Componente | Ruolo | Il server deve inviarlo? |
|---|---|---|
| Leaf (entità finale) | Associa il tuo nome host | Sì |
| Intermedio | Collegamenti da foglia a radice | Sì, mancante significa catena interrotta |
| Root | L'ancora di fiducia del cliente | No, già nel trust store |
Come funziona la catena
I clienti si fidano direttamente delle radici. La tua foglia è firmata da un intermediario che non si trova nel suo trust store, quindi il server deve inviarla durante l'handshake affinché il client possa creare foglia → intermedio → root. Perché devono essere inviati gli intermedi: i client si fidano solo delle radici locali; senza intermediari nessun percorso può essere costruito.
Perché alcuni client funzionano e altri falliscono
Alcuni client memorizzano nella cache gli intermedi o recuperano il collegamento mancante tramite l'estensione AIA; altri - Android più vecchi, Java/OpenJDK, curl, Node, agenti di monitoraggio - falliscono immediatamente. Il server non dovrebbe mai fare affidamento sulla riparazione lato client: il recupero AIA è inaffidabile perché dipende dall'implementazione del client e dalla raggiungibilità della rete.
L'ordine è importante
Prima le foglie, poi gli intermedi in ordine di firma. L'ordine sbagliato distrugge completamente alcuni clienti.
Crittografiamo l'attuale gerarchia
In pratica una foglia ECDSA viene servita con un intermedio ECDSA, ma la firma tra algoritmi è valida in X.509: a dover combaciare sono emittente e firma, non il tipo di chiave.
Risolvi il problema in 6 passaggi
Passaggio 1: guarda cosa invia effettivamente il server
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/nullContare i blocchi BEGIN CERTIFICATE: 1 significa solo foglia; 2 o più sono sani.
Passaggio 2: leggi il codice di verifica
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/nullCodice 20 = emittente non trovato (intermedio mancante); 21 = impossibile verificare il primo certificato; 19 = autofirmato.
Passaggio 3: recupera l'intermedio corretto
Recupera l'intermedio corretto dal bundle della catena della tua CA o dall'estensione Authority Information Access della foglia. Non mescolare mai le generazioni: una foglia ECDSA ha bisogno di un intermedio ECDSA. Decodificatore del certificato mostra immediatamente l'emittente e l'AIA.
Passaggio 4: Concatena (prima la foglia, senza radice)
cat leaf.crt intermediate.crt > fullchain.crtNon aggiungere il root: i client lo hanno già nel loro truststore locale.
Passaggio 5: configura il server
Nginx: esistono solo ssl_certificate e ssl_certificate_key; non esiste una direttiva di catena separata, quindi gli intermedi devono vivere nello stesso file, prima la foglia.
ssl_certificate /etc/ssl/certs/fullchain.crt;
ssl_certificate_key /etc/ssl/private/example.com.key;Apache 2.4.8+: SSLCertificateChainFile è stato rimosso; inserisci la catena nel file a cui fa riferimento SSLCertificateFile.
Utenti Certbot: cert.pem è solo leaf (il suo utilizzo è la causa principale di questo bug), chain.pem è solo intermedi, fullchain.pem è ciò che configuri.CDN: la CDN termina TLS con il proprio certificato; caricando solo la foglia si inoltra ai visitatori la stessa catena spezzata.
Passaggio 6: verifica
openssl verify -CAfile root.pem -untrusted intermediate.pem leaf.pem # expect "leaf.pem: OK"Quindi esegui nuovamente il test esternamente con SSL Checker e da un profilo del browser pulito.
Elenco di controllo per la risoluzione dei problemi
| Sintomo/codice | Significato | Correzione |
|---|---|---|
| verifica errore:num=20 impossibile ottenere il certificato dell'emittente locale | Intermedio mancante o root assente localmente | Controlla quanti certificati invia il server |
| verify error:num=21 impossibile verificare il primo certificato | Il server non invia intermedi | Costruisci la fullchain e ricarica |
| verifica errore:num=19 certificato autofirmato | Certificato autofirmato in uso | Passa a un certificato pubblicamente attendibile |
| Chrome NET::ERR_CERT_AUTHORITY_INVALID | Creazione del percorso non riuscita | Stessa correzione, quindi ripetere il test con la cache svuotata |
| Creazione del percorso Java PKIX non riuscita | TrustStore mancante CA o intermediario non restituito | Invia la catena completa; non fidarti di "si apre in un browser" |
| curl / Nodo guasto, il browser funziona | Il browser maschera il problema | Tratta curl come verità assoluta |
| Solo alcuni dispositivi Android falliscono | Vecchio trust store, nessun recupero AIA | Invia la catena completa |
| L'intermedio non ha firmato la foglia | Intermedio sbagliato nel file di catena | Servi l'intermedio il cui subject corrisponde all'issuer della foglia |
| Hai configurato cert.pem | Solo foglia, nessun intermedio | Passa a fullchain.pem |
| CDN / bilanciatore del carico e origine non sono d'accordo | Diverse catene su ciascun lato | Aggiorna l'intera catena su entrambi i lati |
Ulteriori letture
Strumenti: SSL Checker controlla la catena live · Certificate Decoder mostra l'emittente e l'AIA · Certificate & Key Matcher conferma anche il certificato e la coppia di chiavi
Correlato: Spiegazione dei formati di certificato SSL · Verifica se un certificato corrisponde alla sua chiave privata · ACME HTTP-01 vs DNS-01
Approfondisci: Certificati SSL: la guida completa · Tipi di certificato a confronto · Selettore certificato SSL
Domande frequenti
Dovrei includere la radice nella catena completa?
No. I clienti ce l'hanno già; inviarlo aggiunge solo byte e confusione.
Perché Chrome funziona mentre Curl, Java o Android falliscono?
Alcuni client memorizzano nella cache gli intermedi o li recuperano tramite AIA; altri no. Giudica dal ricciolo, non dal tuo browser.
Un CDN lo nasconde?
No. Il CDN termina TLS con il proprio certificato, quindi caricando solo la foglia si trasmette ai visitatori la catena interrotta.
Qual è la differenza tra cert.pem, chain.pem e fullchain.pem?
Nella directory di Certbot: cert.pem è solo foglia, chain.pem è solo intermedi, fullchain.pem è foglia + intermedi. Utilizza fullchain.pem in Nginx/Apache.
Cosa devo fare riguardo alle nuove radici di Let's Encrypt?
Di solito niente manualmente: i client ricevono la nuova catena automaticamente. Assicurati solo che nessuna configurazione blocchi un intermediario specifico e che i trust store dei client più vecchi contengano ISRG Root X1/X2.
Strumenti SSL/TLS gratuiti
Verifica e ispeziona i tuoi certificati in pochi secondi.
Informazioni sui certificati
Scopri come scegliere e acquistare certificati SSL.