Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

NOTE: The default password for the truststore.jks file is 'changeit'

MQ Java TLS CipherSpecs and CipherSuites for Oracle Java 8 Usage

Download the JCE 8

The Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files need to be downloaded and installed in order for the Oracle JRE to support the required CipherSuites in the table below. 

After downloading the JCE, extract and copy the JCE jurisdiction policy JAR files below to the target locations.

local_policy.jar (Unlimited strength local policy file)
US_export_policy.jar (Unlimited strength US export policy file)

Target locations

<java-home>/lib/security [Unix]
<java-home>\lib\security [Windows]

Recommended CipherSpecs and Equivalent CipherSuites 

https://www.ibm.com/support/knowledgecenter/en/SSFKSJ_8.0.0/com.ibm.mq.dev.doc/q113210_.htm 

_RSA_WITH_AES_128_CBC_SHA
MQ CipherSpecEquivalent CipherSuite (IBM JRE)
Equivalent CipherSuite (Oracle JRE)
Protocol
TLSSSL_RSA_WITH_AES_128_CBC_SHATLS_RSA_WITH_AES_128_CBC_SHATLS v1
TLS_RSA_WITH_AES_128_CBC_SHA256SSL_RSA_WITH_AES_128_CBC_SHA256TLS_RSA_WITH_AES_128_CBC_SHA256TLS v1.2
TLS_RSA_WITH_AES_256_CBC_SHASSL_RSA_WITH_AES_256_CBC_SHATLS_RSA_WITH_AES_256_CBC_SHATLS v1
TLS_RSA_WITH_AES_256_CBC_SHA256SSL_RSA_WITH_AES_256_CBC_SHA256TLS_RSA_WITH_AES_256_CBC_SHA256TLS v1.2

Required JRE Startup Option for Oracle JRE

Once the Cryptography Extension Jars have been installed, the Java option below needs to be added to the JRE startup . This option enables the use of the equivalent Oracle JRE CipherSuites shown in the table above. 

-Dcom.ibm.mq.cfg.useIBMCipherMappings=false