curl: (35) OpenSSL/3.0.13: error:0A000410:SSL routines::sslv3 alert handshake failure
Serverul a încheiat negocierea TLS pentru că nu are în comun cu clientul niciun cifru sau parametru acceptat: de obicei o listă ssl_ciphers veche sau prea restrictivă, un certificat pe care clientul nu-l poate folosi sau lipsa SNI. Lasă cifrurile implicite moderne ale nginx (sau lista Mozilla) și verifică cu openssl s_client.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În ciuda numelui, sslv3 alert handshake failure nu înseamnă că se folosește SSLv3: e numele istoric al alertei TLS numărul 40, trimisă de server când nu poate continua handshake-ul. Clientul (aici curl cu OpenSSL 3.0.13) a propus versiunile și cifrurile lui, iar serverul n-a găsit nimic acceptabil și a închis.
Cauzele tipice: ssl_ciphers din nginx conține doar cifruri vechi (RC4, 3DES) pe care OpenSSL 3 nu le mai oferă; serverul cere certificat de client (mTLS) și nu primește unul; clientul nu trimite SNI (conectare pe IP sau unealtă veche), iar serverul nu are certificat implicit; un client vechi care nu știe cifrurile moderne pe care le cere serverul.
Diferit de tlsv1 alert protocol version, care înseamnă versiuni TLS fără potrivire. Testează cu openssl s_client -connect magazin-exemplu.ro:443 -servername magazin-exemplu.ro și vezi ce cifru se negociază.
De ce apare: cauzele frecvente
1Listă de cifruri învechită pe server
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers RC4-SHA:DES-CBC3-SHA;ssl_protocols TLSv1.2 TLSv1.3;
# fără ssl_ciphers: implicit HIGH:!aNULL:!MD5OpenSSL 3 nu mai oferă RC4 și 3DES. Fără cifruri comune pentru TLS 1.2, serverul trimite alerta de handshake failure.
2Serverul cere certificat de client
curl https://api-intern.exemplu.ro/curl --cert client.crt --key client.key https://api-intern.exemplu.ro/Cu ssl_verify_client on, serverul închide handshake-ul dacă clientul nu prezintă un certificat.
3Conectare pe IP, fără SNI
openssl s_client -connect 203.0.113.10:443openssl s_client -connect 203.0.113.10:443 -servername magazin-exemplu.roFără numele domeniului, serverul cu mai multe site-uri nu știe ce certificat să folosească și poate refuza.
Repară eroarea, direct în pagină
După o „întărire” a configurației TLS, clienții primesc curl: (35) OpenSSL/3.0.13: error:0A000410:SSL routines::sslv3 alert handshake failure. Fișierul e infra/nginx/magazin.conf. Scoate lista de cifruri învechită, ca nginx să folosească cifrurile lui implicite, și păstrează doar TLS 1.2 și 1.3.
Indiciu
Problema e linia ssl_ciphers; ssl_protocols e corectă.
Reparația
Șterge linia ssl_ciphers și verifică:
sed -i '/ssl_ciphers/d' infra/nginx/magazin.conf
cat infra/nginx/magazin.confPe server: sudo nginx -t && sudo systemctl reload nginx, apoi curl -sI https://magazin-exemplu.ro.
De ce merge
Linia ssl_ciphers RC4-SHA:DES-CBC3-SHA lăsa serverului doar cifruri pe care OpenSSL 3 nu le mai oferă, deci la TLS 1.2 nu exista niciun cifru comun, iar serverul trimitea alerta 40 (handshake failure). Fără linie, nginx folosește HIGH:!aNULL:!MD5, cifruri moderne acceptate de orice client actual. TLS 1.3 își alege oricum cifrurile separat, iar ssl_protocols păstrează versiunile vechi oprite.
Alte forme ale mesajului
curl: (35) error:0A000410:SSL routines::sslv3 alert handshake failurecurl: (35) error:14094410:SSL routines:ssl3_read_bytes:sslv3 alert handshake failure[SSL: SSLV3_ALERT_HANDSHAKE_FAILURE] sslv3 alert handshake failure (_ssl.c:1006)javax.net.ssl.SSLHandshakeException: Received fatal alert: handshake_failure
Cum o eviți pe viitor
- Nu scrie de mână liste de cifruri; folosește valorile implicite ale nginx sau configurația „intermediate” de la Mozilla.
- După orice schimbare TLS, testează cu
openssl s_clientși cu un client vechi pe care îl suporți. - Verifică periodic configurația cu un scanner TLS (testssl.sh, SSL Labs).
- Documentează serviciile care cer certificat de client.
Întrebări frecvente
Înseamnă că serverul folosește SSLv3?
Nu. E doar numele vechi al alertei TLS. Protocolul negociat poate fi TLS 1.2 sau 1.3.
Merge în browser, dar nu din curl. De ce?
Browserul și curl oferă cifruri și extensii diferite, iar unele site-uri au reguli doar pentru browsere. Compară cu curl -v ce versiune și ce cifru încearcă.
Erori înrudite
curl: (35) OpenSSL/3.0.13: error:0A00042E:SSL routines::tlsv1 alert protocol version Clientul și serverul nu au nicio versiune de TLS în comun: de obicei serverul acceptă doar TLS 1.0/1.1 (ssl_protocols vechi), iar clientul nou cere minimum TLS 1.2. Pe server, setează ssl_protocols TLSv1.2 TLSv1.3; și reîncarcă nginx. curl: (35) OpenSSL/3.0.13: error:0A00010B:SSL routines::wrong version number curl a început o conexiune TLS, dar serverul a răspuns cu text simplu (HTTP fără criptare). Fie te conectezi cu https pe un port care servește http (https://site:80), fie serverul ascultă pe 443 fără TLS: în nginx lipsește ssl din listen 443 ssl;. curl: (58) unable to set private key file: 'client.crt' type PEM curl nu poate încărca cheia privată pentru certificatul de client: fișierul dat la --key nu e o cheie, nu se potrivește cu certificatul de la --cert sau e criptată fără parolă dată. Pune la --key fișierul cu cheia privată (de exemplu client.key) și la --cert certificatul. Învață Securitate cibernetică de la zero, cu exerciții la fiecare lecție
Curs Cybersecurity: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
