Wiki

Connecting to HiveMQ Broker

If you have an existing broker on HiveMQ skip to step 2

1. Create HiveMQ Broker Cluster

2. Create Credentials

If you already have credentials make sure they are either client certificate or basic credentials (username password)

Get to the "Access Management" tab and click to edit your credentials.

Click to add a new credential and enter in a username and a password (make sure you remember it)

Under Permission select "Publish and Subscribe" (Just "Publish" will do, but you may want to use the credentials again elsewhere for "Subscribe" as well)

Once you're done and have clicked "save" it should look like this, except with the username you chose.

3. Find Your URL

4. Create & Config MQTT Incon

Create MQTT Incon

1. Navigate to and create a new Input Connector using the sidebar

2. Give your output connector a name, for example "MQTT Example" or "Test Input Connector".

3. Select "MQTT Client" and click "OK"

Add your URL

Copy the URL from step 3 into the text field that says "Host Domain"

Add Your Topic

Add a topic that this MQTT client will subscribe to. In this example we will use "rldTest"

Add Your Credentials

1. Open the creds tab and click to add a new credential

   

2. Name this "test credential" and add the username and password you created in step 2

   

3. Go back to the 'Config & Status" tab and select your credentials

   

5. Test Connection

Put Your MQTT Incon into Test Mode

Testing with HiveMQ

1. Connect with autogenerated credentials
   Go to the "Web Client" tab and click "Connect with autogenerated credentials"

   

2. Send Test Message
   Scroll down on the page to find "Send Message". Give it the topic you chose in step 4. Next put in the following message:
   {"id":1, "date":"Fri Apr 04 2025 15:22:44 GMT-0500 (Central Daylight Time)","data": {"temp":96.1, "psi":60.1}}

   

3. Check your RLD Input Connector
   Go back to your RLD Incon and go to the "Incoming Fields" tab, where you should see the following if you have done everything correctly

   

6. Translate Incoming Data

Watch the following gif which shows you how to find the new fields and drag them into RLD One's automatic translation tool

7. Activate Your New Incon

Once you've done all this and been successful in setting up your RLD MQTT Input Connector all that is left is to take it out of test mode.
Go back to the "Config & Status" tab and click on the "Run" button on the stoplight and you're all good to go!

---

Connecting to Amazon AWS IoT Core

1. Go to IoT Core and Create a Thing

• Go to the IoT Core page in your AWS console
• Make sure you are in the correct Region, the link above went to "us-east-2"
• Find the button that says "Connect one device"

• Find this line and copy the URL (we need to save this for late in step 5)

  

• Click "Next" at the bottom right of the page

• Click "Create a New Thing" (Unless you already have an AWS Thing you would like to use, in which case skip to step 2)
• Give it a Name, if this example we will use "RLD-Test"
• Click "Next"
• Choose the "Platform" as "Linux / macOS"
• Choose the "AWS IoT Device SDK" as "Node.js"
• Click "Next"
• Click "Download connection kit"
• Click "Next"
• Click "Continue" at the bottom right side of the page
• Click "View Thing" in the bottom right of the page
• Keep this tab open, we will use it again in [step 5]

2. Create an MQTT Incon

Create MQTT Incon

1. Navigate to and create a new Input Connector using the sidebar

2. Give your output connector a name, for example "MQTT Example" or "Test Input Connector".

3. Select "MQTT Client" and click "OK"

Add your URL

Copy the URL from step 1 into the field that says "Host Domain"

Add Your Topic

Add a topic that this MQTT client will subscribe to. In this example we will use "rldTest"

3. Create RLD Credentials

• To do this one you're going to want to unzip and open the "Connection Kit" from our AWS Thing Device we made in [step 1]

• Now in RLD we need to create a new credential

  

• Now we need to grab the certificate and private key from our "Connection Kit"

  

• Once you've done this the page should look like this. Click "OK"

  

4. Create RLD Server Credentials

• To do this first you need to visit this link and download the file from it: https://www.amazontrust.com/repository/AmazonRootCA1.pem

  

• Now on the RLD Credentials page click on "Add New Server CA Certificate"

  

• Upload the certificate you downloaded to this screen, it should look something like this.

  

• Click "OK"

5. Configure AWS policy

1. Go to the tab that we kept open at the end of [step 1]
2. Find the certificates tab on this page
3. Click the "Certificate ID" that we just created (should look like a random assortment of blue letters and numbers)
4. Go down where it says policies and click on the first name in the list (should be blue text)
5. In the top right you should see a button that says "Edit active version" click it
6. Find on the right where it says "Builder | JSON" and click on "JSON"
7. Edit the last lines of all the "Resources" arrays to contain an open rule (follow the gif below)

8. Activate this new policy by scrolling all the way down, selecting the highest version number (should be 2) and then clicking the "Set as active" button (follow the gif below)

   Here is a short video of the whole process:

6. Configure Your RLD MQTT Incon

Host Domain

• Grab your Host Domain from [step 1]

Choose Topic

• Choose a topic, in order to test for this example we will choose "rldTest"

Select Your Credentials

• Select the User credentials we made in step 4
• Select the Server credentials that we made in step 4

From here you should be able to go into testing mode!

7. Testing

Set your Incon into Testing Mode

'

Testing with AWS

1. Open AWS MQTT Test Client
   Give that 10 seconds to begin working then go back to AWS and open up the aws test client here:

   

2. Publish a test message
   Select "Publish to a topic" and enter in a topic name that matches the topic we chose in step 6 Put in the following message then click "Publish": {"id":1, "date":"Fri Apr 04 2025 15:22:44 GMT-0500 (Central Daylight Time)","data": {"temp":96.1, "psi":60.1}}

   

3. Check your RLD Input Connector (Incon) Go back to your RLD Incon and go to the "Incoming Fields" tab, where you should see the following if you have done everything correctly

   

8. Translate Incoming Data

Watch the following gif which shows you how to find the new fields and drag them into RLD One's automatic translation tool

9. Activate Your New Incon

Once you've done all this and been successful in setting up your RLD MQTT Input Connector all that is left is to take it out of test mode.
Go back to the "Config & Status" tab and click on the "Run" button on the stoplight and you're all good to go!

---