How to enable SSL debug when using the WebSphere application server with RSA Identity Governance & Lifecycle
Originally Published: 2015-08-14
Article Number
Applies To
RSA Version/Condition: All versions
Platform: WebSphere
Issue
This debug could be used to troubleshoot connectivity from:
- The Access Fulfillment Express (AFX) instance to the application server.
- The application server to a collector.
- A browser connecting to the application server.
- Using an unsupported TLS version.
- No common SSL ciphers between the client and server.
- An unsupported or invalid certificate attribute.
- Deprecated certificate signing algorithm.
- A keystore referenced in the debug is different than what was expected.
Resolution
SSL Debug Trace for IBM WebSphere
CAUTION: These traces should be removed as soon as you have reproduced the problem and collected the trace. This debug trace generates a significant amount of events in the WebSphere SystemOut.log file.
- In the WebSphere Application Server (WAS) Admin Console, navigate to Servers > Server Types > WebSphere application servers, then select the server name.
- Under Server Infrastructure, expand Java and Process Management > Process definition > Java Virtual Machine.
- Add the following to the end of the Generic JVM Arguments box:
-Djavax.net.debug=ssl,handshake,data,trustmanager
- Save to the master config, and restart the server for it to take hold.
- This will add debug trace of the SSL handshake to the <Websphere installation>/<AppServer>/profiles/<profile name>/logs/<server name>/SystemOut.log
NOTE: To get useful/verbose messages, the IBM Trust manager may need to be changed from IbmPKIX to IbmX509. This setting is in the WebSphere Admin GUI under Security > SSL Certificate and Key Management > SSL configurations > Select Resource > Trust and Key Managers. The default trust manager for that resource can be changed using the pull-down menu.
Related Articles
How to call a stored procedure from the Generic Database AFX Connector in RSA Identity Governance & Lifecycle 46Number of Views "ORA-00020: maximum number of processes (500) exceeded" when attempting to connect to the Oracle Database on IGL 43Number of Views RSA G&L Community Exchange Overview and FAQs 151Number of Views AFX Server installs on Windows in a non-functional state due to JAVA_HOME in RSA Governance & Lifecycle 25Number of Views Howto: Change the Master Encryption Key Storage Directory in RSA Identity Governance and Lifecycle (IGL) 108Number of Views
Don't see what you're looking for?