[Solved-5 Solutions] SSL handshake alert: unrecognized_name error since upgrade to Java 1.7.0
Error Description:
After upgrading from Java 1.6 to Java 1.7, an error occurs when we try to establish a connection to the webserver over SSL:
Here is the code:
Solution 1:
- Java 7 introduced SNI support which is enabled by default.
- Certain misconfigured servers send an "Unrecognized Name" warning in the SSL handshake which is ignored by most clients... except for Java.The Oracle engineers refuse to "fix" this bug/feature.
As workaround, they suggest to set the jsse.enableSNIExtension
property. To allow your programs to work without re-compiling, run your app as:
- The property can also be set in the Java code, but it must be set before any SSL actions.
- Once the SSL library has loaded, you can change the property, but it won't have any effect on the SNI status.
To disable SNI on runtime (with the aforementioned limitations), use:
The disadvantage of setting this flag is that SNI is disabled everywhere in the application. In order to make use of SNI and still support misconfigured servers:
- Create a SSLSocket with the host name you want to connect to. Let's name this sslsock.
- Try to run sslsock.startHandshake(). This will block until it is done or throw an exception on error. Whenever an error occurred in startHandshake(), get the exception message. If it equals to handshake alert: unrecognized_name, then you have found a misconfigured server.
- When you have received the unrecognized_name warning (fatal in Java), retry opening a SSLSocket, but this time without a host name. This effectively disables SNI (after all, the SNI extension is about adding a host name to the ClientHello message).
For the Webscarab SSL proxy, this commit implements the fall-back setup.
Solution 2:
We need to adjust the Apache configuration to include a ServerName or ServerAlias for the host.
This code fails:
And this code works:
Solution 3:
You can disable sending SNI records with the System property
- If you can change the code it helps to use
SSLCocketFactory#createSocket()
(with no host parameter or with a connected socket). In this case it will not send a server_name indication.
Solution 4:
Instead of relying on the default virtual host mechanism in apache, you can define one last catchall virtualhost that uses an arbitrary ServerName and a wildcard ServerAlias, e.g.
- In that way you can use SNI and apache will not send back the SSL warning.
- Of course, this only works if you can describe all of your domains easily using a wildcard syntax.
Solution 5:
Use:
- System.setProperty("jsse.enableSNIExtension", "false");
- Restart your Tomcat (important)