You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/iot-edge/how-to-create-iot-edge-device.md
+31-31Lines changed: 31 additions & 31 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,8 +4,8 @@ description: Learn about the platform and provisioning options for creating an I
4
4
author: PatAltimore
5
5
ms.service: azure-iot-edge
6
6
services: iot-edge
7
-
ms.topic: conceptual
8
-
ms.date: 06/03/2024
7
+
ms.topic: concept-article
8
+
ms.date: 05/05/2025
9
9
ms.author: patricka
10
10
---
11
11
@@ -21,7 +21,7 @@ This article provides a look at all of the options for your IoT Edge solution an
21
21
*[Choose how to provision your devices](#choose-how-to-provision-your-devices)
22
22
*[Choose an authentication method](#choose-an-authentication-method)
23
23
24
-
By the end of this article, you'll have a clear picture of what platform, provisioning, and authentication options you want to use for your IoT Edge solution.
24
+
By the end of this article, you have a clear picture of what platform, provisioning, and authentication options you want to use for your IoT Edge solution.
25
25
26
26
## Get started
27
27
@@ -41,7 +41,7 @@ If you're not already familiar with IoT Edge terminology, review some key concep
41
41
42
42
**IoT Edge runtime**: The [IoT Edge runtime](iot-edge-runtime.md) is a collection of programs that turn a device into an IoT Edge device. Collectively, the IoT Edge runtime components enable IoT Edge devices to run your IoT Edge modules.
43
43
44
-
**Provisioning**: Each IoT Edge device must be provisioned. Provisioning is a two-step process. The first step is registering the device in an IoT hub, which creates a cloud identity that the device uses to establish the connection to its hub. The second step is configuring the device with its cloud identity. Provisioning can be done manually on a per-device basis, or it can be done at-scale using the [IoT Hub Device Provisioning Service](../iot-dps/about-iot-dps.md).
44
+
**Provisioning**: Each IoT Edge device must be provisioned. Provisioning is a two-step process. The first step is registering the device in an IoT hub, which creates a cloud identity that the device uses to establish the connection to its hub. The second step is configuring the device with its cloud identity. Provisioning can be done manually on a per-device basis, or it can be done atscale using the [IoT Hub Device Provisioning Service](../iot-dps/about-iot-dps.md).
45
45
46
46
**Authentication**: Your IoT Edge devices need to verify its identity when it connects to IoT Hub. You can choose which authentication method to use, like symmetric key passwords, certificate thumbprints, or trusted platform modules (TPMs).
47
47
@@ -51,19 +51,19 @@ Platform options are referred to by the container operating system and the host
51
51
52
52
There are three platform options for your IoT Edge devices.
53
53
54
-
***Linux containers on Linux hosts**: Run Linux-based IoT Edge containers directly on a Linux host. Throughout the IoT Edge docs, you'll also see this option referred to as **Linux** and **Linux containers** for simplicity.
54
+
***Linux containers on Linux hosts**: Run Linux-based IoT Edge containers directly on a Linux host. Throughout the IoT Edge docs, you also see this option referred to as **Linux** and **Linux containers** for simplicity.
55
55
56
-
***Linux containers on Windows hosts**: Run Linux-based IoT Edge containers in a Linux virtual machine on a Windows host. Throughout the IoT Edge docs, you'll also see this option referred to as **Linux on Windows**, **IoT Edge for Linux on Windows**, and **EFLOW**.
56
+
***Linux containers on Windows hosts**: Run Linux-based IoT Edge containers in a Linux virtual machine on a Windows host. Throughout the IoT Edge docs, you also see this option referred to as **Linux on Windows**, **IoT Edge for Linux on Windows**, and **EFLOW**.
57
57
58
-
***Windows containers on Windows hosts**: Run Windows-based IoT Edge containers directly on a Windows host. Throughout the IoT Edge docs, you'll also see this option referred to as **Windows** and **Windows containers** for simplicity.
58
+
***Windows containers on Windows hosts**: Run Windows-based IoT Edge containers directly on a Windows host. Throughout the IoT Edge docs, you also see this option referred to as **Windows** and **Windows containers** for simplicity.
59
59
60
-
For the latest information about which operating systems are currently supported for production scenarios, see [Azure IoT Edge supported systems](support.md#operating-systems).
60
+
For the latest information about which operating systems are currently supported for production scenarios, see the [Operating systems](support.md#operating-systems) section of [Azure IoT Edge supported platforms](support.md).
61
61
62
62
### Linux containers on Linux
63
63
64
64
For Linux devices, the IoT Edge runtime is installed directly on the host device.
65
65
66
-
IoT Edge supports X64, ARM32, and ARM64 Linux devices. Microsoft provides official installation packages for a variety of operating systems.
66
+
IoT Edge supports X64, ARM32, and ARM64 Linux devices. Microsoft provides official installation packages for various operating systems.
67
67
68
68
### Linux containers on Windows
69
69
@@ -73,31 +73,31 @@ IoT Edge for Linux on Windows is the recommended way to run IoT Edge on Windows
73
73
74
74
### Windows containers on Windows
75
75
76
-
IoT Edge version 1.2 or later doesn't support Windows containers. Windows containers are not supported beyond version 1.1.
76
+
IoT Edge version 1.2 or later doesn't support Windows containers. Windows containers aren't supported beyond version 1.1.
77
77
78
78
## Choose how to provision your devices
79
79
80
-
You can provision a single device or multiple devices at-scale, depending on the needs of your IoT Edge solution.
80
+
You can provision a single device or multiple devices atscale, depending on the needs of your IoT Edge solution.
81
81
82
-
The options available for authenticating communications between your IoT Edge devices and your IoT hubs depend on what provisioning method you choose. You can read more about those options in the [Choose an authentication method section](#choose-an-authentication-method).
82
+
The options available for authenticating communications between your IoT Edge devices and your IoT hubs depend on what provisioning method you choose. You can read more about those options in the [Choose an authentication method](#choose-an-authentication-method) section.
83
83
84
84
### Single device
85
85
86
-
Single device provisioning refers to provisioning an IoT Edge device without the assistance of the [IoT Hub Device Provisioning Service](../iot-dps/about-iot-dps.md) (DPS). You'll see single device provisioning also referred to as **manual provisioning**.
86
+
Single device provisioning refers to provisioning an IoT Edge device without the assistance of the [IoT Hub Device Provisioning Service](../iot-dps/about-iot-dps.md) (DPS). You see single device provisioning also referred to as **manual provisioning**.
87
87
88
-
Using single device provisioning, you'll need to manually enter provisioning information, like a connection string, on your devices. Manual provisioning is quick and easy to set up for only a few devices, but your workload will increase with the number of devices. Provisioning helps when you're considering the scalability of your solution.
88
+
Using single device provisioning, you need to manually enter provisioning information, like a connection string, on your devices. Manual provisioning is quick and easy to set up for only a few devices, but your workload increases with the number of devices. Provisioning helps when you're considering the scalability of your solution.
89
89
90
-
**Symmetric key** and **X.509 self-signed** authentication methods are available for manual provisioning. You can read more about those options in the [Choose an authentication method section](#choose-an-authentication-method).
90
+
**Symmetric key** and **X.509 self-signed** authentication methods are available for manual provisioning. You can read more about those options in the [Choose an authentication method](#choose-an-authentication-method) section.
91
91
92
92
### Devices at scale
93
93
94
-
Provisioning devices at-scale refers to provisioning one or more IoT Edge devices with the assistance of the [IoT Hub Device Provisioning Service](../iot-dps/about-iot-dps.md). You'll see provisioning at-scale also referred to as **autoprovisioning**.
94
+
Provisioning devices atscale refers to provisioning one or more IoT Edge devices with the assistance of the [IoT Hub Device Provisioning Service](../iot-dps/about-iot-dps.md). You see provisioning atscale also referred to as **autoprovisioning**.
95
95
96
96
If your IoT Edge solution requires more than one device, autoprovisioning using DPS saves you the effort of manually entering provisioning information into the configuration files of each device. This automated model can be scaled to millions of IoT Edge devices.
97
97
98
-
You can secure your IoT Edge solution with the authentication method of your choice. **Symmetric key**, **X.509 certificates**, and **trusted platform module (TPM) attestation** authentication methods are available for provisioning devices at-scale. You can read more about those options in the [Choose an authentication method section](#choose-an-authentication-method).
98
+
You can secure your IoT Edge solution with the authentication method of your choice. **Symmetric key**, **X.509 certificates**, and **trusted platform module (TPM) attestation** authentication methods are available for provisioning devices atscale. You can read more about those options in the [Choose an authentication method](#choose-an-authentication-method) section.
99
99
100
-
To see more of the features of DPS, see the [Features section of the overview page](../iot-dps/about-iot-dps.md#features-of-the-device-provisioning-service).
100
+
To learn more about the features of DPS, see the [Features of the Device Provisioning Service](../iot-dps/about-iot-dps.md#features-of-the-device-provisioning-service) section of [What is Azure IoT Hub Device Provisioning Service?](../iot-dps/about-iot-dps.md).
101
101
102
102
## Choose an authentication method
103
103
@@ -113,7 +113,7 @@ This authentication method is more secure than symmetric keys and supports group
113
113
114
114
Using TPM attestation is a method for device provisioning that uses authentication features in both software and hardware. Each TPM chip uses a unique endorsement key to verify its authenticity.
115
115
116
-
TPM attestation is only available for provisioning at-scale with DPS, and only supports individual enrollments not group enrollments. Group enrollments aren't available because of the device-specific nature of TPM.
116
+
TPM attestation is only available for provisioning atscale with DPS, and only supports individual enrollments not group enrollments. Group enrollments aren't available because of the device-specific nature of TPM.
117
117
118
118
TPM 2.0 is required when you use TPM attestation with the device provisioning service.
119
119
@@ -137,25 +137,25 @@ You can also use the following links to go to the relevant article.
137
137
138
138
**Manually provision a single device**:
139
139
140
-
*[Provision a single Linux device using X.509 certificates](how-to-provision-single-device-linux-x509.md)
141
-
*[Provision a single Linux device using symmetric keys](how-to-provision-single-device-linux-symmetric.md)
140
+
*[Create and provision an IoT Edge device on Linux using X.509 certificates](how-to-provision-single-device-linux-x509.md)
141
+
*[Create and provision an IoT Edge device on Linux using symmetric keys](how-to-provision-single-device-linux-symmetric.md)
142
142
143
-
**Provision multiple devices at-scale**:
143
+
**Provision multiple devices atscale**:
144
144
145
-
*[Provision Linux devices at-scale using X.509 certificates](how-to-provision-devices-at-scale-linux-x509.md)
146
-
*[Provision Linux devices at-scale using TPM attestation](how-to-provision-devices-at-scale-linux-tpm.md)
147
-
*[Provision Linux devices at-scale using symmetric keys](how-to-provision-devices-at-scale-linux-symmetric.md)
145
+
*[Create and provision IoT Edge devices atscale on Linux using X.509 certificates](how-to-provision-devices-at-scale-linux-x509.md)
146
+
*[Create and provision IoT Edge devices atscale with a TPM on Linux](how-to-provision-devices-at-scale-linux-tpm.md)
147
+
*[Create and provision IoT Edge devices atscale on Linux using symmetric key](how-to-provision-devices-at-scale-linux-symmetric.md)
148
148
149
149
### Linux containers on Windows hosts
150
150
151
151
**Manually provision a single device**:
152
152
153
-
*[Provision a single Linux on Windows device using X.509 certificates](how-to-provision-single-device-linux-on-windows-x509.md)
154
-
*[Provision a single Linux on Windows device using symmetric keys](how-to-provision-single-device-linux-on-windows-symmetric.md)
153
+
*[Create and provision an IoT Edge for Linux on Windows device using X.509 certificates](how-to-provision-single-device-linux-on-windows-x509.md)
154
+
*[Create and provision an IoT Edge for Linux on Windows device using symmetric keys](how-to-provision-single-device-linux-on-windows-symmetric.md)
155
155
156
-
**Provision multiple devices at-scale**:
156
+
**Provision multiple devices atscale**:
157
157
158
-
*[Provision Linux on Windows devices at-scale using X.509 certificates](how-to-provision-devices-at-scale-linux-on-windows-x509.md)
159
-
*[Provision Linux on Windows devices at-scale using TPM attestation](how-to-provision-devices-at-scale-linux-on-windows-tpm.md)
160
-
*[Provision Linux on Windows devices at-scale using symmetric keys](how-to-provision-devices-at-scale-linux-on-windows-symmetric.md)
158
+
*[Create and provision IoT Edge for Linux on Windows devices atscale using X.509 certificates](how-to-provision-devices-at-scale-linux-on-windows-x509.md)
159
+
*[Create and provision an IoT Edge for Linux on Windows device atscale by using a TPM](how-to-provision-devices-at-scale-linux-on-windows-tpm.md)
160
+
*[Create and provision IoT Edge for Linux on Windows devices atscale using symmetric keys](how-to-provision-devices-at-scale-linux-on-windows-symmetric.md)
0 commit comments