RabbitMQ Connector Guide

Back Next

RabbitMQ Connection Properties

When you select

RabbitMQ

as the connection type, you can configure RabbitMQ-specific connection properties on the

Properties

tab of the connection creation page.

Connection Settings

You must specify the RabbitMQ host and RabbitMQ port that you want to connect to. You can also enable TLS or SSL authentication.

The following table defines the RabbitMQ connection properties that you must configure in the

Connection Settings

section:

Property	Description
Host Name	Required. Host name of the machine where the RabbitMQ instance or cluster runs that the Secure Agent must connect to with a TCP connection.
Port	Required. Port number for the host where the RabbitMQ instance or cluster runs. Default is 5762 .
Virtual Host	Optional. Specify the virtual host that the RabbitMQ channel connects to. Default is / .
TLS Protocol	Optional. Specify whether you want to use TLS or SSL protocol to connect to RabbitMQ. Select one of the following values: TLS SSLv3 Disabled Default is Disabled .

Access Settings

You can configure the user name and password to connect to a RabbitMQ instance with different privileges and permissions. Users can also be assigned permissions to specific virtual hosts.

The following table defines the RabbitMQ connection properties that you must configure in the

Acesss Settings

section:

Property	Description
User Name	Required. User name to connect to RabbitMQ.
Password	Required. Password to connect to RabbitMQ.

Security Protocol Settings

You can configure TLS or SSL authentication to encrypt and securely transfer data between a RabbitMQ producer, RabbitMQ consumer, and a RabbitMQ instance. When you configure TLS or SSL authentication, a Certificate Authority signs and issues a certificate to the RabbitMQ client. The RabbitMQ broker uses the certificate to verify the identity of the client.

If you enable SSL authentication, you must configure the following authentication properties in the

Security Protocol Settings

section:

Property	Description
Trust All	Select Yes to enable the connection to trust any server certificate. Default is No .
Truststore Location	The absolute path and file name of the truststore file on the Secure Agent machine that contains the TLS or SSL certificate to establish two-way secure communication with the RabbitMQ broker. For example: C:/SSL/Certs_208/icrt-truststore.jks If left blank, the connection uses the default truststore that is set through the javax.net.ssl.trustStore JVM argument.
Truststore Password	The password for the truststore file that contains the TLS or SSL certificate. If left blank, the connection uses the default password that is set through the javax.net.ssl.trustStorePassword JVM argument.
Keystore Location	The absolute path and file name of the keystore file on the Secure Agent machine that contains the keys and certificates required to establish two-way secure communication with the RabbitMQ broker. For example: C:/SSL/Keys/icrt-keystore.jks If left blank, the connection uses the default keystore that is set through the javax.net.ssl.keyStore JVM argument. The connection trusts any server certificate regardless of whether the Trust All property is set to Yes or No .
Keystore Password	The password to access the keystore file that contains the TLS or SSL certificate for secure communication. If left blank, the connection uses the default password that is set through the javax.net.ssl.keyStorePassword JVM argument.

Advanced Settings

You configure advanced RabbitMQ attributes to ensure that the message is delivered to a queue successfully.

The following table defines the RabbitMQ connection properties that you must configure in the

Advanced Settings

section:

Property	Description
Connection Timeout	Required. Number of seconds to wait when attempting to connect to RabbitMQ. Default is 60 seconds.
Heartbeat Timeout	Required. Heartbeat timeout in seconds requested for the RabbitMQ connection. Default is 60 seconds.
Enable Mandatory Message Routing	Optional. Select Yes to throw an exception when a message cannot be routed to a queue. If you select No , the RabbitMQ server silently drops the message. Default is Yes .
Enable Guaranteed Message Delivery	Optional. Select Yes to throw an exception when the message cannot be delivered and the mandatory message routing is enabled. Default is Yes .