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/search/search-manage.md
+11-13Lines changed: 11 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,15 +7,13 @@ author: haileytap
7
7
ms.author: haileytapia
8
8
ms.service: azure-ai-search
9
9
ms.topic: how-to
10
-
ms.date: 03/04/2025
10
+
ms.date: 03/05/2025
11
11
---
12
12
13
13
# Configure your Azure AI Search service in the Azure portal
14
14
15
15
Configuring your new Azure AI Search service involves several tasks to optimize security, access, and performance. This article provides a day-one checklist to help you set up your service in the [Azure portal](https://portal.azure.com).
16
16
17
-
## Day-one configuration checklist
18
-
19
17
After you create a search service, we recommend that you:
20
18
21
19
> [!div class="checklist"]
@@ -27,7 +25,7 @@ After you create a search service, we recommend that you:
> +[Provide connection information to developers](#provide-connection-information-to-developers).
29
27
30
-
###Configure role-based access
28
+
## Configure role-based access
31
29
32
30
Portal access is based on [role assignments](search-security-rbac.md). By default, new search services have at least one service administrator or owner. Service administrators, co-administrators, and owners have permission to create more administrators and assign other roles. They also have access to all portal pages and operations on default search services.
33
31
@@ -53,7 +51,7 @@ To configure RBAC:
53
51
54
52
1.[Assign more roles](search-security-rbac.md) for solution developers and apps.
55
53
56
-
###Configure a managed identity
54
+
## Configure a managed identity
57
55
58
56
If you plan to use indexers for automated indexing, applied AI, or integrated vectorization, you should [configure your search service to use a managed identity](search-howto-managed-identities-data-sources.md). You can then assign roles on other Azure services that authorize your search service to access data and operations.
59
57
@@ -64,9 +62,9 @@ For integrated vectorization, your search service identity needs the following r
64
62
65
63
Role assignments can take several minutes to take effect.
66
64
67
-
Before you move on to network security, consider testing all points of connection to validate role assignments. Run either the [Import data wizard](search-get-started-portal.md) or the [Import and vectorize data wizard](search-get-started-portal-image-search.md) to test permissions.
65
+
Before you move on to network security, consider testing all points of connection to validate role assignments. Run either the [**Import data** wizard](search-get-started-portal.md) or the [**Import and vectorize data** wizard](search-get-started-portal-image-search.md) to test permissions.
68
66
69
-
###Configure network security
67
+
## Configure network security
70
68
71
69
By default, a search service accepts authenticated and authorized requests over public internet connections. You have two options for enhancing network security:
72
70
@@ -75,29 +73,29 @@ By default, a search service accepts authenticated and authorized requests over
75
73
76
74
To learn about inbound and outbound calls in Azure AI Search, see [Security in Azure AI Search](search-security-overview.md).
77
75
78
-
###Check capacity and understand billing
76
+
## Check capacity and understand billing
79
77
80
78
By default, a search service is created with one replica and one partition. You can [add capacity](search-capacity-planning.md) by adding replicas and partitions, but we recommend waiting until volumes require it. Many customers run production workloads on the minimum configuration.
81
79
82
80
Semantic ranker increases the cost of running your service. You can [disable semantic ranker](semantic-how-to-enable-disable.md) at the service level to prevent the use of this feature.
83
81
84
82
To learn about other features that affect billing, see [How you're charged for Azure AI Search](search-sku-manage-costs.md#how-youre-charged-for-azure-ai-search).
85
83
86
-
###Enable diagnostic logging
84
+
## Enable diagnostic logging
87
85
88
86
[Enable diagnostic logging](search-monitor-enable-logging.md) to track user activity. If you skip this step, you still get [activity logs](/azure/azure-monitor/essentials/activity-log) and [platform metrics](/azure/azure-monitor/essentials/data-platform-metrics#types-of-metrics) automatically. However, if you want index and query usage information, you should enable diagnostic logging and choose a destination for logged operations. We recommend Log Analytics Workspace for durable storage so that you can run system queries in the Azure portal.
89
87
90
88
Internally, Microsoft collects telemetry data about your service and the platform. To learn more about data retention, see [Retention of metrics](/azure/azure-monitor/essentials/data-platform-metrics#retention-of-metrics).
91
89
92
90
To learn more about data location and privacy, see [Data residency](search-security-overview.md#data-residency).
93
91
94
-
###Enable semantic ranker
92
+
## Enable semantic ranker
95
93
96
94
Semantic ranker is free for the first 1,000 requests per month. It's enabled by default on newer search services.
97
95
98
96
To enable semantic ranker in the portal, select **Settings** > **Semantic ranker** from the left pane, and then select the **Free** plan. For more information, see [Enable semantic ranker](semantic-how-to-enable-disable.md).
99
97
100
-
###Provide connection information to developers
98
+
## Provide connection information to developers
101
99
102
100
Developers need the following information to connect to Azure AI Search:
103
101
@@ -106,8 +104,8 @@ Developers need the following information to connect to Azure AI Search:
106
104
107
105
We recommend using the portal for the following wizards and tools:
108
106
109
-
+[Import data wizard](search-get-started-portal.md)
110
-
+[Import and vectorize data](search-get-started-portal-import-vectors.md)
0 commit comments