Using IBM MQ AMS with IBM MQ Managed File Transfer

This scenario explains how to configure IBM® MQ Advanced Message Security to provide message privacy for data being sent through an IBM MQ Managed File Transfer.

Before you begin

Ensure that you have IBM MQ Advanced Message Security component installed on the IBM MQ installation hosting the queues used by IBM MQ Managed File Transfer that you wish to protect.

If your IBM MQ Managed File Transfer agents are connecting in bindings mode, ensure you also have the IBM Global Security Kit (GSKit) component installed on their local installation.

About this task

When transfer of data between two IBM MQ Managed File Transfer agents is interrupted, possibly confidential data might remain unprotected on the underlying IBM MQ queues used to manage the transfer. This scenario explains how to configure and use IBM MQ Advanced Message Security to protect such data on the IBM MQ Managed File Transfer queues.

In this scenario we consider a simple topology comprising one machine with two IBM MQ Managed File Transfer queues and two agents, AGENT1 and AGENT2, sharing a single queue manager, as described in the scenario Scenario overview. Both agents connect in the same way, either in bindings mode or client mode.

1. Creating certificates

Before you begin

This scenario uses a simple model where a user ftagent in a group FTAGENTS is used to run the IBM MQ Managed File Transfer agent processes. If you are using your own user and group names, change the commands accordingly.

About this task

IBM MQ Advanced Message Security uses public key cryptography to sign and/or encrypt messages on protected queues.
Note:
  • If your IBM MQ Managed File Transfer agents are running in bindings mode, the commands that you use to create a CMS (Cryptographic Message Syntax) keystore are detailed in the Quick Start Guide ( Windows or UNIX ) for your platform.
  • If your IBM MQ Managed File Transfer agents are running in client mode, the commands you will need to create a JKS ( Java Keystore) are detailed in the Quick Start Guide for IBM MQ AMS with Java clients.

Procedure

  1. Create a self-signed certificate to identify the user ftagent as detailed in the appropriate Quick Start Guide.
    Use a Distinguished Name (DN) as follows: 
    
CN=ftagent, OU=MFT, O=<organisation>, L=<location>, ST=<state>, C=<country>
  2. Create a keystore.conf file to identify the location of the keystore and the certificate within it as detailed in the appropriate Quick Start Guide.

2. Configuring message protection

About this task

You should define a security policy for the data queue used by AGENT2, using the setmqspl command. In this scenario the same user is used to start both agents, and therefore the signer and receiver DN are the same and match the certificate we generated.

Procedure

  1. Shut down the IBM MQ Managed File Transfer agents in preparation for protection using the fteStopAgent command.
  2. Create a security policy to protect the SYSTEM.FTE.DATA.AGENT2 queue. 
    
setmqspl -m hubQM -p SYSTEM.FTE.DATA.AGENT2 -s SHA1 -a "CN=ftagent, OU=MFT, O=<organisation>, L=<location>, ST=<state>, C=<country>"
-e AES128 -r "CN=ftagent, OU=MFT, O=<organisation>, L=<location>, ST=<state>, C=<country>"
  3. Ensure the user running the IBM MQ Managed File Transfer agent process has access to browse the system policy queue and put messages on the error queue. 
    
setmqaut -m hubQM -t queue -n SYSTEM.PROTECTION.POLICY.QUEUE -p ftagent +browse
setmqaut -m hubQM -t queue -n SYSTEM.PROTECTION.ERROR.QUEUE -p ftagent +put
  4. Restart your IBM MQ Managed File Transfer agents using the fteStartAgent command.
  5. Confirm that your agents restarted successfully by using the fteListAgents command and verifying that the agents are in READY status.

Results

You are now able to submit transfers from AGENT1 to AGENT2, and the file contents will be transmitted securely between the two agents.