Skip to content

Commit 50a17cc

Browse files
updating rbac signup instructions
1 parent a4931a3 commit 50a17cc

File tree

3 files changed

+25
-9
lines changed

3 files changed

+25
-9
lines changed
58.5 KB
Loading

articles/search/search-howto-aad.md

Lines changed: 15 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -25,11 +25,20 @@ As a first step, [create a search service](search-create-service-portal.md) and
2525

2626
### Sign up for the preview
2727

28-
The parts of Azure Cognitive Search's RBAC capabilities required to use Azure AD for querying the search service are still in a gated preview.
28+
The parts of Azure Cognitive Search's RBAC capabilities required to use Azure AD for querying the search service are still in preview. To use these capabilities, you'll need to add the preview feature to your Azure subscription
2929

30-
For enrollment into the preview, [fill out this form](https://aka.ms/azure-cognitive-search/rbac-preview).
30+
To add your subscription to the preview:
31+
32+
1. Navigate to the **Subscriptions** blade in the [Azure Portal](https://portal.azure.com/).
33+
1. Select the subscription you want to use.
34+
1. On the left-hand side of the subscription page, select **Preview Features**.
35+
1. Use the search bar or filters to find and select **Role Based Access Control for Search Service (Preview)**
36+
1. Click **Register** to add the feature to your subscription.
37+
38+
![sign up for rbac on afec](media/search-howto-aad/rbac-signup-afec.png)
39+
40+
For more details, on adding preview features, see [Set up preview features in Azure subscription](azure/azure-resource-manager/management/preview-features?tabs=azure-portal).
3141

32-
It may take a few business days to process your request.
3342

3443
### Enable RBAC for data plane operations
3544

@@ -38,7 +47,7 @@ Once your subscription is onboarded to the preview, you'll still need to enable
3847
To enable role-based access control:
3948

4049
1. Navigate to the Azure portal with this preview link: [https://ms.portal.azure.com/?feature.enableRbac=true](https://ms.portal.azure.com/?feature.enableRbac=true).
41-
1. On the left navigation pane, select **Keys**
50+
1. On the left navigation pane, select **Keys**.
4251
1. Determine if you'd like to allow both key-based and role-based access control, or only role-based access control.
4352

4453
![authentication options for azure cognitive search in the portal](media/search-howto-aad/portal-api-access-control.png)
@@ -65,7 +74,7 @@ At this point, you've created your Azure AD application and service principal. M
6574

6675
The application will also need a client secret or certificate to prove its identity when requesting a token. In this document, we'll show how to use a client secret.
6776

68-
1. Navigate to the app registration you just created
77+
1. Navigate to the app registration you just created.
6978
1. Select **Certificates and secrets**.
7079
1. Under **Client secrets**, click **New client secret**.
7180
1. Provide a description of the secret and select the desired expiration interval.
@@ -87,7 +96,7 @@ To assign a role to your app registration:
8796
1. On the right side under **Grant access to this resource**, select **Add role assignment**.
8897
1. Select the role you'd like to use and then click **Next**.
8998
1. On the next page, click **Select members** and find the application you created previously.
90-
1. Finally, click **Review + assign**
99+
1. Finally, click **Review + assign**.
91100

92101
![Add role assignment in the azure portal](media/search-howto-aad/role-assignment.png)
93102

articles/search/search-security-rbac.md

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -58,11 +58,18 @@ Skip this step if you are using generally available roles (Owner, Contributor, R
5858

5959
New built-in preview roles provide a granular set of permissions over content on the search service. Although built-in roles are always visible in the Azure portal, service enrollment is required to make them operational.
6060

61-
For enrollment into the preview program:
61+
To add your subscription to the preview:
6262

63-
+ [Fill out this form](https://aka.ms/azure-cognitive-search/rbac-preview)
63+
1. Navigate to the **Subscriptions** blade in the [Azure Portal](https://portal.azure.com/).
64+
1. Select the subscription you want to use.
65+
1. On the left-hand side of the subscription page, select **Preview Features**.
66+
1. Use the search bar or filters to find and select **Role Based Access Control for Search Service (Preview)**
67+
1. Click **Register** to add the feature to your subscription.
68+
69+
![sign up for rbac on afec](media/search-howto-aad/rbac-signup-afec.png)
70+
71+
For more details, on adding preview features, see [Set up preview features in Azure subscription](azure/azure-resource-manager/management/preview-features?tabs=azure-portal).
6472

65-
It can take up to two business days to process enrollment requests. You'll receive an email when your service is ready.
6673

6774
## Step 2: Preview configuration
6875

0 commit comments

Comments
 (0)