|
1 | 1 | --- |
2 | | -title: Get Started with ADR and Certificate Management in IoT Hub (Preview) |
| 2 | +title: Deploy IoT Hub with ADR integration and certificate management (Preview) |
3 | 3 | titleSuffix: Azure IoT Hub |
4 | 4 | description: This article explains how to create an IoT Hub with ADR integration and Microsoft-backed X.509 certificate management. |
5 | 5 | author: cwatson-cat |
6 | 6 | ms.author: cwatson |
7 | 7 | ms.service: azure-iot-hub |
8 | 8 | services: iot-hub |
9 | 9 | ms.topic: how-to |
10 | | -ms.date: 11/07/2025 |
11 | | -zone_pivot_groups: service-azcli-script |
| 10 | +ms.date: 01/27/2026 |
| 11 | +zone_pivot_groups: iot-hub-deployment-methods |
12 | 12 | #Customer intent: As a developer new to IoT, I want to understand what Azure Device Registry is and how it can help me manage my IoT devices. |
13 | 13 | --- |
14 | 14 |
|
15 | | -# Get started with ADR integration and Microsoft-backed X.509 certificate management in IoT Hub (preview) |
| 15 | +# Deploy Azure IoT Hub with ADR integration and certificate management (preview) |
16 | 16 |
|
17 | | -This article explains how to create a new IoT Hub with [Azure Device Registry (ADR)](iot-hub-device-registry-overview.md) integration and [Microsoft-backed X.509 certificate management](iot-hub-certificate-management-overview.md). |
| 17 | +This article explains how to deploy IoT Hub with [Azure Device Registry (ADR)](iot-hub-device-registry-overview.md) integration and [Microsoft-backed X.509 certificate management](iot-hub-certificate-management-overview.md). |
18 | 18 |
|
19 | 19 | [!INCLUDE [iot-hub-public-preview-banner](includes/public-preview-banner.md)] |
20 | 20 |
|
21 | 21 | ## Prerequisites |
22 | 22 |
|
23 | | -- An active Azure subscription. If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn). |
24 | | -- Select a [supported region](iot-hub-what-is-new.md#supported-regions) to deploy instances of IoT Hub, Azure Device Registry, and Device Provisioning Service. |
25 | | -- If you don't have the Azure CLI installed, follow the steps to [install the Azure CLI](/cli/azure/install-azure-cli). |
26 | | -- Install the **Azure IoT CLI extension with previews enabled** to access the ADR integration and certificate management functionalities for IoT Hub: |
27 | | - |
28 | | - 1. Check for existing Azure CLI extension installations. |
29 | | - |
30 | | - ```azurecli-interactive |
31 | | - az extension list |
32 | | - ``` |
33 | | - |
34 | | - 1. Remove any existing azure-iot installations. |
35 | | - |
36 | | - ```azurecli-interactive |
37 | | - az extension remove --name azure-iot |
38 | | - ``` |
39 | | - |
40 | | - 1. Install the azure-iot extension from the index with previews enabled, |
41 | | - |
42 | | - ```azurecli-interactive |
43 | | - az extension add --name azure-iot --allow-preview |
44 | | - ``` |
45 | | -
|
46 | | - or download the .whl file from the GitHub releases page to install the extension manually. |
47 | | -
|
48 | | - ```azurecli-interactive |
49 | | - az extension add --upgrade --source https://github.com/Azure/azure-iot-cli-extension/releases/download/v0.30.0b1/azure_iot-0.30.0b1-py3-none-any.whl |
50 | | - ``` |
51 | | - |
52 | | - 1. After the install, validate your azure-iot extension version is at least **0.30.0b1**. |
53 | | - |
54 | | - ```azurecli-interactive |
55 | | - az extension list |
56 | | - ``` |
57 | | -
|
| 23 | +- An active Azure subscription. If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/). |
58 | 24 | - Ensure that you have the privilege to perform role assignments within your target scope. Performing role assignments in Azure requires a [privileged role](../role-based-access-control/built-in-roles.md#privileged), such as Owner or User Access Administrator at the appropriate scope. |
| 25 | +- Select a [supported region](iot-hub-what-is-new.md#supported-regions) to deploy instances of IoT Hub, Azure Device Registry, and Device Provisioning Service. |
59 | 26 |
|
60 | 27 | ## Choose a deployment method |
61 | 28 |
|
62 | 29 | To use certificate management, you must also set up IoT Hub, ADR, and the [Device Provisioning Service (DPS)](../iot-dps/index.yml). If you prefer, you can choose not to enable certificate management and configure only IoT Hub with ADR. |
63 | 30 |
|
64 | | -To set up your IoT Hub with ADR integration and certificate management, you can use Azure CLI or a script that automates the setup process. |
| 31 | +To set up your IoT Hub with ADR integration and certificate management, you can use the Azure portal, Azure CLI, or a script that automates the setup process. |
65 | 32 |
|
66 | 33 | | Deployment method | Description | |
67 | 34 | |-------------------|-------------| |
| 35 | +| Select **Azure portal** at the top of the page | Use the Azure portal to create a new IoT Hub, DPS instance, and ADR namespace and configure all necessary settings. | |
68 | 36 | | Select **Azure CLI** at the top of the page | Use the Azure CLI to create a new IoT Hub, DPS instance, and ADR namespace and configure all necessary settings. | |
69 | 37 | | Select **PowerShell script** at the top of the page | Use a PowerShell script (Windows only) to automate the creation of a new IoT Hub, DPS instance, and ADR namespace and configure all necessary settings. | |
70 | 38 |
|
| 39 | +:::zone pivot="portal" |
| 40 | + |
| 41 | +[!INCLUDE [iot-hub-device-registry-portal](../../includes/iot-hub-device-registry-portal.md)] |
| 42 | + |
| 43 | +:::zone-end |
71 | 44 |
|
72 | 45 | :::zone pivot="azure-cli" |
73 | 46 |
|
|
0 commit comments