RabbitMQ Connector Guide

RabbitMQ Connector Guide

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
.

0 COMMENTS

We’d like to hear from you!