Azure IoT Documentation

Quickstart: Register a Device

Follow these steps to provision a device using the Azure portal.

1. Navigate to Device Provisioning Services in the Azure portal.
2. Create a new DPS instance or select an existing one.
3. Under Enrollments, click Add enrollment group.
4. Upload a root certificate (or use a symmetric key) and provide a group name.
5. Configure the IoT hub that devices in this group should be assigned to.
6. Save the enrollment and note the registration ID for your device.

Device Provisioning Sample (C#)

using Microsoft.Azure.Devices.Provisioning.Client;
using Microsoft.Azure.Devices.Provisioning.Client.Transport;
using Microsoft.Azure.Devices.Shared;

var provisioningHost = "global.azure-devices-provisioning.net";
var idScope = "<Your ID Scope>";
var registrationId = "<Device Registration Id>";
var symmetricKey = Convert.FromBase64String("<Device Symmetric Key>");

using var security = new SecurityProviderSymmetricKey(registrationId, symmetricKey, null);
using var transport = new ProvisioningTransportHandlerMqtt(TransportFallbackType.TcpOnly);
var provClient = ProvisioningDeviceClient.Create(provisioningHost, idScope, security, transport);

Console.WriteLine("Attempting registration...");
DeviceRegistrationResult result = await provClient.RegisterAsync();
Console.WriteLine($"Status: {result.Status}");

if (result.Status == ProvisioningRegistrationStatusType.Assigned)
{
    var iotHub = result.AssignedHub;
    var deviceId = result.DeviceId;
    Console.WriteLine($"Device assigned to {iotHub} with DeviceId {deviceId}");
}

REST API Reference

Base URL: https://global.azure-devices-provisioning.net

All requests must include the Authorization header with a valid SAS token.