You want to set up a secure connection using self-signed certificates between WebSphere MQ C/C++ client to MQ server. However, in the client environment, there is no MQ queue manager, so you can not use the naming rule for the self-signed certificate, which is “ibmwebspheremq + QMName”.
How can you create a certificate for MQ client?
How about if there are no tools to create the certificate? Why can not you connect to an MQ queue manager when the attribute SSLCAUTH of server connection channel is set to REQUIRED?
You see the following error:
AMQ9637: Channel is lacking a certificate.
EXPLANATION: The channel is lacking a certificate to use for the SSL handshake. The channel name is 'SSLTEST.SVRCONN' (if '????' it is unknown at this stage in the processing). The channel did not start. ACTION: Make sure the appropriate certificates are correctly configured in the repositories for both ends of the channel.
When the attribute SSLCAUTH server connection channel is set to REQUIRED, the server channel needs to receive and authenticate an SSL certificate from the client. To create a certificate for the client and connect to the MQ server, please refer to the instructions below.
1. Create a key store and a self-signed certificate at MQ client with the name:
ibmwebspheremq + username (such as: ibmwebspheremqsmith).
If there are no tools (such as: gsk7capicmd, gsk7cmd) to create the key store and the certificate, you can do this on another machine and copy the generated files (such as: client.crl, client.kdb, client.rdb, client.sth) to the client machine.
gsk7capicmd -keydb -create -db /var/test/ssl/client.kdb -pw Password -type cms -expire 1825 -stash
gsk7capicmd -cert -create -db /var/test/ssl/client.kdb -pw Password -label ibmwebspheremqsmith -dn "CN=SMITH " -size 2048 -expire 1825
2. Extract the signer certificate client.arm for later use.
gsk7capicmd -cert -extract -db /var/test/ssl/client.kdb –pw Password -label ibmwebspheremqsmith -target /var/test/ssl/client.arm -format ascii
3. For the MQ queue manager, you also need to
- create the key store
- create a self-signed certificate (label is “ibmwebspheremq + QMName”)
- extract the signer certificate.
The label for the following example is: ibmwebspheremqqmtest (the queue manager is QMTEST).
- gsk7capicmd -keydb -create -db /var/mqm/qmgrs/QMTEST/ssl/key.kdb -pw Password -type cms -expire 1825 -stash
- gsk7capicmd -cert -create -db /var/mqm/qmgrs/QMTEST/ssl/key.kdb –pw Password -label ibmwebspheremqqmtest -dn "CN=QMTEST" -size 2048 –expire 1825
- gsk7capicmd -cert -extract -db /var/mqm/qmgrs/QMTEST/ssl/key.kdb –pw Password -label ibmwebspheremqqmtest –target /var/mqm/qmgrs/QMTEST/ssl/key.arm -format ascii
For the client:
gsk7capicmd -cert -add -db /var/test/ssl/client.kdb –pw Password -label ibmwebspheremqqmtest –file /var/mqm/qmgrs/QMTEST/ssl/key.arm -format ascii
For the server:
gsk7capicmd -cert -add -db /var/mqm/qmgrs/QMTEST/ssl/key.kdb -pw Password-label ibmwebspheremqsmith -file /var/test/ssl/client/client.arm -format ascii
Once the client certificate is added to the queue manager's keystore, use the "runmqsc" command (or other available queue manager command interface) to issue the command:
REFRESH SECURITY SSL
5. Set the proper environment variables on the client side. For the use of a client channel definition table (CCDT), you have to set MQCHLTAB and MQCHLLIB besides MQSSLKEYR.
export MQSSLKEYR = /var/test/ssl/client/client
Now, the certificates for the client and the server are ready. You can test the connection using the sample application amqssslc. For this application, please consult the following document.
WebSphere MQ > Application Programming Guide > Sample WebSphere MQ programs > Sample programs (platforms except z/OS) > The SSL/TLS sample program > Running the SSL/TLS sample program
Using self-signed certificates for mutual authenticatio
Using CA-signed certificates for mutual authentication
Questions regarding WMQ Java JMS clients and the SSL
Set up SSL 2-way authentication between a Java client a
|Business Integration||WebSphere MQ||SSL|
WebSphere MQ WMQ
Rate this page:
Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.