Skip to content

Commit 8de4c80

Browse files
committed
acrolinx fixes
1 parent a055836 commit 8de4c80

File tree

2 files changed

+10
-17
lines changed

2 files changed

+10
-17
lines changed

articles/search/search-security-rbac.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -23,10 +23,10 @@ Azure provides a global [role-based access control authorization system](../role
2323

2424
+ Data plane operations, such as creating, loading, and querying indexes.
2525

26-
Per-user access over search results (sometimes referred to as row-level security or document-level security) isn't supported. As a workaround, [create security filters](search-security-trimming-for-azure-search.md) that trim results by user identity, removing documents for which the requestor shouldn't have access.
26+
Per-user access over search results (sometimes referred to as *row-level security* or *document-level security*) isn't supported. As a workaround, [create security filters](search-security-trimming-for-azure-search.md) that trim results by user identity, removing documents for which the requestor shouldn't have access.
2727

2828
> [!NOTE]
29-
> A quick note about terminology. "Control plane" refers to operations supported in the [Management REST API](/rest/api/searchmanagement/) or equivalent client libraries. "Data plane" refers to operations against the search service endpoint, such as indexing or queries, or any other operation specified in the [Search REST API](/rest/api/searchservice/) or equivalent client libraries.
29+
> A quick note about terminology. *Control plane* refers to operations supported in the [Management REST API](/rest/api/searchmanagement/) or equivalent client libraries. *Data plane* refers to operations against the search service endpoint, such as indexing or queries, or any other operation specified in the [Search REST API](/rest/api/searchservice/) or equivalent client libraries.
3030
3131
## Built-in roles used in Search
3232

@@ -197,7 +197,7 @@ Make sure that you [register your client application with Microsoft Entra ID](se
197197

198198
+ Search Index Data Contributors can load and query documents. To verify permissions, run the [Import data wizard](search-get-started-portal.md).
199199

200-
+ Search Index Data Readers can query the index. To verfiy permissions, use [Search explorer](search-explorer.md). You should be able to send queries and view results, but you shouldn't be able to view the index definition.
200+
+ Search Index Data Readers can query the index. To verify permissions, use [Search explorer](search-explorer.md). You should be able to send queries and view results, but you shouldn't be able to view the index definition.
201201

202202
### [**REST API**](#tab/test-rest)
203203

@@ -253,7 +253,7 @@ For more information on how to acquire a token for a specific environment, see [
253253

254254
1. Use [Azure.Identity for .NET](/dotnet/api/overview/azure/identity-readme) for token authentication. Microsoft recommends [`DefaultAzureCredential()`](/dotnet/api/azure.identity.defaultazurecredential) for most scenarios.
255255

256-
+ When obtaining the OAuth token, the scope is `https://search.azure.com/.default`. The SDK requires the audience to be `https://search.azure.com` The `.default` is a Microsoft Entra convention.
256+
+ The SDK requires the scope to be `https://search.azure.com/.default`. The audience is `https://search.azure.com`. The `.default` suffix is a Microsoft Entra convention.
257257

258258
+ The SDK validates that the user has the "user_impersonation" scope, which must be granted by your app, but the SDK itself just asks for `https://search.azure.com/.default`.
259259

@@ -548,17 +548,17 @@ To re-enable key authentication, rerun the last request, setting "disableLocalAu
548548

549549
## Conditional Access
550550

551-
[Conditional Access](../active-directory/conditional-access/overview.md) is a tool in Microsoft Entra ID used to enforce organizational policies. By using Conditional Access policies, you can apply the right access controls when needed to keep your organization secure. When accessing an Azure AI Search service using role-based access control, Conditional Access can enforce organizational policies.
551+
We recommend [Microsoft Entra Conditional Access](/entra/identity/conditional-access/overview) if you need to enforce organizational policies, such as multifactor authentication.
552552

553-
To enable a Conditional Access policy for Azure AI Search, follow the below steps:
553+
To enable a Conditional Access policy for Azure AI Search, follow these steps:
554554

555555
1. [Sign in](https://portal.azure.com) to the Azure portal.
556556
557557
1. Search for **Microsoft Entra Conditional Access**.
558558

559559
1. Select **Policies**.
560560

561-
1. Select **+ New policy**.
561+
1. Select **New policy**.
562562

563563
1. In the **Cloud apps or actions** section of the policy, add **Azure AI Search** as a cloud app depending on how you want to set up your policy.
564564

articles/search/search-what-is-azure-search.md

Lines changed: 3 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ Azure AI Search is well suited for the following application scenarios:
5555

5656
+ Use it for traditional full text search and next-generation vector similarity search. Back your generative AI apps with information retrieval that leverages the strength of keyword and similarity search. Use both modalities to retrieve the most relevant results.
5757

58-
+ Consolidate heterogeneous content into a user-defined and populated search index composed of vectors and text. You own and control what's searchable.
58+
+ Consolidate heterogeneous content into a user-defined and populated search index composed of vectors and text. You maintain ownership and control over what's searchable.
5959

6060
+ [Integrate data chunking and vectorization](vector-search-integrated-vectorization.md) for generative AI and RAG apps.
6161

@@ -109,17 +109,10 @@ Customers often ask how Azure AI Search compares with other search-related solut
109109

110110
Key strengths include:
111111

112-
+ Support for vector and nonvector (text) indexing and queries. With vector similarity search, you can find information that’s semantically similar to search queries, even if the search terms aren’t exact matches.
113-
+ Use hybrid search for the best of keyword and vector search.
114-
+ Ranking and relevance tuning through semantic ranking and scoring profiles.
112+
+ Support for vector and nonvector (text) indexing and queries. With vector similarity search, you can find information that’s semantically similar to search queries, even if the search terms aren’t exact matches. Use hybrid search for the best of keyword and vector search.
113+
+ Ranking and relevance tuning through semantic ranking and scoring profiles. Query syntax supports term boosting and field prioritization.
115114
+ Azure data integration (crawlers) at the indexing layer.
116115
+ Azure AI integration for transformations that make content text and vector searchable.
117116
+ Microsoft Entra security for trusted connections, and Azure Private Link for private connections in no-internet scenarios.
118117
+ [Full search experience](search-features-list.md): Linguistic and custom text analysis in 56 languages. Faceting, autocomplete queries and suggested results, and synonyms.
119118
+ Azure scale, reliability, and global reach.
120-
121-
<!-- ## Watch this video
122-
123-
In this 15-minute video, review the main capabilities of Azure AI Search.
124-
125-
>[!VIDEO https://www.youtube.com/embed/kOJU0YZodVk?version=3] -->

0 commit comments

Comments
 (0)