Configure Secure Sockets Layer for Java client authentication
WebSphere Application Server supports Java client authentication using a digital certificate when the client attempts to make a Secure Sockets Layer (SSL) connection. The authentication occurs during an SSL handshake. The SSL handshake is a series of messages exchanged over the SSL protocol to negotiate for connection-specific protection. During the handshake, the secure server requests that the client to send back a certificate or certificate chain for the authentication.
Before you beginTo configure SSL for Java client authentication, consider the following questions:
- Have you enabled security with your WebSphere Application Server? For more information, see Configuring global security.
- Have you configured Common Secure Interoperability (CSI) authentication protocol for your target application server? Refer to Configuring global security for more details.
Note: The Security Authentication Service (SAS) authentication protocol does not support Java client authentication with SSL transport.
- Have you configured your server to support secure transport for the CSIv2 inbound authentication protocol?
- Have you configured your server to support client authentication at the transport layer for the inbound CSI authentication protocol?
- If you are using a self-signed personal certificate, have you exported the public certificate from your client application Java keystore file or cryptographic token device?
- If you are using a certificate authority (CA)-signed personal certificate, have you received the root certificate of the CA?
- If you are using a self-signed personal certificate, have you imported the public certificate into your target Java truststore file as a signer certificate?
- If you are using a CA-signed (certificate authority) personal certificate, have you imported the CA root certificate into your target Java truststore file as a signer certificate?
- Does the common name (CN) specified in your personal certificate name exist in your configured user registry or is there a SAF mapping for the certificate?
If you answer yes to all of these questions that are appropriate to your product and platform, one can configure SSL for Java client authentication.
Note: Java client authentication using digital certificates is supported only by the CSIv2 (CSIv2) authentication protocol.
- Configuring CSIv2 for Secure Sockets Layer client authentication.
- Adding keystore files .
- Adding truststore files .
- Save changes.
- Restart the server if you configured the server.
What to do nextA secure client connects to a secure Internet InterORB Protocol (IIOP) server that requires client authentication at the transport layer. If a connection problem occurs, one can set a Java property, javax.net.debug=true, before you run your client or your server to generate debugging information. See Troubleshooting security configurations for further information about how to debug an IBMJSSE problem.
Configuring CSIv2 for Secure Sockets Layer client authentication
Adding keystore files
Adding truststore files
Editing the sas.client.props file using the administrative console
Authentication protocol for EJB security
Creating a Secure Sockets Layer repertoire configuration entry
Manage digital certificates
Configuring global security
Cryptographic token settings
WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.
IBM is a trademark of the IBM Corporation in the United States, other countries, or both.