Skip to content

Commit 3c0ab7f

Browse files
Adding root key update information.
1 parent 718a7c8 commit 3c0ab7f

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

articles/iot-hub-device-update/device-update-security.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,13 @@ Every Device Update device must contain a set of root keys. These keys are the r
6565

6666
The set of root keys will change over time as it is proper to periodically rotate signing keys for security purposes. As a result, the Device Update agent software will need to be updated with the latest set of root keys at intervals specified by the Device Update team.
6767

68+
Starting with version 1.1.0 of the Device Update agent, the agent will automatically check for any changes to root keys each time a deployment of an update to that device occurs. Possible changes:
69+
70+
* A new root key is available.
71+
* An existing root key is disabled (effectively "revoked"), meaning it is no longer valid for establishing trust.
72+
73+
If either or both of the above are true, the Device Update agent will automatically download from the DU service a new _root key package_. This package contains the complete set of all root keys, as well as a _disabled list_ containing information about which root keys and/or signing keys are no longer valid. The root key package is itself signed with each root key, so that trust for the package can be established both from the original root keys that are part of the DU agent itself, as well as any subsequently-downloaded root keys. Once the validation process is complete, any new root keys are considered to be trusted for the purpose of validating trust with the signing key for a given update manifest, while any root keys or signing keys listed in the disabled list are no longer trusted for that purpose.
74+
6875
### Signatures
6976

7077
All signatures are accompanied by a signing (public) key signed by one of the root keys. The signature identifies which root key was used to sign the signing key.

0 commit comments

Comments
 (0)