Skip to content

Commit 6ea8a03

Browse files
authored
Merge pull request #89740 from v-stadam/symmetric_key_derived_0923
Symmetric key derived 0923
2 parents 10bab18 + 1ffa054 commit 6ea8a03

File tree

1 file changed

+9
-3
lines changed

1 file changed

+9
-3
lines changed

articles/iot-edge/how-to-auto-provision-symmetric-keys.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -96,11 +96,14 @@ When you create an enrollment in DPS, you have the opportunity to declare an **I
9696

9797
1. Select **Save**.
9898

99-
Now that an enrollment exists for this device, the IoT Edge runtime can automatically provision the device during installation. Be sure to copy your enrollment's **Primary Key** value to use when creating your device key.
99+
Now that an enrollment exists for this device, the IoT Edge runtime can automatically provision the device during installation. Be sure to copy your enrollment's **Primary Key** value to use when installing the IoT Edge runtime, or if you're going to be creating device keys for use with a group enrollment.
100100

101101
## Derive a device key
102102

103-
Your device uses the derived device key with your unique registration ID to perform symmetric key attestation with the enrollment during provisioning. To generate the device key, use the key you copied from your DPS enrollment to compute an [HMAC-SHA256](https://wikipedia.org/wiki/HMAC) of the unique registration ID for the device and convert the result into Base64 format.
103+
> [!NOTE]
104+
> This section is required only if using a group enrollment.
105+
106+
Each device uses its derived device key with your unique registration ID to perform symmetric key attestation with the enrollment during provisioning. To generate the device key, use the key you copied from your DPS enrollment to compute an [HMAC-SHA256](https://wikipedia.org/wiki/HMAC) of the unique registration ID for the device and convert the result into Base64 format.
104107

105108
Do not include your enrollment's primary or secondary key in your device code.
106109

@@ -155,7 +158,10 @@ You'll need the following information when provisioning your device:
155158

156159
* The DPS **ID Scope** value
157160
* The device **Registration ID** you created
158-
* The device's derived device key for symmetric key attestation
161+
* The **Primary Key** you copied from the DPS enrollment
162+
163+
> [!TIP]
164+
> For group enrollments, you need each device's [derived key](#derive-a-device-key) rather than the DPS enrollment key.
159165
160166
### Linux device
161167

0 commit comments

Comments
 (0)