What is Azure IoT Hub Device Provisioning Service?
Microsoft Azure provides a rich set of integrated public cloud services for all your IoT solution needs. The IoT Hub Device Provisioning Service (DPS) is a helper service for IoT Hub that enables zero-touch, just-in-time provisioning to the right IoT hub without requiring human intervention. DPS enables the provisioning of millions of devices in a secure and scalable manner.
Many of the manual steps traditionally involved in provisioning are automated with DPS to reduce the time to deploy IoT devices and lower the risk of manual error. The following diagram describes what goes on behind the scenes to get a device provisioned. The first step is manual, all of the following steps are automated.
Before the device provisioning flow begins, there are two manual steps to prepare. On the device side, the device manufacturer prepares the device for provisioning by preconfiguring it with its authentication credentials and assigned Device Provisioning Service ID and endpoint. On the cloud side, you or the device manufacturer prepares the Device Provisioning Service instance with individual enrollments and enrollments groups that identify valid devices and define how they should be provisioned.
Once the device and cloud are set up for provisioning, the following steps kick off automatically as soon as the device powers on for the first time:
- When the device first powers on, it connects to the DPS endpoint and presents it authentication credentials.
- The DPS instance checks the identity of the device against its enrollment list. Once the device identity is verified, DPS assigns the device to an IoT hub and registers it in the hub.
- The DPS instance receives the device ID and registration information from the assigned hub and passes that information back to the device.
- The device uses its registration information to connect directly to its assigned IoT hub and authenticate.
- Once authenticated, the device and IoT hub begin communicating directly. The DPS instance has no further role as an intermediary unless the device needs to reprovision.
When to use Device Provisioning Service
There are many provisioning scenarios in which DPS is an excellent choice for getting devices connected and configured to IoT Hub, such as:
- Zero-touch provisioning to a single IoT solution without hardcoding IoT Hub connection information at the factory (initial setup)
- Load-balancing devices across multiple hubs
- Connecting devices to their owner's IoT solution based on sales transaction data (multitenancy)
- Connecting devices to a particular IoT solution depending on use-case (solution isolation)
- Connecting a device to the IoT hub with the lowest latency (geo-sharding)
- Reprovisioning based on a change in the device
- Rolling the keys used by the device to connect to IoT Hub (when not using X.509 certificates to connect)
Provisioning of nested IoT Edge devices (parent/child hierarchies) is not currently supported by DPS.
There are two distinct steps in the deployment process of a device in which DPS takes a part that can be done independently:
- The manufacturing step in which the device is created and prepared at the factory, and
- The cloud setup step in which the Device Provisioning Service is configured for automated provisioning.
Both these steps fit in seamlessly with existing manufacturing and deployment processes. DPS even simplifies some deployment processes that involve manual work to get connection information onto the device.
This step is all about what happens on the manufacturing line. The roles involved in this step include silicon designer, silicon manufacturer, integrator and/or the end manufacturer of the device. This step is concerned with creating the hardware itself.
DPS does not introduce a new step in the manufacturing process; rather, it ties into the existing step that installs the initial software and (ideally) the HSM on the device. Instead of creating a device ID in this step, the device is programmed with the provisioning service information, enabling it to call the provisioning service to get its connection info/IoT solution assignment when it is switched on.
Also in this step, the manufacturer supplies the device deployer/operator with identifying key information. Supplying that information could be as simple as confirming that all devices have an X.509 certificate generated from a signing certificate provided by the device deployer/operator, or as complicated as extracting the public portion of a TPM endorsement key from each TPM device. These services are offered by many silicon manufacturers today.
Cloud setup step
This step is about configuring the cloud for proper automatic provisioning. Generally there are two types of users involved in the cloud setup step: someone who knows how devices need to be initially set up (a device operator), and someone else who knows how devices are to be split among the IoT hubs (a solution operator).
There is a one-time initial setup of the provisioning that must occur, which is usually handled by the solution operator. Once the provisioning service is configured, it does not have to be modified unless the use case changes.
After the service has been configured for automatic provisioning, it must be prepared to enroll devices. This step is done by the device operator, who knows the desired configuration of the device(s) and is in charge of making sure the provisioning service can properly attest to the device's identity when it looks for its IoT hub. The device operator takes the identifying key information from the manufacturer and adds it to the enrollment list. There can be subsequent updates to the enrollment list as new entries are added or existing entries are updated with the latest information about the devices.
Registration and provisioning
Provisioning means various things depending on the industry in which the term is used. In the context of provisioning IoT devices to their cloud solution, provisioning is a two part process:
- The first part is establishing the initial connection between the device and the IoT solution by registering the device.
- The second part is applying the proper configuration to the device based on the specific requirements of the solution it was registered to.
Once both of those two steps have been completed, we can say that the device has been fully provisioned. Some cloud services only provide the first step of the provisioning process, registering devices to the IoT solution endpoint, but do not provide the initial configuration. DPS automates both steps to provide a seamless provisioning experience for the device.
Features of the Device Provisioning Service
DPS has many features, making it ideal for provisioning devices.
- Secure attestation support for both X.509 and TPM-based identities.
- Enrollment list containing the complete record of devices/groups of devices that may at some point register. The enrollment list contains information about the desired configuration of the device once it registers, and it can be updated at any time.
- Multiple allocation policies to control how DPS assigns devices to IoT hubs in support of your scenarios: Lowest latency, evenly weighted distribution (default), and static configuration. Latency is determined using the same method as Traffic Manager. Custom allocation, which lets you implement your own allocation policies via webhooks hosted in Azure Functions is also supported.
- Monitoring and diagnostics logging to make sure everything is working properly.
- Multi-hub support allows DPS to assign devices to more than one IoT hub. DPS can talk to hubs across multiple Azure subscriptions.
- Cross-region support allows DPS to assign devices to IoT hubs in other regions.
- Encryption for data at rest allows data in DPS to be encrypted and decrypted transparently using 256-bit AES encryption, one of the strongest block ciphers available, and is FIPS 140-2 compliant.
You can learn more about the concepts and features involved in device provisioning by reviewing the DPS terminology article along with the other conceptual articles in the same section.
Just like all Azure IoT services, DPS works cross-platform with various operating systems. Azure offers open-source SDKs in various languages to facilitate connecting devices and managing the service. DPS supports the following protocols for connecting devices:
- AMQP over web sockets
- MQTT over web sockets
DPS only supports HTTPS connections for service operations.
For resiliency and reliability, we recommend deploying to one of the regions that support Availability Zones.
Data residency consideration
Device Provisioning Service doesn't store or process customer data outside of the geography where you deploy the service instance. For more information, see Cross-region replication in Azure.
However, by default, DPS uses the same device provisioning endpoint for all provisioning service instances, and performs traffic load balancing to the nearest available service endpoint. As a result, authentication secrets may be temporarily transferred outside of the region where the DPS instance was initially created. However, once the device is connected, the device data will flow directly to the original region of the DPS instance.
To ensure that your data doesn't leave the region that your DPS instance was created in, use a private endpoint. To learn how to set up private endpoints, see Azure IoT Device Provisioning Service (DPS) support for virtual networks.
Quotas and Limits
Each Azure subscription has default quota limits in place that could impact the scope of your IoT solution. The current limit on a per-subscription basis is 10 Device Provisioning Services per subscription.
For more details on quota limits, see Azure Subscription Service Limits.
Some areas of this service have adjustable limits. This is represented in the tables below with the Adjustable? column. When the limit can be adjusted, the Adjustable? value is Yes.
The actual value to which a limit can be adjusted may vary based on each customer’s deployment. Multiple instances of DPS may be required for very large deployments.
If your business requires raising an adjustable limit or quota above the default limit, you can submit a request for additional resources by opening a support ticket. Requesting an increase does not guarantee that it will be granted, as it needs to be reviewed on a case-by-case basis. Please contact Microsoft support as early as possible during your implementation, to be able to determine if your request could be approved and plan accordingly.
The following table lists the limits that apply to Azure IoT Hub Device Provisioning Service resources.
|Maximum device provisioning services per Azure subscription||10||Yes|
|Maximum number of registrations||1,000,000||Yes|
|Maximum number of individual enrollments||1,000,000||Yes|
|Maximum number of enrollment groups (X.509 certificate)||100||Yes|
|Maximum number of enrollment groups (symmetric key)||100||No|
|Maximum number of CAs||25||No|
|Maximum number of linked IoT hubs||50||No|
|Maximum size of message||96 KB||No|
If the hard limit on symmetric key enrollment groups is a blocking issue, it is recommended to use individual enrollments as a workaround.
The Device Provisioning Service has the following rate limits.
|Device polling operation||5/10 sec/device||No|
Billable service operations and pricing
Each API call on DPS is billable as one operation. This includes all the service APIs and the device registration API.
The tables below show the current billable status for each DPS service API operation. To learn more about pricing for DPS, select Pricing table at the top of the Azure IoT Hub pricing page. Then select the IoT Hub Device Provisioning Service tab and the currency and region for your service.
|Device API||Device Registration Status Lookup||No|
|Device API||Operation Status Lookup||No|
|Device API||Register Device||Yes|
|DPS Service API (registration state)||Delete||Yes|
|DPS Service API (registration state)||Get||Yes|
|DPS Service API (registration state)||Query||Yes|
|DPS Service API (enrollment group)||Create or Update||Yes|
|DPS Service API (enrollment group)||Delete||Yes|
|DPS Service API (enrollment group)||Get||Yes|
|DPS Service API (enrollment group)||Get Attestation Mechanism||Yes|
|DPS Service API (enrollment group)||Query||Yes|
|DPS Service API (enrollment group)||Run Bulk Operation||Yes|
|DPS Service API (individual enrollment)||Create or Update||Yes|
|DPS Service API (individual enrollment)||Delete||Yes|
|DPS Service API (individual enrollment)||Get||Yes|
|DPS Service API (individual enrollment)||Get Attestation Mechanism||Yes|
|DPS Service API (individual enrollment)||Query||Yes|
|DPS Service API (individual enrollment)||Run Bulk Operation||Yes|
|DPS Certificate API||Create or Update||No|
|DPS Certificate API||Delete||No|
|DPS Certificate API||Generate Verification Code||No|
|DPS Certificate API||Get||No|
|DPS Certificate API||List||No|
|DPS Certificate API||Verify Certificate||No|
|IoT DPS Resource API||Check Provisioning Service Name Availability||No|
|IoT DPS Resource API||Create or Update||No|
|IoT DPS Resource API||Delete||No|
|IoT DPS Resource API||Get||No|
|IoT DPS Resource API||Get Operation Result||No|
|IoT DPS Resource API||List By Resource Group||No|
|IoT DPS Resource API||List By Subscription||No|
|IoT DPS Resource API||List By Keys||No|
|IoT DPS Resource API||List Keys for Key Name||No|
|IoT DPS Resource API||List Valid SKUs||No|
|IoT DPS Resource API||Update||No|
Related Azure components
DPS automates device provisioning with Azure IoT Hub. Learn more about IoT Hub.
Provisioning of nested edge devices (parent/child hierarchies) is not currently supported by DPS.
IoT Central applications use an internal DPS instance to manage device connections. To learn more, see:
- How devices connect to IoT Central
- Tutorial: Create and connect a client application to your Azure IoT Central application
You now have an overview of provisioning IoT devices in Azure. The next step is to try out an end-to-end IoT scenario.
Submit and view feedback for