Skip to content

Commit 47393a6

Browse files
Merge pull request #271656 from PatAltimore/patricka-est-icm
Clarify EST auto-renew settings
2 parents d503a7c + df8f699 commit 47393a6

File tree

1 file changed

+3
-7
lines changed

1 file changed

+3
-7
lines changed

articles/iot-edge/how-to-manage-device-certificates.md

Lines changed: 3 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: How to install and manage certificates on an Azure IoT Edge device
55
author: PatAltimore
66

77
ms.author: patricka
8-
ms.date: 03/19/2024
8+
ms.date: 04/09/2024
99
ms.topic: conceptual
1010
ms.service: iot-edge
1111
services: iot-edge
@@ -597,6 +597,8 @@ threshold = "80%"
597597
retry = "4%"
598598
```
599599

600+
Automatic renewal for Edge CA must be enabled when issuance method is set to EST. Edge CA expiration must be avoided as it breaks many IoT Edge functionalities. If a situation requires total control over Edge CA certificate lifecycle, use the [manual Edge CA management method](#example-use-edge-ca-certificate-files-from-pki-provider) instead.
601+
600602
Don't use EST or `auto_renew` with other methods of provisioning, including manual X.509 provisioning with IoT Hub and DPS with individual enrollment. IoT Edge can't update certificate thumbprints in Azure when a certificate is renewed, which prevents IoT Edge from reconnecting.
601603

602604
### Example: automatic Edge CA management with EST
@@ -612,19 +614,13 @@ url = "https://ca.example.org/.well-known/est"
612614

613615
bootstrap_identity_cert = "file:///var/aziot/my-est-id-bootstrap-cert.pem"
614616
bootstrap_identity_pk = "file:///var/aziot/my-est-id-bootstrap-pk.key.pem"
615-
```
616-
617-
By default, and when there's no specific `auto_renew` configuration, Edge CA automatically renews at 80% certificate lifetime if EST is set as the method. You can update the auto renewal values to other values. For example:
618617

619-
```toml
620618
[edge_ca.auto_renew]
621619
rotate_key = true
622620
threshold = "90%"
623621
retry = "2%"
624622
```
625623

626-
Automatic renewal for Edge CA can't be disabled when issuance method is set to EST, since Edge CA expiration must be avoided as it breaks many IoT Edge functionalities. If a situation requires total control over Edge CA certificate lifecycle, use the [manual Edge CA management method](#example-use-edge-ca-certificate-files-from-pki-provider) instead.
627-
628624
## Module server certificates
629625

630626
Edge Daemon issues module server and identity certificates for use by Edge modules. It remains the responsibility of Edge modules to renew their identity and server certificates as needed.

0 commit comments

Comments
 (0)