WebSphere - Cannot find the specified class com.ibm.websphere.ssl.protocol.SSLSocketFactory

Problem

When using the SeaLights test listener as a javaagent in WebSphere, it fails to connect to our server with ClassNotFoundException for com.ibm.websphere.ssl.protocol.SSLSocketFactory

[SEALIGHTS] (...) Error: java.lang.ClassNotFoundException: Cannot find the specified class com.ibm.websphere.ssl.protocol.SSLSocketFactory java.net.SocketException: java.lang.ClassNotFoundException: Cannot find the specified class com.ibm.websphere.ssl.protocol.SSLSocketFactory at javax.net.ssl.DefaultSSLSocketFactory.a(SSLSocketFactory.java:10) ...

Cause

This is a known issue with WebSphere when SSL is enabled and using a JDK from the WebSphere Application Server (see references below).

When the IBM WebSphere Application Server starts up it sets the security property to the WebSphere default of com.ibm.websphere.ssl.protocol.SSLSocketFactory but this class is not visible to the Java agent, thus the ClassNotFoundException is raised when trying to open a secured connection to Sealights' servers.

Solution

This issue can be resolved by creating a file called sl.java.security with the following content

ssl.SocketFactory.provider= ssl.ServerSocketFactory.provider=

And then add the following parameter to the JVM arguments of WebSphere alongside our javaagent: 

-Djava.security.properties=fullPathTo/sl.java.security

 

Another solution is to set WebSphere SSL configuration to use the IBM JSSE implementation by defining the content of sl.java.security file as below

 

References