Skip to main content

Amazon MSK Integration with Orkes Conductor

note

The Amazon MSK configuration is deprecated. For new configurations, use Apache Kafka.

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 Amazon MSK with Orkes Conductor to publish and receive messages from topics. Here’s an overview:

  1. Get the required credentials from Amazon MSK.
  2. Configure a new Amazon MSK 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 Amazon MSK credentials

To integrate Amazon MSK with Orkes Conductor, retrieve the following credentials from your Amazon MSK console:

Refer to the official Amazon MSK documentation for more details.

Step 2: Add an integration for Amazon MSK

After obtaining the credentials, add an Amazon MSK integration to your Conductor cluster.

To create an Amazon MSK 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 Amazon MSK.
  4. Select + Add and enter the following parameters:
ParemetersDescription
Integration nameA name for the integration.
Bootstrap ServerThe bootstrap server of the Amazon MSK cluster.
Sending ProtocolThe sending protocol for the integration. Supported values:
  • String.
Connection SecurityThe security mechanism for establishing connection. Supported values:
  • SASL_SSL / SCRAM-SHA-512.
UsernameThe username of the Amazon MSK account.
PasswordThe password associated with the username.
Consumer Group IDThe Consumer Group ID from Kafka. This unique identifier helps manage message processing, load balancing, and fault tolerance within consumer groups.
DescriptionA description of the integration.

Amazon MSK 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 Amazon MSK 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: