Skip to main content

Azure IoT Hub

Microsoft Azure IoT Hub enables highly secure and reliable communication between your Internet of Things (IoT) application and the devices it manages.

To help ensure stable device connectivity only use Console to connect to client ids. Other device monitoring tools in IoT Hub will connect to the device using the same client id which will cause connectivity instability.

important

For more information getting started with the Azure IoT Hub integration, check out our Tips & Tricks video on YouTube here.

On Azure IoT Hub

Prior to setting up an integration in Console, the following Azure IoT Hub information is required:

  • Hub Name
  • Policy Name
  • Primary Key

Log into your Azure IoT Hub account and on the left hand menu go to "Shared access policies".

Console requires the following permissions.

  • Registry Read: query Azure for devices in your hub
  • Registry Write: create devices in your hub
  • Device Connect: send messages through http/mqtt to your azure device
important

You must create your own policy and ensure it includes the permissions listed above. Although the iothubowner policy includes those by default it's not designed to be used for external integrations.

Whatever policy you choose, click it and a pane will appear. Copy the Primary Key information.

On Console

To add the integration in Console, go to Integrations on the left-hand menu.

Click the Add integration button.

Choose the Azure IoT integration icon.

Enter the Azure IoT Hub information into the corresponding fields on Console:

  • Hub Name (note just the hub name, not the entire hostname)
  • Policy Name
  • Primary Key

Remember the Azure IoT Hub policy must have the following permissions enabled: Registry Read, Registry Write, and Device Connect.

Adding a device

Every time the Azure IoT Hub integration starts up on Console, it will check if the device exists on IoT Hub, and if it doesn’t it will create one.