Messaging and Queuing Connection Profiles

The following topics describe connection profiles for data processing and analytics platforms and services:

ConnectionProfile:AWS SNS
ConnectionProfile:AWS SQS
ConnectionProfile:RabbitMQ

ConnectionProfile:AWS SNS

AWS SNS (Simple Notification Service) is a cloud-based SNS that follows a Pub/Sub model and enables you to send notifications across various platforms and devices.

For more information about this plug-in, see Control-M for AWS SNS.

The following example shows how to define an AWS SNS connection profile that authenticates with AWS Key & Secret:

Copy

"AWS SNS": 
{
   "Type": "ConnectionProfile:AWS SNS",
   "AWS SNS URL": "https://sns.us-east-1.amazonaws.com",
   "AWS Region": "us-east-1",
   "Authentication Method": "Secret",
   "AWS Access Key": "<Access Key>",
   "AWS Secret": "*****",
   "Connection Timeout": "30",
   "Description": "",
   "Centralized": true
}

The following example shows how to define an AWS SNS connection profile that authenticates with IAM Role:

Copy

"AWS SNS": 
{
   "Type": "ConnectionProfile:AWS SNS",
   "AWS SNS URL": "https://sns.us-east-1.amazonaws.com",
   "AWS Region": "us-east-1",
   "Authentication Method": "IAM",
   "AWS IAM Role": "<IAM Role>",
   "Connection Timeout": "30",
   "Description": "",
   "Centralized": true
}

The following table describes AWS SNS connection profile parameters.

Parameter	Description
AWS SNS URL	Defines the AWS SNS authentication endpoint. https://sns.us-east-1.amazonaws.com
AWS Region	Determines the region where the AWS SNS jobs are located. us-east-1
Authentication	Determines one of the following authentication methods: Secret: Authenticates with an AWS access key and secret, which are used for services outside the AWS infrastructure. IAM: Authenticates with an AWS IAM role from within the AWS infrastructure, which removes the need to provide additional credentials.
AWS Access Key	Defines the access key assigned to the account in the AWS SNS setup.
AWS Secret	Defines the secret access key assigned to the account in the AWS SNS setup.You can use Secrets in Code to hide this value in the code.
AWS IAM Role	Defines the IAM role username on an EC2 instance with the required policies, and is used to acquire a temporary security token.
Connection Timeout	Determines the number of seconds to wait after Control-M initiates a connection request to AWS SNS before a timeout occurs. Default: 30
Centralized	Determines whether to create a centralized connection profile, which is stored in the Control-M/EM database and is available to all Agents. You must set this parameter to true.

ConnectionProfile:AWS SQS

AWS Simple Queue Service (SQS) is a message queuing service that enables you to exchange messages between components without losing messages.

For more information, see Control-M for AWS SQS.

The following example shows how to define an AWS SQS connection profile that authenticates with AWS Key & Secret:

Copy

"AWS SQS":
{
   "Type": "ConnectionProfile:AWS SQS",
   "AWS SQS URL": "https://sqs.us-east-1.amazonaws.com",
   "AWS Region": "us-east-1",
   "Authentication Method": "Secret",
   "AWS Access Key": "<Access Key>",
   "AWS Secret": "*****",
   "Connection Timeout": "30",
   "Description": "",
   "Centralized": true
}

The following example shows how to define an AWS SQS connection profile that authenticates with IAM Role:

Copy

"AWS SQS":
{
   "Type": "ConnectionProfile:AWS SQS",
   "AWS SQS URL": "https://sqs.us-east-1.amazonaws.com",
   "AWS Region": "us-east-1",
   "Authentication Method": "IAM",
   "AWS IAM Role": "<IAM Role>",
   "Connection Timeout": "30",
   "Description": "",
   "Centralized": true
}

The following table describes AWS SQS connection profile parameters.

Parameter	Description
AWS SQS URL	Defines the AWS SQS authentication endpoint. https://sqs.us-east-1.amazonaws.com
AWS Region	Determines the region where the AWS SQS jobs are located. us-east-1
Authentication	Determines one of the following authentication methods: Secret: Authenticates with an AWS access key and secret, which are used for services outside the AWS infrastructure. IAM: Authenticates with an AWS IAM role from within the AWS infrastructure, which removes the need to provide additional credentials.
AWS Access Key	Defines the access key assigned to the account in the AWS SQS setup.
AWS Secret	Defines the secret access key assigned to the account in the AWS SQS setup.You can use Secrets in Code to hide this value in the code.
AWS IAM Role	Defines the IAM role username on an EC2 instance with the required policies, and is used to acquire a temporary security token.
Connection Timeout	Determines the number of seconds to wait after Control-M initiates a connection request to AWS SQS before a timeout occurs. Default: 30
Centralized	Determines whether to create a centralized connection profile, which is stored in the Control-M/EM database and is available to all Agents. You must set this parameter to true.

ConnectionProfile:RabbitMQ

RabbitMQ is a message broker for applications that require message delivery and routing capabilities.

For more information about this plug-in, see Control-M for RabbitMQ.

The following example shows how to define a RabbitMQ connection profile:

{
  "RMQ": {
    "Type": "ConnectionProfile: RabbitMQ",
    "Description": "",
    "RabbitMQ URL": "http://dba-server.bmc.com",
    "Port": "15672",
    "Username": "BMC",
    "Password": "*****",
    "Connection Timeout": "50",
    "Centralized": true
  }
}

                                                    

The following table describes the RabbitMQ connection profile parameters.

Parameter	Description
RabbitMQ URL	Defines the URL of the RabbitMQ Server. http://dba-server.bmc.com
Port	Defines the port to access the RabbitMQ Server. Default: 15672
Username	Defines the username used to access the RabbitMQ Server.
Password	Defines the password used to access the RabbitMQ Server. You can use Secrets in Code to hide this value in the code.
Connection Timeout	Determines the number of seconds to wait after Control-M initiates a connection request to RabbitMQ Server before a timeout occurs. Default: 50
Centralized	Determines whether to create a centralized connection profile, which is stored in the Control-M/EM database and is available to all Agents. You must set this parameter to true.