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-manage-device-certificates.md
+11-7Lines changed: 11 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,8 +17,8 @@ All IoT Edge devices use certificates to create secure connections between the r
17
17
18
18
## Install production certificates
19
19
20
-
When you first install IoT Edge and provision your device, the device is set up with temporary certificates so that you can test the service.
21
-
These temporary certificates expire in 90 days, or can be reset by restarting your machine.
20
+
When you first install IoT Edge and provision your device, the device is set up with temporary certificates (known as quickstart CA) so that you can test the service.
21
+
These temporary certificates expire in 90 days.
22
22
Once you move into a production scenario, or you want to create a gateway device, you need to provide your own certificates.
23
23
This article demonstrates the steps to install certificates on your IoT Edge devices.
24
24
@@ -213,11 +213,14 @@ If you are using IoT Edge for Linux on Windows, you need to use the SSH key loca
213
213
214
214
IoT Edge has built-in ability to renew certificates before expiry.
215
215
216
-
Certificates can only auto-renew if you have a certificate issuance method set, like EST. It must be configured per type of certificate. To configure, go to the relevant certificate configuration section in `config.toml` and add:
216
+
Certificates renewal requires an issuance method that IoT Edge can manage. Generally, this means an EST server is required, but IoT Edge can also automatically renew the quickstart CA without configuration. Certificate renewal is configured per type of certificate. To configure, go to the relevant certificate configuration section in `config.toml` and add:
217
217
218
218
```toml
219
219
# To use auto renew with other types of certs, swap `edge_ca` with other certificate types
220
220
# And put into the relevant section
221
+
[edge_ca]
222
+
method = "est"
223
+
#...
221
224
[edge_ca.auto_renew]
222
225
rotate_key = true
223
226
threshold = "80%"
@@ -234,20 +237,20 @@ Here:
234
237
:::moniker-end
235
238
<!-- end iotedge-2020-11 -->
236
239
237
-
## Customize certificate lifetime
240
+
## Customize quickstart CA lifetime
238
241
239
242
IoT Edge automatically generates certificates on the device in several cases, including:
240
243
241
244
<!-- 1.1. -->
242
245
:::moniker range="iotedge-2018-06"
243
-
* If you don't provide your own production certificates when you install and provision IoT Edge, the IoT Edge security manager automatically generates a **device CA certificate**. This self-signed certificate is only meant for development and testing scenarios, not production. This certificate expires after 90 days.
246
+
* If you don't provide your own production certificates when you install and provision IoT Edge, the IoT Edge security manager automatically generates a **device CA certificate**. This self-signed certificate is known as the quickstart CA and only meant for development and testing scenarios, not production. This certificate expires after 90 days.
244
247
* The IoT Edge security manager also generates a **workload CA certificate** signed by the device CA certificate
245
248
:::moniker-end
246
249
<!-- end 1.1 -->
247
250
248
251
<!-- 1.2 -->
249
252
:::moniker range=">=iotedge-2020-11"
250
-
If you don't provide your own production certificates when you install and provision IoT Edge, the IoT Edge security manager automatically generates an **edge CA certificate**. This self-signed certificate is only meant for development and testing scenarios, not production. This certificate expires after 90 days.
253
+
If you don't provide your own production certificates when you install and provision IoT Edge, the IoT Edge security manager automatically generates an **edge CA certificate**. This self-signed certificate is known as the quickstart CA and only meant for development and testing scenarios, not production. This certificate expires after 90 days.
251
254
:::moniker-end
252
255
<!-- end 1.2 -->
253
256
@@ -365,7 +368,8 @@ Upon expiry after the specified number of days, IoT Edge has to be restarted to
365
368
366
369
<!-- 1.2 -->
367
370
:::moniker range=">=iotedge-2020-11"
368
-
### Renew Edge CA
371
+
372
+
### Renew quickstart Edge CA
369
373
370
374
By default, IoT Edge automatically regenerates the Edge CA certificate when at 80% of the certificate lifetime. So for certificate with 90 day lifetime, IoT Edge automatically regenerates the Edge CA certificate at 72 days from issuance.
0 commit comments