Skip to content

Commit 9d618fd

Browse files
committed
Answer additional faqs about tls migration
1 parent d8a950d commit 9d618fd

File tree

1 file changed

+29
-2
lines changed

1 file changed

+29
-2
lines changed

articles/iot-hub/migrate-tls-certificate.md

Lines changed: 29 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,14 @@
11
---
2-
title: How to migrate hub root certificate - Azure IoT Hub
2+
title: How to migrate hub root certificate
3+
titleSuffix: Azure IoT Hub
34
description: Migrate all Azure IoT hub instances to use the new DigiCert Global G2 root certificate to maintain device connectivity.
45
author: kgremban
56
ms.author: kgremban
67
manager: lizross
78
ms.service: iot-hub
89
services: iot-hub
910
ms.topic: conceptual
10-
ms.date: 01/27/2023
11+
ms.date: 03/02/2023
1112
---
1213

1314
# Migrate IoT Hub resources to a new TLS certificate root
@@ -25,6 +26,8 @@ You should start planning now for the effects of migrating your IoT hubs to the
2526

2627
The IoT Hub team will begin migrating IoT hubs by region on **February 15, 2023** and completing by October 15, 2023. After all IoT hubs have migrated, then DPS will perform its migration between January 15 and February 15, 2024.
2728

29+
The subscription owners of each IoT hub will receive an email notification two weeks before their migration date.
30+
2831
### Request an extension
2932

3033
This TLS certificate migration is critical for the security of our customers and Microsoft's infrastructure, and is time-bound by the expiration of the Baltimore CyberTrust Root certificate. Therefore, there's little extra time that we can provide for customers that don't think their devices will be ready by February 15, 2023. If you absolutely can't meet the February 2023 target date, [fill out this form](https://aka.ms/BaltimoreAllow) with the details of your extension request, and then [email us](mailto:[email protected]?subject=Requesting%20extension%20for%20Baltimore%20migration) with a message that indicates you've completed the form, along with your company name. We can flag the specific hubs to be migrated later in the rollout window.
@@ -108,6 +111,30 @@ If you encounter any issues, you can undo the migration and revert to the Baltim
108111

109112
---
110113

114+
## Check the migration status of an IoT hub
115+
116+
To know whether an IoT hub has been migrated or not, check the active certificate root for the hub.
117+
118+
# [Azure portal](#tab/portal)
119+
120+
1. In the [Azure portal](https://portal.azure.com), navigate to your IoT hub.
121+
122+
1. Select **Certificates** in the **Security settings** section of the navigation menu.
123+
124+
1. If the **Certificate root** is listed as Baltimore CyberTrust, then the hub has not been migrated yet. If it is listed as DigiCert Global G2, then the migration is complete.
125+
126+
# [Azure CLI](#tab/cli)
127+
128+
Use the [az iot hub certificate root-authority show](/cli/azure/iot/hub/certificate/root-authority#az-iot-hub-certificate-root-authority-show) command to view the current certificate root-authority for your IoT hub.
129+
130+
```azurecli-interactive
131+
az iot hub certificate root-authority show --hub-name <iothub_name>
132+
```
133+
134+
In the Azure CLI, the existing Baltimore CyberTrust Root certificate is referred to as `v1`, and the new DigiCert Global Root G2 certificate is referred to as `v2`. If the certificate root is listed as **v2**, then the IoT hub has been successfully migrated.
135+
136+
---
137+
111138
## Frequently asked questions
112139

113140
### My devices uses SAS/X.509/TPM authentication. Will this migration affect my devices?

0 commit comments

Comments
 (0)