Open a web browser and navigate to the Lamaxu Admin page.
Example, http://localhost:8085/admin (the default username and password is admin/password)
Navigate to the 'Queue Managers' tab and enter the required Cipher Suite into the Cipher input box. Note the Cipher Suite used needs to match the Cipher Spec on the MQ channel.
To Import a Trust Certificate
keytool -importcert -file mycert.txt -keystore truststore.jks -alias mycert
Where mycert.txt is is your trust certificate.
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
MQ CipherSpec | Equivalent CipherSuite (IBM JRE) | Equivalent CipherSuite (Oracle JRE) | Protocol |
|---|---|---|---|
| TLS_RSA_WITH_AES_128_CBC_SHA | SSL_RSA_WITH_AES_128_CBC_SHA | TLS_RSA_WITH_AES_128_CBC_SHA | TLS v1 |
| TLS_RSA_WITH_AES_128_CBC_SHA256 | SSL_RSA_WITH_AES_128_CBC_SHA256 | TLS_RSA_WITH_AES_128_CBC_SHA256 | TLS v1.2 |
| TLS_RSA_WITH_AES_256_CBC_SHA | SSL_RSA_WITH_AES_256_CBC_SHA | TLS_RSA_WITH_AES_256_CBC_SHA | TLS v1 |
| TLS_RSA_WITH_AES_256_CBC_SHA256 | SSL_RSA_WITH_AES_256_CBC_SHA256 | TLS_RSA_WITH_AES_256_CBC_SHA256 | TLS 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