Skip to content

Commit b034a28

Browse files
authored
Add how-to steps
1 parent 66ea616 commit b034a28

File tree

2 files changed

+34
-10
lines changed

2 files changed

+34
-10
lines changed
166 KB
Loading

articles/ai-services/openai/encrypt-data-at-rest.md

Lines changed: 34 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: mrbullwinkle
66
manager: nitinme
77
ms.service: azure-ai-openai
88
ms.topic: conceptual
9-
ms.date: 2/14/2024
9+
ms.date: 2/21/2024
1010
ms.author: mbullwin
1111
---
1212

@@ -33,31 +33,55 @@ To enable customer-managed keys, the key vault containing your keys must meet th
3333
- You must enable both the **Soft Delete** and **Do Not Purge** properties on the key vault.
3434
- If you use the [Key Vault firewall](/azure/key-vault/general/access-behind-firewall), you must allow trusted Microsoft services to access the key vault.
3535
- The key vault must use [legacy access policies](/azure/key-vault/general/assign-access-policy).
36-
- You must grant the Azure OpenAI resource's system-assigned managed identity the following permissions to keys: get key, wrap key, unwrap key.
36+
- You must grant the Azure OpenAI resource's system-assigned managed identity the following permissions on your key vault: *get key*, *wrap key*, *unwrap key*.
3737

3838
Only RSA and RSA-HSM keys of size 2048 are supported with Azure AI services encryption. For more information about keys, see **Key Vault keys** in [About Azure Key Vault keys, secrets and certificates](../../key-vault/general/about-keys-secrets-certificates.md).
3939

40-
## Enable customer-managed keys on your Azure OpenAI resource
40+
### Enable your Azure OpenAI resource's managed identity
41+
42+
1. Go to your Azure AI services resource.
43+
1. On the left, under **Resource Management**, select **Identity**.
44+
1. Switch the system-assigned managed identity status to **On**.
45+
1. Save your changes, and confirm that you want to enable the system-assigned managed identity.
46+
47+
### Configure your key vault's access permissions
48+
49+
1. In the Azure portal, go to your key vault.
50+
1. On the left, select **Access policies**.
51+
52+
If you see a message advising you that access policies aren't available, [reconfigure your key vault to use legacy access policies](/azure/key-vault/general/assign-access-policy) before continuing.
53+
1. Select **Create**.
54+
1. Under **Key permissions**, select **Get**, **Wrap Key**, and **Unwrap Key**. Leave the remaining checkboxes unselected.
55+
56+
:::image type="content" source="../media/cognitive-services-encryption/key-vault-access-policy.png" alt-text="Screenshot of the Azure portal page for a key vault access policy. The permissions selected are Get Key, Wrap Key, and Unwrap Key.":::
57+
58+
1. Select **Next**.
59+
1. Search for the name of your Azure OpenAI resource and select its managed identity.
60+
1. Select **Next**.
61+
1. Select **Next** to skip configuring any application settings.
62+
1. Select **Create**.
63+
64+
### Enable customer-managed keys on your Azure OpenAI resource
4165

4266
To enable customer-managed keys in the Azure portal, follow these steps:
4367

4468
1. Go to your Azure AI services resource.
45-
1. On the left, select **Encryption**.
69+
1. On the left, under **Resource Management**, select **Encryption**.
4670
1. Under **Encryption type**, select **Customer Managed Keys**, as shown in the following screenshot.
4771

48-
> [!div class="mx-imgBorder"]
49-
> ![Screenshot of create a resource user experience](./media/encryption/encryption.png)
72+
> [!div class="mx-imgBorder"]
73+
> ![Screenshot of create a resource user experience](./media/encryption/encryption.png)
5074
51-
## Specify a key
75+
### Specify a key
5276

5377
After you enable customer-managed keys, you can specify a key to associate with the Azure AI services resource.
5478

55-
### Specify a key as a URI
79+
#### Specify a key as a URI
5680

5781
To specify a key as a URI, follow these steps:
5882

5983
1. In the Azure portal, go to your key vault.
60-
1. Under **Settings**, select **Keys**.
84+
1. Under **Objects**, select **Keys**.
6185
1. Select the desired key, and then select the key to view its versions. Select a key version to view the settings for that version.
6286
1. Copy the **Key Identifier** value, which provides the URI.
6387

@@ -72,7 +96,7 @@ To specify a key as a URI, follow these steps:
7296
1. Under **Subscription**, select the subscription that contains the key vault.
7397
1. Save your changes.
7498

75-
### Select a key from a key vault
99+
#### Select a key from a key vault
76100

77101
To select a key from a key vault, first make sure that you have a key vault that contains a key. Then follow these steps:
78102

0 commit comments

Comments
 (0)