Configuring access for connecting an application to a queue manager

To connect an application to a queue manager, it must have been granted permissions to access queue managers within your IBM® MQ service instance. The application must connect to the queue manager using its Application username and the password must be the application's API key.

Note: Applications have access to connect to all queues and topics starting with DEV.*. They have permission to put / get messages and publish / subscribe to topics.

If you want to know more about IBM MQ users and applications before proceeding, see Users and applications. To learn more about roles and permissions, see Service roles. To complete this task you must be an IBM MQ as a Service service administrator.

For instructions on accessing the IBM MQ as a Service UI, see Getting started with IBM MQ as a Service.

Granting an application permission to access queue managers within your service instance

  1. Once in IBM MQ as a Service, click the Application credentials tab. (For IBM Cloud, this is accessed from the Manage menu option within the service instance view.)
    shows the Applications Credentials tab
  2. Click Add.
  3. Enter a Name and Description that will help you identify the application.
  4. A unique application username is generated for you.
    Note: You can edit the text-box to change this to your preferred username. It must have a maximum of 12 characters and be lower case a-z or 0-9. It must also be unique within your IBM MQ service instance.
  5. Click Add and Generate API key.
  6. Click Show to display the API key to copy and save it for later, or click Download to store the API Key in a file.
  7. Click Close.

For security reasons, the API key is only available to be copied or downloaded at the time of creation. If the API key is lost, you must create a new API key.

The application that was added will now have permissions to access queue managers within your IBM MQ service instance. You have now obtained the application username and API key for this application.