Skip to content

Commit 42b7275

Browse files
asergazdominicbetts
authored andcommitted
manage-secrets changes
1 parent 97e07ca commit 42b7275

File tree

2 files changed

+11
-9
lines changed

2 files changed

+11
-9
lines changed

articles/iot-operations/secure-iot-ops/howto-manage-secrets.md

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -35,27 +35,29 @@ Secrets are used in asset endpoints and data flow endpoints for authentication.
3535

3636
1. Go to the **Asset endpoints** page in the [operations experience](https://iotoperations.azure.com) web UI.
3737

38-
1. To view the secrets list, select **Manage certificates and secrets** and then **Secrets**.
39-
<!-- ****TODO: Confirm this Add new secret button****** -->
40-
1. To add a new secret, select **Add new secret**:
38+
1. To add a new secret reference, select **Add reference** when creating a new asset endpoint:
4139

4240
:::image type="content" source="media/howto-manage-secrets/use-secrets.png" alt-text="Screenshot that shows the Add from Azure Key Vault and Create new options when selecting a secret in operations experience.":::
4341

4442
- **Create a new secret**: creates a secret reference in the Azure Key Vault and also automatically synchronizes the secret down to the edge using Secret Store extension. Use this option if you didn't create the secret you require for this scenario in the key vault beforehand.
4543

4644
- **Add from Azure Key Vault**: synchronizes an existing secret in key vault down to the edge if it wasn't synchronized before. Selecting this option shows you the list of secret references in the selected key vault. Use this option if you created the secret in the key vault beforehand. *Only the latest version of the secret is synced to the edge*.
4745

48-
When you add the username and password references to the asset endpoints or data flow endpoints, you then need to give the synchronized secret a name. The secret references will be saved in the edge with this given name as one resource. In the example from the screenshot below, the username and password references are saved to the edge as *edp1secrets*.
49-
50-
:::image type="content" source="media/howto-manage-secrets/synced-secret-name.png" alt-text="Screenshot that shows the synced secret name field when username password is selected for authentication mode in operations experience.":::
46+
1. When you add the username and password references to the asset endpoints or data flow endpoints, you then need to give the synchronized secret a name. The secret references will be saved in the edge with this given name as one resource. In the example from the screenshot below, the username and password references are saved to the edge as *edp1secrets*.
5147

48+
:::image type="content" source="media/howto-manage-secrets/synced-secret-name.png" alt-text="Screenshot that shows the synced secret name field when username password is selected for authentication mode in operations experience.":::
49+
5250
## Manage synced secrets
5351

54-
In the [operations experience](https://iotoperations.azure.com) web UI, go to the **Asset endpoints** or **Data flows** page, select **Manage certificates and secrets**, and then **Secrets**.
52+
In this section, we use asset endpoints as an example, the same can be applied to data flow endpoints:
53+
54+
1. Go to the **Asset endpoints** page in the [operations experience](https://iotoperations.azure.com) web UI.
55+
56+
1. To view the secrets list, select **Manage certificates and secrets** and then **Secrets**.
5557

56-
*****TODO: Add screenshots for the secrets page.****
58+
:::image type="content" source="media/howto-manage-secrets/synced-secret-list.png" alt-text="Screenshot that shows the synced secrets list in the operations experience secrets page.":::
5759

58-
You can use the **Secrets** page to manage synchronized secrets in your asset endpoints and data flow endpoints. Secrets page shows the list of all current synchronized secrets at the edge for the resource you are viewing. A synced secret represents one or multiple secret references, depending on the resource using it. Any operation applied to a synced secret will be applied to all secret references contained within the synced secret.
60+
You can use the **Secrets** page to view synchronized secrets in your asset endpoints and data flow endpoints. Secrets page shows the list of all current synchronized secrets at the edge for the resource you are viewing. A synced secret represents one or multiple secret references, depending on the resource using it. Any operation applied to a synced secret will be applied to all secret references contained within the synced secret.
5961

6062
You can delete synced secrets as well in the **Secrets** page. When you delete a synced secret, it only deletes the synced secret from the edge, and doesn't delete the contained secret reference from Azure Key Vault. You must delete the certificate secret manually from the key vault.
6163

79.4 KB
Loading

0 commit comments

Comments
 (0)