Skip to main content

IBM MQ Integration with Orkes Conductor

To use the Event task or enable Change Data Capture (CDC) in Orkes Conductor, you must integrate your Conductor cluster with the necessary message brokers. This guide explains how to integrate IBM MQ with Orkes Conductor to publish and receive messages from queues. Here’s an overview:

  1. Get the required credentials from IBM MQ.
  2. Configure a new IBM MQ integration in Orkes Conductor.
  3. Set access limits to the message broker to govern which applications or groups can use them.

Step 1: Get the IBM MQ credentials

To integrate IBM MQ with Orkes Conductor, retrieve the following credentials from the IBM MQ server:

Refer to the official IBM documentation for more details.

Step 2: Add an integration for IBM MQ

After obtaining the credentials, add an IBM MQ integration to your Conductor cluster.

To create an IBM MQ integration:

  1. Go to Integrations from the left navigation menu on your Conductor cluster.
  2. Select + New integration.
  3. In the Message Broker section, choose IBM MQ.
  4. Select + Add and enter the following parameters:
ParametersDescriptionRequired / Optional
Integration nameA name for the integration.Required.
Host NameThe hostname or IP address of the IBM MQ server.Required.
PortThe port number that the IBM MQ server listens to for incoming connections. The default port is 1414, which varies depending on the connection requirements.Required.
Queue ManagerThe name of the queue manager that Orkes Conductor will connect to. Ensure the queue manager is already configured and running on your IBM MQ server.Required.
ChannelThe channel name that Orkes Conductor will use to communicate with IBM MQ. IBM MQ uses channels to establish connections between clients and queue managers.Required.
Connection SecurityThe type of connection security. Supported values:
  • With Username/Password
  • Passwordless
Required.
UserThe username to authenticate the connection to the IBM MQ server.Required if Connection Security is With Username/Password.
PasswordThe password associated with the username.Required if Connection Security is With Username/Password.
Select the preferred messaging methodThe messaging approach that suits your communication needs. Supported values:
  • Topic-based Messaging–Allows messages to be broadcasted to multiple subscribers based on the topics of interest, fostering a publish/subscribe model.
  • Queue-based Messaging–Allows point-to-point messaging, where messages are sent directly to individual queues for consumption by specific recipients.
Required.
Topic StringEnter the topic string in the format topic/ to specify the criteria for selecting topics in the messaging system. Use patterns to match topics of interest—for example, entering finance/ subscribes you to all topics under the finance category.Required if the messaging method is chosen as Queue-based Messaging.
Authentication typeSelect the authentication type. Supported values:
  • NONE–No authentication.
  • JKS–Uses Java KeyStore for authentication.
Required.
Choose Trust Store fileUpload the Java JKS trust store file with CAs.Required if Authentication type is JKS.
Trust Store PasswordThe password for the trust store file.Required if Authentication type is JKS.
Transport Layer SecurityChoose the TLS connection security. Supported values:
  • NONE
  • Using Cipher Suite
Required.
Cipher SuiteSelect an appropriate Cipher Suite for TLS. Supported values:
  • TLS_RSA_WITH_AES_128_CBC_SHA256
  • TLS_RSA_WITH_AES_256_CBC_SHA256
  • TLS_RSA_WITH_AES_256_GCM_SHA384
  • ANY_TLS12
Required if Transport Layer Security is usingCipherSuite.
DescriptionA description of the integration.Required.

IBM MQ Integration with Orkes Conductor

  1. (Optional) Toggle the Active button off if you don’t want to activate the integration instantly.
  2. Select Save.

Step 3: Set access limits to integration

Once the integration is configured, set access controls to manage which applications or groups can use the message broker.

To provide access to an application or group:

  1. Go to Access Control > Applications or Groups from the left navigation menu on your Conductor cluster.
  2. Create a new group/application or select an existing one.
  3. In the Permissions section, select + Add Permission.
  4. In the Integration tab, select the required message broker and toggle the necessary permissions.

Configuring RBAC for IBM MQ Integration

The group or application can now access the message broker according to the configured permissions.

Next steps

With the integration in place, you can now: