IBM Support

Configuring TLSv1.3 on WebSphere Application Server 9.0.5.6 and 8.5.5.20 and later

News


Abstract

Starting in versions 9.0.5.6 and 8.5.5.20, WebSphere Application Server provides an option to select the TLSv1.3 protocol when running on IBM Java version 8.0.6.26 (and later)

Content

Starting in versions 9.0.5.6 and 8.5.5.20, WebSphere Application Server provides an option* to select TLSv1.3 protocol when running on IBM Java version 8.0.6.26 (and later). Following are more details and considerations on using the TLSv1.3 configuration.  
Notes: 
  1. The administrative console of WebSphere 9.0.5.6 and 8.5.5.20 and later shows TLSv1.3 when running on IBM Java version 8.0.6.26 and later.
  2. WebSphere fallback on TLSv1.2 when "TLSv1.3,TLSv1.2" is configured and TLSv1.3 is not supported by the peer. 
  3. If WebServer plug-in is a gateway to the application server, TLSv1.3 must be explicitly enabled: https://www.ibm.com/support/pages/apar/PH17128
  4. In a mixed cell configuration, careful consideration is required before enabling TLSv1.3 to ensure communications. 
  5. To change DMGR and all NODES to use TLSv1.3, first make changes with only the DMGR running, then restart the DMGR process, and sync each node from the command line. Then bring the DMGR and NODES up.  For detailed steps, refer to the technote "How can I configure WebSphere Application Server SSL protocol to use TLSv1.2 ONLY?"   
  6. FIPS 140-2 does not support TLS v1.3.  TLS v1.3 will be available with FIPS when FIPS 140-3 certified Java Security provider becomes available for WebSphere to use.  
  7. For WebSphere on zOS,  IBMJCEPlus provider was added by PH44197.  
Relevant APARs
APAR number APAR abstract Note Fixpack versions
PH29840
Create the ability to select TLSV1.3 protocol
TLSv1.3 protocol could not be combined with other protocols 9.0.5.6, 8.5.5.20
PH36842

Support for a customized list of SSL protocols

Multiple protocols can be configured. 
If TLSv1.3 is unavailable, WebSphere can fallback on TLSv1.2 for server configuration  
9.0.5.11, 8.5.5.21
PH45688 Changing the WebSphere default protocol to TLSv1.3,TLSv1.2 WebSphere's default configuration was changed from SSL_TLSv2 to TLSv1.3,TLSv1.2. Applies to newly created profile only. 9.0.5.13, 8.5.5.22
PH46566 TLSV1.3 FALLBACK FOR THIN CLIENT If TLSv1.3 is unavailable, WebSphere can fallback on TLSv1.2 for thin-client configuration 9.0.5.13, 8.5.5.22
PH44197 java.security for WebSphere 855 on zOS requires IBMJCEPlus provider configured Custom java.security file may need IBMJCEPlus provider manually added in order to make TLSv1.3 available. 8.5.5.22
Reference: 

[{"Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"ARM Category":[{"code":"a8m50000000CcyMAAS","label":"Security-\u003ESSL"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.0.5"}]

Document Information

Modified date:
15 November 2022

UID

ibm16421519