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-central/core/concepts-get-connected.md
+15-12Lines changed: 15 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -36,7 +36,7 @@ This article describes the following use cases:
36
36
-[Connect devices at scale using X.509 certificates](#connect-devices-using-x509-certificates) - the recommended approach for production environments.
37
37
-[Connect devices without first registering them](#connect-without-registering-devices)
38
38
-[Connect devices that use DPS individual enrollments](#individual-enrollment-based-device-connectivity)
39
-
-[Connect devices using IoT Plug and Play (preview) features](#connect-devices-with-iot-plug-and-play-preview)
39
+
-[Automatically associate a device with a device template](#automatically-associate-with-a-device-template)
40
40
41
41
## Connect a single device
42
42
@@ -133,7 +133,7 @@ The flow is slightly different depending on whether the devices use SAS tokens o
133
133
On the **Administration > Device connection** page, the **Auto approve** option controls whether you need to manually approve the device before it can start sending data.
134
134
135
135
> [!NOTE]
136
-
> To learn how automatically associate a device with a device template, see [Connect devices with IoT Plug and Play (preview)](#connect-devices-with-iot-plug-and-play-preview).
136
+
> To learn how automatically associate a device with a device template, see [Automatically associate a device with a device template](#automatically-associate-with-a-device-template).
137
137
138
138
### Connect devices that use X.509 certificates without registering
139
139
@@ -150,7 +150,7 @@ The flow is slightly different depending on whether the devices use SAS tokens o
150
150
On the **Administration > Device connection** page, the **Auto approve** option controls whether you need to manually approve the device before it can start sending data.
151
151
152
152
> [!NOTE]
153
-
> To learn how automatically associate a device with a device template, see [Connect devices with IoT Plug and Play (preview)](#connect-devices-with-iot-plug-and-play-preview).
153
+
> To learn how automatically associate a device with a device template, see [Automatically associate a device with a device template](#automatically-associate-with-a-device-template).
@@ -159,7 +159,7 @@ For customers connecting devices that each have their own authentication credent
159
159
> [!NOTE]
160
160
> When you create an individual enrollment for a device, it takes precedence over the default group enrollment options in your IoT Central application.
161
161
162
-
### Creating individual enrollments
162
+
### Create individual enrollments
163
163
164
164
IoT Central supports the following attestation mechanisms for individual enrollments:
165
165
@@ -175,28 +175,31 @@ IoT Central supports the following attestation mechanisms for individual enrollm
175
175
176
176
- **Trusted Platform Module (TPM) attestation:** A [TPM](https://docs.microsoft.com/azure/iot-dps/concepts-tpm-attestation) is a type of hardware security module. Using a TPM is one of the most secure ways to connect a device. This article assumes you're using a discrete, firmware, or integrated TPM. Software emulated TPMs are well suited for prototyping or testing, but they don't provide the same level of security as discrete, firmware, or integrated TPMs. Don't use software TPMs in production. To create an individual enrollment that uses a TPM, open the **Device Connection** page, select **Individual enrollment** as the connection method, and **TPM** as the mechanism. Enter the TPM endorsement key and save the device connection information.
177
177
178
-
## Automatically associate a device template
178
+
## Automatically associate with a device template
179
179
180
-
One of the key features of IoT Central is the ability to associate device templates automatically on device connection. Along with device credentials, devices can send the **CapabilityModelId**( URN for the capability model) as part of the device registration call. This capability enables IoT Central to discover and associate the device template with the device. The discovery process works as follows:
181
-
1. Associates with the device template if it's already published in the IoT Central application.
182
-
1. For Pre-Certified Plug and Play devices, if the device template is not already published in IoT Central the template is fetched from the public repository.
180
+
One of the key features of IoT Central is the ability to associate device templates automatically on device connection. Along with device credentials, devices can send a **CapabilityModelId** as part of the device registration call. The **CapabilityModelID** is a URN that identifies the capability model the device implements. The IoT Central application can use the **CapabilityModelID** to identify the device template to use and then automatically associate the device with the device template. The discovery process works as follows:
183
181
184
-
Below is the format of the additional payload the device would send during the DPS registration call.
182
+
1. If the device template is already published in the IoT Central application, the device is associated with the device template.
183
+
1. For pre-certified IoT Plug and Play devices, if the device template is not already published in the IoT Central application, the device template is fetched from the public repository.
184
+
185
+
The following snippets show the format of the additional payload the device must send during the DPS registration call for automatic association to work.
186
+
187
+
This is the format for devices that use the generally available device SDK that doesn't support IoT Plug and Play:
185
188
186
-
This is the format for devices using non PnP device SDK
187
189
```javascript
188
190
iotcModelId: '< this is the URN for the capability model>';
189
191
```
190
192
191
-
This is the format for devices using Public Preview PnP device SDK
193
+
This is the format for devices using public preview device SDK that does support IoT Plug and Play:
194
+
192
195
```javascript
193
196
'__iot:interfaces': {
194
197
CapabilityModelId:<this is the URNfor the capability model>
195
198
}
196
199
```
197
200
198
201
> [!NOTE]
199
-
> Note that the**Auto approve** option on **Administration > Device connection** must be enabled for devices to automatically connect, discover the device template, and start sending data.
202
+
> The**Auto approve** option on **Administration > Device connection** must be enabled for devices to automatically connect, discover the device template, and start sending data.
0 commit comments