---
title: AMQP SSL
slug: bhdo/amqp-ssl
createdAt: 2022-11-14T19:02:44.000Z
---

Review the following use case to integrate Belden Horizon Data Operations with an AMQP SSL connector to send and receive data (messages).&#x20;

# Step 1: Add a Device

Follow the steps to [Connect a Device](https://public-docs.litmus.io/bhdo/connect-a-device). The device will be used to store tags that will be eventually used to create outbound topics in the connector. Make sure to select the **Enable Data Store** check box.&#x20;

# Step 2: Add Tags

After connecting the device in Belden Horizon Data Operations, you can [Add Tags](https://public-docs.litmus.io/bhdo/add-tags) to the device. Create tags that you want to use to create outbound topics for the connector.&#x20;

# Step 3: Add the AMQP SSL Connector

Follow the steps to [Add a Connector](https://public-docs.litmus.io/bhdo/add-a-connector) and select the **AMQP SSL** provider.&#x20;

Enter the details for the connector.&#x20;

- **Name**: A recognizable name to identify the connector.&#x20;
- **Hostname**: The AMQP broker's IP address.&#x20;
- **Port**: The AMQP broker's port number. The default value is **5671**.&#x20;
- **Virtual host** (Optional): The virtual host path, which specifies the namespace for permissions, exchanges, queues, and bindings on the server.
- **Username&#x20;**(Optional): The user name for authentication with the AMQP broker. The default value is **guest**.&#x20;
- **Password&#x20;**(Optional): The password for authentication with the AMQP broker. The default value is **guest**. &#x20;
- **Exchange&#x20;**(Optional): The northbound (third-party) topic to publish or subscribe to through the connector.
- **exchangeType**: Select the exchange type (direct, fanout, topic, x-custom).&#x20;
- **Exchange durable**: Select the check box to allow the exchange to survive restarts.&#x20;
- **Exchange auto delete**: Select the check box to make the server no longer remain declared when there are no remaining bindings.&#x20;
- **Exchange internal**: Select the check box to enable the *internal&#x20;*&#x66;lag.&#x20;
- **Exchange no wait**: Select the check box to instruct the exchange to not wait for a response.&#x20;
- **Routing key**: The AMQP routing key that the exchange might use to determine how to route messages to the queue.
- **ISO8601 timestamp**: Select this check box to convert message timestamps to the ISO8601 format before sending.
- **CA Certificate**: The SSL certificate authority (CA) certificate.&#x20;
- **Certificate&#x20;**(Optional): The self-signed SSL certificate.&#x20;
- **Private key** (Optional): The SSL private key.&#x20;
- **Throttling limit&#x20;**(Optional): The maximum number of messages per second to be processed. The default value is zero, which means that there is no limit.&#x20;
- **Persistent storage**: When enabled, this will cause messages to undergo a store-and-forward procedure. Messages will be stored within Belden Horizon Data Operations when cloud providers are online. &#x20;

# Step 4: Enable the AMQP SSL Connector

**To enable the connector:&#x20;**

1. Return to the *Belden Horizon Data Operations Integration* browser tab.
2. Click the connection toggle on the connector tile.&#x20;
   The connector shows connected after verifying the connection.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/nB5IkSuJY3jYcPpOQEzTg_image.png" size="60" width="355" height="264" caption="Toggle to enable connector" position="center" showCaption="true"}

# Step 5: Create Topics for AMQP SSL Connector

You will now need to create outbound topics for the connector from the tags created in Step 2.

**To create outbound topics:**

1. Click the connector tile.
   The connector *Dashboard&#x20;*&#x61;ppears.&#x20;
2. Click the **Topics&#x20;**&#x74;ab.&#x20;
3. Click the **Import from DeviceHub** tags icon.&#x20;
   The *DeviceHub Import&#x20;*&#x64;ialog box appears.

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/4fC8yaOKctxiiTvUDGfWu_import-from-devicehub.png" size="80" width="1148" height="570" position="center" showCaption="false"}
4. Select all the tags to import and click **Import**.&#x20;

After adding all required topics, navigate to the Integration overview page and click the toggle to restart the connector verify the status is CONNECTED.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/lkjc5VJ2p-JqjkbGyZkgG_image.png" size="60" width="355" height="264" caption="Toggle to enable connector" position="center" showCaption="true"}

# Step 6: Enable Topics

To enable the topics, return to the *Topics&#x20;*&#x74;ab and click the **Enable all topics** icon.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/bCV1JMfeMF7XQryi1HSGr_enable-all-topics.png" size="80" width="1148" height="570" caption="Enable all topics icon" position="center" showCaption="true"}

