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/azure-cache-for-redis/cache-azure-active-directory-for-authentication.md
+8-14Lines changed: 8 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,29 +7,26 @@ author: flang-msft
7
7
ms.custom: references_regions
8
8
ms.service: cache
9
9
ms.topic: conceptual
10
-
ms.date: 02/07/2024
10
+
ms.date: 05/09/2024
11
11
ms.author: franlanglois
12
12
13
13
---
14
14
15
-
# Use Microsoft Entra ID (preview) for cache authentication
15
+
# Use Microsoft Entra ID for cache authentication
16
16
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
21
18
22
19
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.
23
20
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.
25
22
26
23
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.
@@ -47,7 +44,7 @@ To use the ACL integration, your client application must assume the identity of
47
44
48
45
1. Select **Authentication** from the Resource menu.
49
46
50
-
1. In the working pane, select **(PREVIEW) Enable Microsoft Entra Authentication**.
47
+
1. In the working pane, select **Enable Microsoft Entra Authentication**.
51
48
52
49
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.
53
50
@@ -66,15 +63,15 @@ If you would like to use a custom access policy instead of Redis Data Owner, go
66
63
67
64
1. In the Azure portal, select the Azure Cache for Redis instance where you'd like to add to the Data Access Configuration.
68
65
69
-
1. Select **(PREVIEW) Data Access Configuration** from the Resource menu.
66
+
1. Select **Data Access Configuration** from the Resource menu.
70
67
71
68
1. Select **Add** and choose **New Redis User**.
72
69
73
70
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**.
74
71
75
72
:::image type="content" source="media/cache-azure-active-directory-for-authentication/cache-new-redis-user.png" alt-text="Screenshot showing the available Access Policies.":::
76
73
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).
:::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
88
85
89
86
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.
90
87
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
-
93
88
### Microsoft Entra Client Workflow
94
89
95
90
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
134
129
135
130
-[Configure role-based access control with Data Access Policy](cache-configure-role-based-access-control.md)
136
131
-[Reference pages for identity](/cli/azure/redis/identity)
@@ -104,7 +104,7 @@ The following list contains some examples of permission strings for various scen
104
104
105
105
1. In the Azure portal, select the Azure Cache for Redis instance where you want to configure Microsoft Entra token-based authentication.
106
106
107
-
1. From the Resource menu, select **(PREVIEW) Data Access configuration**.
107
+
1. From the Resource menu, select **Data Access configuration**.
108
108
109
109
:::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.":::
110
110
@@ -118,9 +118,9 @@ The following list contains some examples of permission strings for various scen
118
118
119
119
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.
120
120
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.
122
122
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**.
124
124
125
125
:::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.":::
Copy file name to clipboardExpand all lines: articles/azure-cache-for-redis/cache-configure.md
+4-6Lines changed: 4 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@ author: flang-msft
5
5
6
6
ms.service: cache
7
7
ms.topic: conceptual
8
-
ms.date: 09/29/2023
8
+
ms.date: 05/07/2024
9
9
ms.author: franlanglois
10
10
ms.custom: engagement-fy23
11
11
---
@@ -135,8 +135,6 @@ For information on moving resources from one resource group to another, and from
135
135
The **Settings** section allows you to access and configure the following settings for your cache.
136
136
137
137
-[Authentication](#authentication)
138
-
-[Access keys](#access-keys)
139
-
-[(Preview) Microsoft Entra Authentication](#preview-microsoft-entra-authentication)
140
138
-[Advanced settings](#advanced-settings)
141
139
-[Scale](#scale)
142
140
-[Cluster size](#cluster-size)
@@ -153,15 +151,15 @@ The **Settings** section allows you to access and configure the following settin
153
151
154
152
You have two options for authentication: access keys and Microsoft Entra Authentication.
155
153
156
-
#### Access keys
154
+
#### [Access keys](#tab/access-keys)
157
155
158
156
Select **Access keys** to view or regenerate the access keys for your cache. These keys are used by the clients connecting to your cache.
159
157
160
158
:::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.":::
161
159
162
-
#### (Preview) Microsoft Entra Authentication
160
+
#### [Microsoft Entra Authentication](#tab/entra)
163
161
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.
165
163
166
164
:::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.":::
:::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.":::
103
103
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.
105
105
106
106
:::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.":::
Copy file name to clipboardExpand all lines: articles/azure-cache-for-redis/cache-tutorial-write-behind.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -198,7 +198,7 @@ You need to update the _local.settings.json_ file to include the connection stri
198
198
}
199
199
```
200
200
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.
202
202
203
203
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.
204
204
The string is in the **ADO.NET (SQL authentication)** area.
Copy file name to clipboardExpand all lines: articles/azure-cache-for-redis/includes/redis-cache-create.md
+6-5Lines changed: 6 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@ services: redis-cache
5
5
author: flang-msft
6
6
ms.service: cache
7
7
ms.topic: "include"
8
-
ms.date: 02/13/2024
8
+
ms.date: 05/07/2024
9
9
ms.author: franlanglois
10
10
ms.custom: "include file"
11
11
---
@@ -14,19 +14,20 @@ ms.custom: "include file"
14
14
15
15
:::image type="content" source="media/redis-cache-create/create-resource.png" alt-text="Create a resource is highlighted in the left navigation pane.":::
16
16
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**.
18
18
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.":::
20
20
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.
|**Subscription**| Drop down and select your subscription. | The subscription under which to create this new Azure Cache for Redis instance. |
26
26
|**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. |
27
27
|**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*. |
28
28
|**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). |
30
31
31
32
1. Select the **Networking** tab or select the **Networking** button at the bottom of the page.
0 commit comments