Handshake SSL non riuscito: cause e come risolverlo

Un errore di handshake SSL/TLS (l'industria dice ancora comunemente "SSL") significa che il client e il server non sono riusciti a concordare i parametri necessari per aprire una connessione crittografata. Le cause più comuni sono la mancanza di un certificato intermedio, una mancata corrispondenza della suite di crittografia o della versione TLS, un nome host/SNI errato o un dispositivo di rete che interrompe l'handshake. Nella maggior parte dei casi il problema viene risolto in pochi minuti distribuendo l'intera catena, abilitando TLS 1.2/1.3 e confermando che la porta 443 è raggiungibile. Utilizza il SSL Checker per vedere esattamente cosa invia il server.
Cosa fa un handshake TLS
Durante l'handshake il client e il server negoziano la versione del protocollo, il pacchetto di crittografia e la catena di certificati. Se non è possibile concordare un passaggio, la connessione viene interrotta. L'handshake completa la negoziazione dei parametri prima della convalida del certificato, quindi un errore di handshake è spesso dovuto a una mancata corrispondenza del protocollo, della crittografia o della rete piuttosto che al certificato stesso.
Perché le strette di mano falliscono
Gli errori di solito rientrano in cinque bucket: una catena incompleta (il server invia solo la foglia), nessuna suite di crittografia condivisa, una versione TLS non supportata dal client, una mancata corrispondenza del nome host/SNI o un firewall/NAT che elimina silenziosamente ClientHello. Effettua la diagnosi nell'ordine scadenza → nome host → catena → protocollo/cifra → rete per il risultato più veloce.
Come leggere l'errore
Sul server esegui openssl s_client -connect yourdomain.com:443 -servername yourdomain.com e leggi l'output: Verify return code: 0 significa che la catena va bene; unable to get local issuer certificate indica un intermedio mancante; no peer certificate available o una riga vuota dopo CONNECTED significa che il server non ha mai terminato l'handshake, in genere un problema di protocollo o di crittografia. Gli errori della console del browser aggiungono la vista lato client.
Passaggio 1: esegui una diagnostica rapida con openssl
Esegui openssl s_client -connect yourdomain.com:443 -servername yourdomain.com e osserva il codice di ritorno Verifica e se viene restituito un certificato. Confrontalo con SSL Checker in modo che il server e la visualizzazione pubblica siano d'accordo.
Passaggio 2: controlla e distribuisci l'intera catena
Scarica il bundle completo della catena della CA e concatena la foglia e gli elementi intermedi nell'ordine corretto. La maggior parte degli errori sono semplicemente dovuti al fatto che l'intermedio non viene inviato con la foglia. Verificare la completezza con il Decodificatore del certificato.
Passaggio 3: allinea le versioni TLS e le suite di crittografia
Abilita TLS 1.2 e TLS 1.3 sul server e disabilita qualsiasi cosa inferiore a 1.2 (TLS 1.0/1.1 sono stati deprecati dai browser alla fine del 2020). Offri suite comuni come TLS_AES_256_GCM_SHA384 (TLS 1.3) o ECDHE-RSA-AES256-GCM-SHA384 (TLS 1.2).
Chain bundle = leaf + intermediates only; do not append the root certificate.
Passaggio 4: verifica il nome host e l'SNI
Confermare che il certificato copra l'esatto nome host nella sua SAN e che SNI sia abilitato sul server. Un errore su un singolo nome host solitamente indica una mancata corrispondenza SNI/nome host.
Passaggio 5: escludere problemi di rete e firewall
Confermare che la porta 443 sia aperta e che un sistema di bilanciamento del carico o una CDN non stia terminando TLS con le proprie impostazioni. Testare da un'altra rete o acquisire pacchetti per verificare se ClientHello viene eliminato.
Elenco di controllo per la risoluzione dei problemi| Sintomo | Probabile causa | Correzione |
Verify return code: 20/21 o unable to get local issuer certificate | Certificato intermedio mancante | Distribuire foglia + intermedi in ordine; ricontrollare con il Decodificatore del certificato |
|---|---|---|
| Nessun certificato restituito/riga vuota dopo CONNECTED | Il server non ha mai terminato l'handshake (protocollo/cifratura) | Abilita TLS 1.2/1.3 e aggiungi suite di crittografia comuni |
| Funziona con curl ma fallisce in un vecchio browser | Al client manca la versione TLS negoziata | Imposta TLS 1.2 come minimo; ritirare TLS 1.0/1.1 |
| Fallisce solo per un nome host | Mancata corrispondenza SNI/nome host | Assicurati che il certificato copra che il nome host e il SNI siano su |
| Guasti intermittenti, intermittenti | Firewall/NAT elimina ClientHello di grandi dimensioni o blocca 443 | Consenti 443; testare da un'altra rete; acquisire pacchetti se necessario |
Strumenti correlati e passaggi successivi
- Utilizzare il SSL Checker per vedere il certificato esatto e la catena restituiti dal server.
- Utilizzare il Decoder certificato per analizzare e verificare l'intera catena.
- Utilizza Certificato e corrispondenza chiave per verificare che il certificato corrisponda alla sua chiave privata.
- Utilizzare il Convertitore di formato per convertire i formati di certificato/chiave (ad esempio PEM e PFX).
- Esplora la guida ai certificati SSL per informazioni di base su TLS, tipi di certificati e best practice.
Articoli correlati
Domande frequenti
Perché l'handshake fallisce in un browser ma funziona con curl?
Client diversi supportano versioni TLS e suite di crittografia diverse. Se curl funziona ma un vecchio browser non funziona, il client non può parlare la versione TLS negoziata: imposta TLS 1.2 come minimo per coprire praticamente tutti i client moderni.
Un firewall può causare un errore di handshake?
Sì. Alcuni firewall e dispositivi NAT rilasciano silenziosamente pacchetti ClientHello di grandi dimensioni o bloccano la porta TCP. Testare su una porta non standard o acquisire pacchetti per verificare che l'handshake venga interrotto prima che raggiunga il server.
TLS 1.0/1.1 sono ancora utilizzabili?
Non raccomandato. TLS 1.0 e 1.1 sono stati deprecati dai principali browser alla fine del 2020 e non vengono più negoziati dai client moderni per impostazione predefinita. Abilita almeno TLS 1.2 e preferisci TLS 1.3.
Strumenti SSL/TLS gratuiti
Verifica e ispeziona i tuoi certificati in pochi secondi.
Informazioni sui certificati
Scopri come scegliere e acquistare certificati SSL.