Step 3: Connecting to Microsoft Azure

This is the final step in setting up your CloudGate. 

Please follow the instructions below carefully.

1. Browse to the “Main Menu” →  “Applications” tab.
   
   
2. Enable “Azure IoT Hub” in the output section. A button called “Azure IoT Hub” will appear on your right hand side.
   
   
3. Click on this “Azure IoT Hub” button to configure the CloudGate to connect to your Azure instance.
   
   
4. Leave all settings as they are in the “Settings” section and proceed to the “Connection Settings” section below.
   
   
5. Enable the Azure connection and enter the parameters to establish a connection to your Azure instance. You can use x509 certificates, SAS Token or DPS. We highly recommend to use DPS as it's the easiest way of duplicating this configuration on many devices, yet in a secure manner. You can find the ID Scope on your Azure instance in the "Device Provisioning Service" section. The Primary key can be found, or generated, in the "Manage Enrollments" menu in the "Device Provisioning Service" section. For more information on Azure DPS, please read the following article: https://docs.microsoft.com/en-us/azure/iot-dps/quick-setup-auto-provision
   

6. After completion, press the Save changes button.
   
   
7. In the “Data format” section, you can configure the topic style and payload style. 
   These can be:  
       hardcoded for ex. “my-topic” or 
       dynamic, for ex. “data/{{protocol}}/{{device}}/{{object}}”
       , where each value between {{ }} gets replaced with a dynamic value.
   
   
8. The payload style and formatting can be left unchanged.
   
   
9. After completion, press the Save changes button.
   
   
10. The CloudGate should now connect to your Azure IoT Hub. You can check the actual connection status at the bottom of the “Connection Status” section on the Azure IoT Hub tab.

Congratulations, your CloudGate is now fully configured to connect to your Cloud via the Azure IoT Hub protocol!