RabbitMQ Connector Guide > RabbitMQ Connections > RabbitMQ Connection Properties
  

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.