...
Eroare Securitate cibernetică · Certificate TLS și HTTPS

curl: (35) OpenSSL/3.0.13: error:0A000410:SSL routines::sslv3 alert handshake failure

Pe scurt

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

Greșit
BASH
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers RC4-SHA:DES-CBC3-SHA;
Corect
BASH
ssl_protocols TLSv1.2 TLSv1.3;
# fără ssl_ciphers: implicit HIGH:!aNULL:!MD5

OpenSSL 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

Greșit
BASH
curl https://api-intern.exemplu.ro/
Corect
BASH
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

Greșit
BASH
openssl s_client -connect 203.0.113.10:443
Corect
BASH
openssl s_client -connect 203.0.113.10:443 -servername magazin-exemplu.ro

Fără numele domeniului, serverul cu mai multe site-uri nu știe ce certificat să folosească și poate refuza.

Repară tu

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ă.

Alte forme ale mesajului

  • curl: (35) error:0A000410:SSL routines::sslv3 alert handshake failure
  • curl: (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

← Toate erorile Securitate cibernetică

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.