Skip to content

Commit 909c518

Browse files
Merge pull request #274619 from flang-msft/fxl---Microsoft-Entra-ID-(AAD)-with-Redis-GA-announcement-ado26147527
Fxl---microsoft entra id (aad) with redis ga announcement ado-26147527
2 parents f20d0d6 + 485c5e9 commit 909c518

16 files changed

+25
-32
lines changed

articles/azure-cache-for-redis/cache-azure-active-directory-for-authentication.md

Lines changed: 8 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -7,29 +7,26 @@ author: flang-msft
77
ms.custom: references_regions
88
ms.service: cache
99
ms.topic: conceptual
10-
ms.date: 02/07/2024
10+
ms.date: 05/09/2024
1111
ms.author: franlanglois
1212

1313
---
1414

15-
# Use Microsoft Entra ID (preview) for cache authentication
15+
# Use Microsoft Entra ID for cache authentication
1616

17-
Azure Cache for Redis offers two methods to authenticate to your cache instance:
18-
19-
- [Access keys](cache-configure.md#access-keys)
20-
- [Microsoft Entra ID (preview)](cache-configure.md#preview-microsoft-entra-authentication)
17+
Azure Cache for Redis offers two methods to [authenticate](cache-configure.md#authentication) to your cache instance: Access keys and Microsoft Entra ID
2118

2219
Although access key authentication is simple, it comes with a set of challenges around security and password management. For contrast, in this article, you learn how to use a Microsoft Entra token for cache authentication.
2320

24-
Azure Cache for Redis offers a password-free authentication mechanism by integrating with [Microsoft Entra ID (preview)](/azure/active-directory/fundamentals/active-directory-whatis). This integration also includes [role-based access control](/azure/role-based-access-control/) functionality provided through [access control lists (ACLs)](https://redis.io/docs/management/security/acl/) supported in open source Redis.
21+
Azure Cache for Redis offers a password-free authentication mechanism by integrating with [Microsoft Entra ID)](/azure/active-directory/fundamentals/active-directory-whatis). This integration also includes [role-based access control](/azure/role-based-access-control/) functionality provided through [access control lists (ACLs)](https://redis.io/docs/management/security/acl/) supported in open source Redis.
2522

2623
To use the ACL integration, your client application must assume the identity of a Microsoft Entra entity, like service principal or managed identity, and connect to your cache. In this article, you learn how to use your service principal or managed identity to connect to your cache, and how to grant your connection predefined permissions based on the Microsoft Entra artifact being used for the connection.
2724

2825
## Scope of availability
2926

3027
| **Tier** | Basic, Standard, Premium | Enterprise, Enterprise Flash |
3128
|:-----------------|:------------------------:|:----------------------------:|
32-
| **Availability** | Yes (preview) | No |
29+
| **Availability** | Yes | No |
3330

3431
## Prerequisites and limitations
3532

@@ -47,7 +44,7 @@ To use the ACL integration, your client application must assume the identity of
4744

4845
1. Select **Authentication** from the Resource menu.
4946

50-
1. In the working pane, select **(PREVIEW) Enable Microsoft Entra Authentication**.
47+
1. In the working pane, select **Enable Microsoft Entra Authentication**.
5148

5249
1. Select **Enable Microsoft Entra Authentication**, and enter the name of a valid user. The user you enter is automatically assigned _Data Owner Access Policy_ by default when you select **Save**. You can also enter a managed identity or service principal to connect to your cache instance.
5350

@@ -66,15 +63,15 @@ If you would like to use a custom access policy instead of Redis Data Owner, go
6663

6764
1. In the Azure portal, select the Azure Cache for Redis instance where you'd like to add to the Data Access Configuration.
6865

69-
1. Select **(PREVIEW) Data Access Configuration** from the Resource menu.
66+
1. Select **Data Access Configuration** from the Resource menu.
7067

7168
1. Select **Add** and choose **New Redis User**.
7269

7370
1. On the **Access Policy** tab, select one the available policies in the table: **Data Owner**, **Data Contributor**, or **Data Reader**. Then, select the **Next:Redis Users**.
7471

7572
:::image type="content" source="media/cache-azure-active-directory-for-authentication/cache-new-redis-user.png" alt-text="Screenshot showing the available Access Policies.":::
7673

77-
1. Choose either the **User or service principal** or **Managed Identity** to determine how to assign access to your Azure Cache for Redis instance. If you select **User or service principal**,and you want to add a _user_, you must first [enable Microsoft Entra Authentication](#enable-microsoft-entra-id-authentication-on-your-cache).
74+
1. Choose either the **User or service principal** or **Managed Identity** to determine how to assign access to your Azure Cache for Redis instance. If you select **User or service principal**, and you want to add a _user_, you must first [enable Microsoft Entra Authentication](#enable-microsoft-entra-id-authentication-on-your-cache).
7875

7976
1. Then, select **Select members** and select **Select**. Then, select **Next : Review + Assign**.
8077
:::image type="content" source="media/cache-azure-active-directory-for-authentication/cache-select-members.png" alt-text="Screenshot showing members to add as New Redis Users.":::
@@ -88,8 +85,6 @@ If you would like to use a custom access policy instead of Redis Data Owner, go
8885

8986
Because most Azure Cache for Redis clients assume that a password and access key are used for authentication, you likely need to update your client workflow to support authentication using Microsoft Entra ID. In this section, you learn how to configure your client applications to connect to Azure Cache for Redis using a Microsoft Entra token.
9087

91-
<!-- :::image type="content" source="media/cache-azure-active-directory-for-authentication/azure-ad-token.png" alt-text="Architecture diagram showing the flow of a token from Microsoft Entra ID to a customer application to a cache."::: -->
92-
9388
### Microsoft Entra Client Workflow
9489

9590
1. Configure your client application to acquire a Microsoft Entra token for scope, `https://redis.azure.com/.default` or `acca5fbb-b7e4-4009-81f1-37e38fd66d78/.default`, using the [Microsoft Authentication Library (MSAL)](/azure/active-directory/develop/msal-overview).
@@ -134,4 +129,3 @@ The following table includes links to code samples, which demonstrate how to con
134129

135130
- [Configure role-based access control with Data Access Policy](cache-configure-role-based-access-control.md)
136131
- [Reference pages for identity](/cli/azure/redis/identity)
137-

articles/azure-cache-for-redis/cache-configure-role-based-access-control.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ Azure Cache for Redis offers three built-in access policies: _Owner_, _Contribut
2424

2525
| **Tier** | Basic, Standard, Premium | Enterprise, Enterprise Flash |
2626
|:-----------------|:------------------------:|:----------------------------:|
27-
| **Availability** | Yes (preview) | No |
27+
| **Availability** | Yes | No |
2828

2929
## Prerequisites and limitations
3030

@@ -104,7 +104,7 @@ The following list contains some examples of permission strings for various scen
104104

105105
1. In the Azure portal, select the Azure Cache for Redis instance where you want to configure Microsoft Entra token-based authentication.
106106

107-
1. From the Resource menu, select **(PREVIEW) Data Access configuration**.
107+
1. From the Resource menu, select **Data Access configuration**.
108108

109109
:::image type="content" source="media/cache-configure-role-based-access-control/cache-data-access-configuration.png" alt-text="Screenshot showing Data Access Configuration highlighted in the Resource menu.":::
110110

@@ -118,9 +118,9 @@ The following list contains some examples of permission strings for various scen
118118

119119
1. To add a user to the access policy using Microsoft Entra ID, you must first enable Microsoft Entra ID by selecting **Authentication** from the Resource menu.
120120

121-
1. Select **(PREVIEW) Enable Microsoft Entra Authentication** as the tab in the working pane.
121+
1. Select **Enable Microsoft Entra Authentication** as the tab in the working pane.
122122

123-
1. If not checked already, check the box labeled **(PREVIEW) Enable Microsoft Entra Authentication** and select **OK**. Then, select **Save**.
123+
1. If not checked already, check the box labeled **Enable Microsoft Entra Authentication** and select **OK**. Then, select **Save**.
124124

125125
:::image type="content" source="media/cache-azure-active-directory-for-authentication/cache-enable-microsoft-entra.png" alt-text="Screenshot of Microsoft Entra ID access authorization.":::
126126

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

Lines changed: 4 additions & 6 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: 09/29/2023
8+
ms.date: 05/07/2024
99
ms.author: franlanglois
1010
ms.custom: engagement-fy23
1111
---
@@ -135,8 +135,6 @@ For information on moving resources from one resource group to another, and from
135135
The **Settings** section allows you to access and configure the following settings for your cache.
136136

137137
- [Authentication](#authentication)
138-
- [Access keys](#access-keys)
139-
- [(Preview) Microsoft Entra Authentication](#preview-microsoft-entra-authentication)
140138
- [Advanced settings](#advanced-settings)
141139
- [Scale](#scale)
142140
- [Cluster size](#cluster-size)
@@ -153,15 +151,15 @@ The **Settings** section allows you to access and configure the following settin
153151

154152
You have two options for authentication: access keys and Microsoft Entra Authentication.
155153

156-
#### Access keys
154+
#### [Access keys](#tab/access-keys)
157155

158156
Select **Access keys** to view or regenerate the access keys for your cache. These keys are used by the clients connecting to your cache.
159157

160158
:::image type="content" source="media/cache-configure/redis-cache-manage-keys.png" alt-text="Screenshot showing Authentication selected in the Resource menu and access Keys in the working pane.":::
161159

162-
#### (Preview) Microsoft Entra Authentication
160+
#### [Microsoft Entra Authentication](#tab/entra)
163161

164-
Select **(Preview) Microsoft Entra Authentication** to a password-free authentication mechanism by integrating with Microsoft Entra ID. This integration also includes role-based access control functionality provided through access control lists (ACLs) supported in open source Redis.
162+
Select **Microsoft Entra Authentication** to a password-free authentication mechanism by integrating with Microsoft Entra ID. This integration also includes role-based access control functionality provided through access control lists (ACLs) supported in open source Redis.
165163

166164
:::image type="content" source="media/cache-configure/cache-microsoft-entra.png" alt-text="Screenshot showing Authentication selected in the Resource menu and Microsoft Entra ID in the working pane.":::
167165

articles/azure-cache-for-redis/cache-how-to-monitor.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: flang-msft
55
ms.author: franlanglois
66
ms.service: cache
77
ms.topic: conceptual
8-
ms.date: 02/29/2024
8+
ms.date: 05/07/2024
99

1010
---
1111
# How to monitor Azure Cache for Redis

articles/azure-cache-for-redis/cache-tutorial-functions-getting-started.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -101,7 +101,7 @@ dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Redis --prereleas
101101

102102
:::image type="content" source="media/cache-tutorial-functions-getting-started/cache-keyspace-notifications.png" alt-text="Screenshot of advanced settings for Azure Cache for Redis in the portal.":::
103103

104-
1. Select **Access keys** from the resource menu, and then write down or copy the contents of the **Primary connection string** box. This string is used to connect to the cache.
104+
1. Locate **Access keys** on the Resource menu, and then write down or copy the contents of the **Primary connection string** box. This string is used to connect to the cache.
105105

106106
:::image type="content" source="media/cache-tutorial-functions-getting-started/cache-access-keys.png" alt-text="Screenshot that shows the primary connection string for an access key.":::
107107

articles/azure-cache-for-redis/cache-tutorial-write-behind.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -198,7 +198,7 @@ You need to update the _local.settings.json_ file to include the connection stri
198198
}
199199
```
200200

201-
To find the Redis connection string, go to the resource menu in the Azure Cache for Redis resource. The string is in the **Access Keys** area of **Settings**.
201+
To find the Redis connection string, go to the resource menu in the Azure Cache for Redis resource. Locate the string is in the **Access Keys** area on the Resource menu.
202202

203203
To find the SQL database connection string, go to the resource menu in the SQL database resource. Under **Settings**, select **Connection strings**, and then select the **ADO.NET** tab.
204204
The string is in the **ADO.NET (SQL authentication)** area.
-1.28 KB
Loading
19.2 KB
Loading

articles/azure-cache-for-redis/includes/redis-cache-create.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: redis-cache
55
author: flang-msft
66
ms.service: cache
77
ms.topic: "include"
8-
ms.date: 02/13/2024
8+
ms.date: 05/07/2024
99
ms.author: franlanglois
1010
ms.custom: "include file"
1111
---
@@ -14,19 +14,20 @@ ms.custom: "include file"
1414

1515
:::image type="content" source="media/redis-cache-create/create-resource.png" alt-text="Create a resource is highlighted in the left navigation pane.":::
1616

17-
1. On the **New** page, select **Databases** and then select **Azure Cache for Redis**.
17+
1. On the **Get Started** page, type _Azure Cache for Redis_ in the search box. Then, select **Create**.
1818

19-
:::image type="content" source="media/redis-cache-create/select-cache.png" alt-text="On New, Databases is highlighted, and Azure Cache for Redis is highlighted.":::
19+
:::image type="content" source="media/redis-cache-create/select-cache.png" alt-text="Screenshot of the Azure Marketplace with Azure Cache for Redis in the search box and create is highlighted with a red box.":::
2020

21-
1. On the **New Redis Cache** page, configure the settings for your new cache.
21+
1. On the **New Redis Cache** page, configure the settings for your cache.
2222

2323
| Setting | Choose a value | Description |
2424
| ------------ | ------- | -------------------------------------------------- |
2525
| **Subscription** | Drop down and select your subscription. | The subscription under which to create this new Azure Cache for Redis instance. |
2626
| **Resource group** | Drop down and select a resource group, or select **Create new** and enter a new resource group name. | Name for the resource group in which to create your cache and other resources. By putting all your app resources in one resource group, you can easily manage or delete them together. |
2727
| **DNS name** | Enter a unique name. | The cache name must be a string between 1 and 63 characters that contain only numbers, letters, or hyphens. The name must start and end with a number or letter, and can't contain consecutive hyphens. Your cache instance's *host name* is *\<DNS name>.redis.cache.windows.net*. |
2828
| **Location** | Drop down and select a location. | Select a [region](https://azure.microsoft.com/regions/) near other services that use your cache. |
29-
| **Cache type** | Drop down and select a [tier](https://azure.microsoft.com/pricing/details/cache/). | The tier determines the size, performance, and features that are available for the cache. For more information, see [Azure Cache for Redis Overview](../cache-overview.md). |
29+
| **Cache SKU** | Drop down and select a [**SKU**](https://azure.microsoft.com/pricing/details/cache/). | The SKU determines the size, performance, and features parameters that are available for the cache. For more information, see [Azure Cache for Redis Overview](../cache-overview.md). |
30+
| **Cache size** | Drop down and select a size of your cache | For more information, see [Azure Cache for Redis Overview](../cache-overview.md). |
3031

3132
1. Select the **Networking** tab or select the **Networking** button at the bottom of the page.
3233

Loading

0 commit comments

Comments
 (0)