Skip to content

Commit 9c74410

Browse files
Merge pull request #209730 from flang-msft/'fxl---Managed-Identity-for-Storage-page-ready-for-GA'
fxl---managed identity for storage page ready for ga
2 parents 74e0124 + 7835b4b commit 9c74410

22 files changed

+49
-51
lines changed

articles/azure-cache-for-redis/cache-configure.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: flang-msft
55

66
ms.service: cache
77
ms.topic: conceptual
8-
ms.date: 07/12/2022
8+
ms.date: 09/01/2022
99
ms.author: franlanglois
1010

1111
---
@@ -36,7 +36,7 @@ You can view and configure the following settings using the **Resource Menu**. T
3636
- [Scale](#scale)
3737
- [Cluster size](#cluster-size)
3838
- [Data persistence](#data-persistence)
39-
- [(Preview) Identity](#preview-identity)
39+
- [Identity](#identity)
4040
- [Alerts](#alerts)
4141
- [Schedule updates](#schedule-updates)
4242
- [Geo-replication](#geo-replication)
@@ -242,11 +242,11 @@ For more information, see [How to configure persistence for a Premium Azure Cach
242242
> [!IMPORTANT]
243243
> Redis data persistence is only available for Premium caches.
244244
245-
### (preview) Identity
245+
### Identity
246246

247-
Use **(preview) Identity** to configure managed identities. Managed identities are a common tool used in Azure to help developers minimize the burden of managing secrets and sign-in information.
247+
Use **Identity** to configure managed identities. Managed identities are a common tool used in Azure to help developers minimize the burden of managing secrets and sign-in information.
248248

249-
Presently, you can only use managed identities for storage. For more information, see [Managed identity for storage (Preview)](cache-managed-identity.md).
249+
Presently, you can only use managed identities for storage. For more information, see [Managed identity for storage](cache-managed-identity.md).
250250

251251
> [!NOTE]
252252
> Managed identity functionality is only available in the Premium tier for use with storage.

articles/azure-cache-for-redis/cache-how-to-import-export-data.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to import and export data to and from blob storage with y
44
author: flang-msft
55
ms.service: cache
66
ms.topic: conceptual
7-
ms.date: 06/07/2022
7+
ms.date: 09/01/2022
88
ms.author: franlanglois
99

1010
---

articles/azure-cache-for-redis/cache-managed-identity.md

Lines changed: 32 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -3,14 +3,14 @@ title: Managed identity for storage accounts
33
titleSuffix: Azure Cache for Redis
44
description: Learn to Azure Cache for Redis
55
author: flang-msft
6+
67
ms.service: cache
78
ms.topic: conceptual
8-
ms.date: 03/10/2022
9+
ms.date: 08/29/2022
910
ms.author: franlanglois
10-
1111
---
1212

13-
# Managed identity for storage (Preview)
13+
# Managed identity for storage
1414

1515
[Managed identities](../active-directory/managed-identities-azure-resources/overview.md) are a common tool used in Azure to help developers minimize the burden of managing secrets and sign-in information. Managed identities are useful when Azure services connect to each other. Instead of managing authorization between each service, [Azure Active Directory](../active-directory/fundamentals/active-directory-whatis.md) (Azure AD) can be used to provide a managed identity that makes the authentication process more streamlined and secure.
1616

@@ -42,67 +42,56 @@ Managed identity can be enabled either when you create a cache instance or after
4242

4343
### Prerequisites and limitations
4444

45-
To use managed identity, you must have a premium-tier cache.
45+
Because managed identity for storage is only used with the import/export feature and persistence feature, it's currently only useful when used with the Premium tier of Azure Cache for Redis.
4646

4747
## Create a new cache with managed identity using the portal
4848

4949
1. Sign into the [Azure portal](https://portal.azure.com/)
5050

5151
1. Create a new Azure Cache for Redis resource with a **Cache type** of any of the premium tiers. Complete **Basics** tab with all the required information.
52-
> [!NOTE]
53-
> Managed identity functionality is only available in the Premium tier.
54-
>
55-
:::image type="content" source="media/cache-managed-identity/basics.png" alt-text="create a premium azure cache":::
5652

57-
1. Select the **Advanced** tab. Then, scroll down to **(PREVIEW) System assigned managed identity** and select **On**.
53+
:::image type="content" source="media/cache-managed-identity/basics.png" alt-text="Screenshot of showing how to create a premium cache.":::
5854

59-
:::image type="content" source="media/cache-managed-identity/system-assigned.png" alt-text="Advanced page of the form":::
55+
1. Select the **Advanced** tab. Then, scroll down to **System assigned managed identity** and select **On**.
6056

61-
1. Complete the creation process. Once the cache has been created and deployed, open it, and select the **(PREVIEW) Identity** tab under the **Settings** section on the left.
57+
:::image type="content" source="media/cache-managed-identity/system-assigned.png" alt-text="Screenshot sowing Advanced page of the form.":::
6258

63-
:::image type="content" source="media/cache-managed-identity/identity-resource.png" alt-text="(Preview) Identity in the Resource menu":::
64-
65-
1. You see that a system-assigned **object ID** has been assigned to the cache **Identity**.
66-
67-
:::image type="content" source="media/cache-managed-identity/user-assigned.png" alt-text="System assigned resource settings for identity":::
59+
1. Complete the creation process. Once the cache has been created and deployed, open it, and select the **Identity** tab under the **Settings** section on the left. You see that a system-assigned **object ID** has been assigned to the cache **Identity**.
6860

61+
:::image type="content" source="media/cache-managed-identity/identity-resource.png" alt-text="Screenshot showing Identity in the Resource menu.":::
62+
6963
## Add system assigned identity to an existing cache
7064

71-
1. Navigate to your Azure Cache for Redis resource from the Azure portal. Select **(PREVIEW) Identity** from the Resource menu on the left.
72-
> [!NOTE]
73-
> Managed identity functionality is only available in the Premium tier.
74-
>
65+
1. Navigate to your Azure Cache for Redis resource from the Azure portal. Select **Identity** from the Resource menu on the left.
7566

76-
1. To enable a system-assigned identity, select the **System assigned (preview)** tab, and select **On** under **Status**. Select **Save** to confirm.
67+
1. To enable a system-assigned identity, select the **System assigned** tab, and select **On** under **Status**. Select **Save** to confirm.
7768

78-
:::image type="content" source="media/cache-managed-identity/identity-save.png" alt-text="System assigned identity status is on":::
69+
:::image type="content" source="media/cache-managed-identity/identity-save.png" alt-text="Screenshot showing System Assigned selected and Status is on.":::
7970

8071
1. A dialog pops up saying that your cache will be registered with Azure Active Directory and that it can be granted permissions to access resources protected by Azure AD. Select **Yes**.
72+
:::image type="content" source="media/cache-managed-identity/identity-dialog.png" alt-text="Screenshot asking if you want to enable managed identity.":::
8173

8274
1. You see an **Object (principal) ID**, indicating that the identity has been assigned.
8375

84-
:::image type="content" source="media/cache-managed-identity/user-assigned.png" alt-text="new Object principal ID shown for system assigned identity":::
76+
:::image type="content" source="media/cache-managed-identity/user-assigned.png" alt-text="Screenshot showing the Object (principal) ID.":::
8577

8678
## Add a user assigned identity to an existing cache
8779

88-
1. Navigate to your Azure Cache for Redis resource from the Azure portal. Select **(PREVIEW) Identity** from the Resource menu on the left.
89-
> [!NOTE]
90-
> Managed identity functionality is only available in the Premium tier.
91-
>
80+
1. Navigate to your Azure Cache for Redis resource from the Azure portal. Select **Identity** from the Resource menu on the left.
9281

93-
1. To enable user assigned identity, select the **User assigned (preview)** tab and select **Add**.
82+
1. To enable user assigned identity, select the **User assigned** tab and select **Add**.
9483

95-
:::image type="content" source="media/cache-managed-identity/identity-add.png" alt-text="User assigned identity status is on":::
84+
:::image type="content" source="media/cache-managed-identity/identity-add.png" alt-text="User assigned identity status is on.":::
9685

9786
1. A sidebar pops up to allow you to select any available user-assigned identity to your subscription. Choose an identity and select **Add**. For more information on user assigned managed identities, see [manage user-assigned identity](../active-directory/managed-identities-azure-resources/how-manage-user-assigned-managed-identities.md).
9887
>[!Note]
9988
>You need to [create a user assigned identity](../active-directory/managed-identities-azure-resources/how-manage-user-assigned-managed-identities.md?pivots=identity-mi-methods-azp) in advance of this step.
10089
>
101-
:::image type="content" source="media/cache-managed-identity/choose-identity.png" alt-text="new Object principal ID shown for user assigned identity":::
90+
:::image type="content" source="media/cache-managed-identity/choose-identity.png" alt-text="Screenshot showing a User assigned managed identity.":::
10291

103-
1. You see the user-assigned identity listed in the **User assigned (preview)** pane.
92+
1. You see the user-assigned identity listed in the **User assigned** pane.
10493

105-
:::image type="content" source="media/cache-managed-identity/identity-list.png" alt-text="list of identity names":::
94+
:::image type="content" source="media/cache-managed-identity/identity-list.png" alt-text="Screenshot showing a list of names, resource groups and subscriptions.":::
10695

10796
## Enable managed identity using the Azure CLI
10897

@@ -134,23 +123,23 @@ Set-AzRedisCache -ResourceGroupName \"MyGroup\" -Name \"MyCache\" -IdentityType
134123

135124
2. Open the **Access control (IAM)** from the Resource menu. Then, select **Add**, and **Add role assignment**.
136125

137-
:::image type="content" source="media/cache-managed-identity/demo-storage.png" alt-text="access control (iam) settings":::
126+
:::image type="content" source="media/cache-managed-identity/demo-storage.png" alt-text="Screenshot showing the Access Control (IAM) settings.":::
138127

139128
3. Search for the **Storage Blob Data Contributor** on the Role pane. Select it and **Next**.
140129

141-
:::image type="content" source="media/cache-managed-identity/role-assignment.png" alt-text="add role assignment form with list of roles":::
130+
:::image type="content" source="media/cache-managed-identity/role-assignment.png" alt-text="Screenshot showing Add role assignment form with list of roles.":::
142131

143132
4. Select the **Members** tab. Under **Assign access to** select **Managed Identity**, and select on **Select members**. A sidebar pops up on the right.
144133

145-
:::image type="content" source="media/cache-managed-identity/select-members.png" alt-text="add role assignment form with members pane":::
134+
:::image type="content" source="media/cache-managed-identity/select-members.png" alt-text="Screenshot showing add role assignment form with members pane.":::
146135

147136
5. Use the drop-down under **Managed Identity** to choose either a **User-assigned managed identity** or a **System-assigned managed identity**. If you have many managed identities, you can search by name. Choose the managed identities you want and then **Select**. Then, **Review + assign** to confirm.
148137

149-
:::image type="content" source="media/cache-managed-identity/review-assign.png" alt-text="select managed identities form pop up":::
138+
:::image type="content" source="media/cache-managed-identity/review-assign.png" alt-text="Screenshot showing Managed Identity form with User-assigned managed identity indicated.":::
150139

151140
6. You can confirm if the identity has been assigned successfully by checking your storage account's role assignments under **Storage Blob Data Contributor**.
152141

153-
:::image type="content" source="media/cache-managed-identity/blob-data.png" alt-text="storag blob data contributor list":::
142+
:::image type="content" source="media/cache-managed-identity/blob-data.png" alt-text="Screenshot of Storage Blob Data Contributor list.":::
154143

155144
> [!NOTE]
156145
> Adding an Azure Cache for Redis instance as a storage blob data contributor through system-assigned identity conveniently adds the cache instance to the [trusted services list](../storage/common/storage-network-security.md?tabs=azure-portal), making firewall exceptions easier to implement. If you're not using managed identity and instead authorizing a storage account with a key, then having firewall exceptions on the storage account tends to break the persistence process and the import-export processes.
@@ -161,33 +150,33 @@ Set-AzRedisCache -ResourceGroupName \"MyGroup\" -Name \"MyCache\" -IdentityType
161150

162151
1. Open the Azure Cache for Redis instance that has been assigned the Storage Blob Data Contributor role and go to the **Data persistence** on the Resource menu.
163152

164-
2. Change the **Authentication Method** to **(PREVIEW) Managed Identity** and select the storage account you configured above. select **Save**.
153+
2. Change the **Authentication Method** to **Managed Identity** and select the storage account you configured above. select **Save**.
165154

166-
:::image type="content" source="media/cache-managed-identity/data-persistence.png" alt-text="data persistence pane with authentication method selected":::
155+
:::image type="content" source="media/cache-managed-identity/data-persistence.png" alt-text="Screenshot showing data persistence pane with authentication method selected.":::
167156

168157
> [!IMPORTANT]
169158
> The identity defaults to the system-assigned identity if it is enabled. Otherwise, the first listed user-assigned identity is used.
170159
>
171160
172161
3. Data persistence backups can now be saved to the storage account using managed identity authentication.
173162

174-
:::image type="content" source="media/cache-managed-identity/redis-persistence.png" alt-text="export data in resource menu":::
163+
:::image type="content" source="media/cache-managed-identity/redis-persistence.png" alt-text="Screenshot showing export data in Resource menu.":::
175164

176165
### Use managed identity to import and export cache data
177166

178167
1. Open your Azure Cache for Redis instance that has been assigned the Storage Blob Data Contributor role and go to the **Import** or **Export** tab under **Administration**.
179168

180169
2. If importing data, choose the blob storage location that holds your chosen RDB file. If exporting data, type your desired blob name prefix and storage container. In both situations, you must use the storage account you've configured for managed identity access.
181170

182-
:::image type="content" source="media/cache-managed-identity/export-data.png" alt-text="export data from the resource menu":::
171+
:::image type="content" source="media/cache-managed-identity/export-data.png" alt-text="Screenshot showing Managed Identity selected.":::
183172

184-
3. Under **Authentication Method**, choose **(PREVIEW) Managed Identity** and select **Import** or **Export**, respectively.
173+
3. Under **Authentication Method**, choose **Managed Identity** and select **Import** or **Export**, respectively.
185174

186175
> [!NOTE]
187176
> It will take a few minutes to import or export the data.
188177
>
189178
190-
> [!IMPORTANt]
179+
> [!IMPORTANT]
191180
>If you see an export or import failure, double check that your storage account has been configured with your cache's system-assigned or user-assigned identity. The identity used will default to system-assigned identity if it is enabled. Otherwise, the first listed user-assigned identity is used.
192181
193182
## Next steps

articles/azure-cache-for-redis/cache-whats-new.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,24 @@
22
title: What's New in Azure Cache for Redis
33
description: Recent updates for Azure Cache for Redis
44
author: flang-msft
5+
56
ms.author: franlanglois
67
ms.service: cache
78
ms.topic: reference
8-
ms.date: 08/01/2022
9+
ms.date: 09/01/2022
910

1011
---
1112

1213
# What's New in Azure Cache for Redis
1314

15+
## September 2022
16+
17+
### Support for managed identity in Azure Cache for Redis
18+
19+
Authenticating storage account connections using managed identity has now reached General Availability (GA).
20+
21+
For more information, see [Managed identity for storage](cache-managed-identity.md).
22+
1423
## August 2022
1524

1625
### RedisJSON module available in Azure Cache for Redis Enterprise
@@ -86,7 +95,7 @@ Active geo-replication is a powerful tool that enables Azure Cache for Redis clu
8695

8796
Azure Cache for Redis now supports authenticating storage account connections using managed identity. Identity is established through Azure Active Directory, and both system-assigned and user-assigned identities are supported. Support for managed identity further allows the service to establish trusted access to storage for uses including data persistence and importing/exporting cache data.
8897

89-
For more information, see [Managed identity with Azure Cache for Redis (Preview)](cache-managed-identity.md).
98+
For more information, see [Managed identity with Azure Cache for Redis](cache-managed-identity.md).
9099

91100
## October 2021
92101

-670 Bytes
Loading
-822 Bytes
Loading
17.4 KB
Loading
8.26 KB
Loading
21.6 KB
Loading
10.6 KB
Loading

0 commit comments

Comments
 (0)