Azure Part 1 - Connecting to Azure IoT Hub

To Connect deviceWISE to your Azure IoT Hub:

1. Create an IoT Hub using the Azure portal. For more information on creating an IoT Hub, see Create an IoT hub using Azure.
2. Create a new device in the IoT Hub. For more information on registering a new device in IoT Hub, see Register a new device in the IoT hub.
3. From the Azure portal's Overview menu, click the Copy to clipboard icon located adjacent to Hostname
4. On the deviceWISE Workbench go to the node you want to configure and select the Azure under Cloud Connectors
5. Paste the Hostname in to Service Endpoint field
   
6. Click Connection Method drop-down and select IoT Hub.
7. Click Authentication Method and do one of the following:
   1. Select Symmetric Key and enter the Symmetric Key in the Symmetric Key field. To get the Symmetric Key and the Device ID:
      1. From the Azure portal's IoT devices menu, click on the device you want to connect.
         
      2. Copy and Paste the Device ID and Symmetric Key (In Azure portal's it is the Primary Key)
         
   2. Select Certificate and enter the Certificate and Private Key in the respective fields.
8. Click Connect.
   The Status changes to Connected indicating that the deviceWISE is connected to the Azure IoT Hub.

Prerequisites

You will need the following for connecting to Azure IoT Hub through IoT Edge:

• An IoT Hub and an IoT Device created on the Hub.
• The device ID of the IoT Device defined on the IoT Hub.
• The symmetric key or Certificate/Private Key pair of the device placed in Staging Browser.
• The IoT Hub Hostname/Service Endpoint found on your IoT Hub overview panel.
• An IoT Edge deployment configured with a Certificate/Private Key Pair and a reachable Hostname.
• The root certificate used to generate the IoT Edge Certificate placed in Staging Browser.

To Connect deviceWISE to your Azure IoT Edge Gateway:

1. On the deviceWISE workbench go to the node you want to configure and select the Azure under Cloud Connectors
   
2. Click Connection Method drop-down and select IoT Edge Device.
3. Click Authentication Method and do one of the following:
   1. Select Symmetric Key and enter the Symmetric Key in the Symmetric Key field.
   2. Select Certificate and enter the Certificate and Private Key in the respective fields.
4. Enter the Device ID.
5. Enter the IoT Edge Hostname defined in the IoT Edge's config.yaml
6. Enter the IoT Edge Gateway Certificate.
7. Click Connect.

Prerequisites

You will need the following information when connecting to Azure IoT Hub DPS:

• An Azure IoT Device Provisioning Service connected to an Azure IoT Hub with an individual or group enrollment.
• A Symmetric Key, for individual enrollments this will be generated for you, for group enrollments this will need to be generated from the group master key.
• The Device Provisioning Service (DPS) Endpoint
• The DPS ID Scope value
• The device Registration ID

To Connect deviceWISE to your DPS:

1. On the deviceWISE workbench go to the node you want to configure and select the Azure under Cloud Connectors
2. Click Connection Method drop-down and select Device Provisioning Service.
3. Click Authentication Method and do one of the following:
   1. Select Symmetric Key and enter the Symmetric Key in the Symmetric Key field.
4. Enter the ID Scope.
5. Enter the device Registration ID
6. Click Connect.

To Connect deviceWISE to your Azure IoT Hub DPS using certificates, you will need:

• An Azure IoT Device Provisioning Service connected to an Azure IoT Hub with an individual or group enrollment configured to use X.509

• Device Certificate and corresponding private key:

  • Certificate chain for group enrollment

  • Device certificate for individual enrollment

• The Device Provisioning Service (DPS) Global device endpoint (to be placed as the hostname field on Workbench)

• The DPS ID Scope value

For more information about using Azure IoT Hub X.509 certificates with Azure Device Provisioning Service.

1. On the deviceWISE workbench go to the node you want to configure and select the Azure under Cloud Connectors
   
2. Click Authentication Method and select Certificate, enter the Individual Certificate or Group Certificate Chain and the device certificate's corresponding private key.
3. Enter the ID Scope and Global Device endpoint. (Global Device endpoint must be inserted onto the Workbench's Hostname field)
   
4. Click Connect.