javax.net.ssl.SSLHandshakeException: Received fatal alert: handshake_failure
The server rejected the TLS handshake
Seen in Java, Spring, Android, Kotlin, Scala
The server sent a handshake_failure alert because it could not agree on TLS settings with the Java client.
Common causes
- No cipher suite or TLS version in common, often an old JDK or a cipher disabled in java.security.
- SNI not sent, for example when connecting by IP, so the server has nothing to offer.
- The server requires a client certificate and none was presented.
How to fix it
- Run with -Djavax.net.debug=ssl:handshake to see what each side offered.
- Update the JDK so it supports TLS 1.2 and 1.3 with modern ciphers.
- For mutual TLS, configure a keystore with the client certificate (javax.net.ssl.keyStore).
- Check which TLS versions the server accepts.
Got a different message? Paste it into the error explainer.
Related errors
- [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed · Python couldn't verify the server's certificate
- certificate verify failed: Hostname mismatch, certificate is not valid for · The certificate doesn't cover this hostname
- PKIX path building failed · Java can't build a trusted certificate chain
- No subject alternative DNS name matching example.com found · The certificate doesn't cover this hostname
- x509: certificate signed by unknown authority · Go doesn't trust the certificate's issuer
- x509: certificate is valid for X, not Y · The certificate doesn't cover this hostname
- remote error: tls: handshake failure · The server rejected the TLS handshake
- The SSL connection could not be established, see inner exception. · .NET could not complete the TLS handshake
- The remote certificate is invalid according to the validation procedure · .NET doesn't trust the server's certificate
- The request was aborted: Could not create SSL/TLS secure channel. · .NET Framework could not negotiate TLS
- cURL error 60: SSL certificate problem: unable to get local issuer certificate · PHP cURL can't verify the server's certificate
- stream_socket_enable_crypto(): SSL operation failed with code 1 · PHP failed to set up TLS on a stream