Submit Feedback
Legacy Knowledge Base
Published Jun. 30, 2025

How to get rid of SSLHandshakeException?

Written By

Pooja Bhambani

How To articles are not official guidelines or officially supported documentation. They are community-contributed content and may not always reflect the latest updates to Liferay DXP. We welcome your feedback to improve How To articles!

While we make every effort to ensure this Knowledge Base is accurate, it may not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with any feedback or concerns.

Legacy Article

You are viewing an article from our legacy "FastTrack" publication program, made available for informational purposes. Articles in this program were published without a requirement for independent editing or verification and are provided"as is" without guarantee.

Before using any information from this article, independently verify its suitability for your situation and project.

Issue

  • When trying to access the site URL, the console displays the following exception, and the site is inaccessible.
    javax.net.ssl.SSLHandshakeException: Received fatal alert: handshakefailure 
        javax.net.ssl.SSLHandshakeException: Received fatal alert: handshakefailure
        at com.sun.xml.ws.wsdl.parser.RuntimeWSDLParser.tryWithMex(RuntimeWSDLParser.java:172)
        at com.sun.xml.ws.wsdl.parser.RuntimeWSDLParser.parse(RuntimeWSDLParser.java:144)
        at com.sun.xml.ws.client.WSServiceDelegate.parseWSDL(WSServiceDelegate.java:264)
        at com.sun.xml.ws.client.WSServiceDelegate.<init>(WSServiceDelegate.java:227)
        at com.sun.xml.ws.client.WSServiceDelegate.<init>(WSServiceDelegate.java:175)
        at com.sun.xml.ws.spi.ProviderImpl.createServiceDelegate(ProviderImpl.java:104)
        at javax.xml.ws.Service.<init>(Service.java:77)

Environment

  • Liferay Portal 6.2

Resolution

  • This error usually occurs, when the client and server connection fails to agree on their desired security level or cannot agree on which version of the protocol to use.
  • If the user is running JDK 1.7 and TLS 1.2, JDK 1.7 will use the TLS 1.1 version by default.
    To use the TLS 1.2 version, the user must add the following property to mitigate the issue.
    “-Dhttps.protocols=TLSv1.2,TLSv1.1,TLSv1”

Additional Information

Please note: The below articles are not official documentation of Liferay.  Please exercise appropriate discretion in the use of this information to choose to follow it. 

Did this article resolve your issue ?
Legacy Knowledge Base
Did this article resolve your issue ?