Torna agli articoli
Risoluzione dei problemi2026-06-18•5 minuti di lettura•Team di CSR.plus

Catena di certificati incompleta: correggi l'intermedio mancante

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

ComponenteRuoloIl server deve inviarlo?
Leaf (entità finale)Associa il tuo nome hostSì
IntermedioCollegamenti da foglia a radiceSì, mancante significa catena interrotta
RootL'ancora di fiducia del clienteNo, 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/null

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

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

Non 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/codiceSignificatoCorrezione
verifica errore:num=20 impossibile ottenere il certificato dell'emittente localeIntermedio mancante o root assente localmenteControlla quanti certificati invia il server
verify error:num=21 impossibile verificare il primo certificatoIl server non invia intermediCostruisci la fullchain e ricarica
verifica errore:num=19 certificato autofirmatoCertificato autofirmato in usoPassa a un certificato pubblicamente attendibile
Chrome NET::ERR_CERT_AUTHORITY_INVALIDCreazione del percorso non riuscitaStessa correzione, quindi ripetere il test con la cache svuotata
Creazione del percorso Java PKIX non riuscitaTrustStore mancante CA o intermediario non restituitoInvia la catena completa; non fidarti di "si apre in un browser"
curl / Nodo guasto, il browser funzionaIl browser maschera il problemaTratta curl come verità assoluta
Solo alcuni dispositivi Android fallisconoVecchio trust store, nessun recupero AIAInvia la catena completa
L'intermedio non ha firmato la fogliaIntermedio sbagliato nel file di catenaServi l'intermedio il cui subject corrisponde all'issuer della foglia
Hai configurato cert.pemSolo foglia, nessun intermedioPassa a fullchain.pem
CDN / bilanciatore del carico e origine non sono d'accordoDiverse catene su ciascun latoAggiorna 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.