Azure IoT Hub

Below instructions help you connecting your Azure IoT Hub to KPN Things.

Don't have an Azure IoT Hub yet? Head on over to the Microsoft documentation on Azure IoT Hub. You can try one for free using the Azure free account!

Create an Azure IoT Hub - Azure IoT HubMicrosoftLearn

For now, a Basic tier will be sufficient for a working connection with KPN Things. Later, we will introduce downlink and device twin functionality to the connection and for that the Standard tier is required.

Connect an Azure IoT Hub

The following parameters are available to connect your Azure IoT Hub:

Parameter		Description	Example value
name	*	The name of the destination	My IoT Hub
description		Description of the destination	IoT Hub with all my devices
destinationFormat	*	The data format used for outgoing payloads	SenML
hostName	*	Host name of your IoT Hub	hubName.azure-devices.net
sasKeyName	*	The access policy name for KPN Things to use to connect to your IoT Hub
sasKey	*†	The primary key of the access policy for KPN Things to use

*) required value †) secret value, not returned by our API's

Where to find the required configuration values in the Azure Portal?

Hostname

You can find the hostname on the overview page of your IoT Hub, as highlighted in the screenshot below:

SAS key name and SAS key

For the key name and key you need to create a Shared access policy for your IoT Hub. Make sure you enable all permissions for the Policy you create for KPN Things, since all permissions are required:

• Registry write

• Service connect

• Device connect

After creation of your policy, you can find the SAS key name and SAS key in the

What does the connection do?

• KPN Things will register new devices in the IoT hub when IoT data is forwarded for devices that are not yet in the IoT Hub.

• KPN Things will forward all IoT data as telemetry in the IoT Hub from devices linked to the destination.

In the future we plan to support downlink communication using Cloud-to-Device communication in the IoT Hub, and we plan to support device twin synchronization between KPN Things and the IoT Hub.