SSLHandshakeException is thrown while trying to establish a connection to the Rest API

When you attempt to establish a connection to the Fulfillment Optimizer REST APIs while running the schedule order agent, you see the SSLHandshakeException.

Symptoms

You may see one of the following messages:

OAuthHttpClient: Unexpected error = "Received fatal alert: handshake_failure".
            [system]: [ ]: OAuthHttpClient [Fatal Error]
javax.net.ssl.SSLHandshakeException: Received fatal alert: handshake_failure at
            com.ibm.jsse2.j.a(j.java:18) at com.ibm.jsse2.j.a(j.java:26) at
            com.ibm.jsse2.qc.b(qc.java:722)

Causes

The reason that the SSLHandshakeException is thrown in this circumstance is most likely one of the following:

Diagnosing the problem

  1. Open the OMS installation directory and go to /bin directory.
  2. Provide -Djavax.net.debug=ssl in the JVM arguments of the agent server.
  3. Collect the SSL debug logs and see if the logs contain SSL protocol failure details.