Skip to content

Commit 18ae5fa

Browse files
committed
GH issues
1 parent 88b60d0 commit 18ae5fa

File tree

3 files changed

+18
-16
lines changed

3 files changed

+18
-16
lines changed

articles/search/search-howto-index-encrypted-blobs.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,14 +11,14 @@ ms.custom:
1111
- ignite-2023
1212
ms.service: cognitive-search
1313
ms.topic: tutorial
14-
ms.date: 03/18/2024
14+
ms.date: 05/23/2024
1515
---
1616

1717
# Tutorial: Index and enrich encrypted blobs for full-text search in Azure AI Search
1818

1919
This tutorial shows you how to use [Azure AI Search](search-what-is-azure-search.md) to index documents that have been previously encrypted with a customer-managed key in [Azure Blob Storage](../storage/blobs/storage-blobs-introduction.md).
2020

21-
Normally, an indexer can't extract content from encrypted files because it doesn't have access to the customer-managed encryption key in [Azure Key Vault](../key-vault/general/overview.md). However, by leveraging the [DecryptBlobFile custom skill](https://github.com/Azure-Samples/azure-search-power-skills/blob/main/Utils/DecryptBlobFile), followed by the [Document Extraction skill](cognitive-search-skill-document-extraction.md), you can provide controlled access to the key to decrypt the files and then extract content from them. This unlocks the ability to index and enrich these documents without compromising the encryption status of your stored documents.
21+
Normally, an indexer can't extract content from blobs that have been encrypted using the [client side encryption](/azure/storage/blobs/client-side-encryption) of the Azure Blob Storage client library because the indexer doesn't have access to the customer-managed encryption key in [Azure Key Vault](../key-vault/general/overview.md). However, by leveraging the [DecryptBlobFile custom skill](https://github.com/Azure-Samples/azure-search-power-skills/blob/main/Utils/DecryptBlobFile), followed by the [Document Extraction skill](cognitive-search-skill-document-extraction.md), you can provide controlled access to the key to decrypt the files and then extract content from them. This unlocks the ability to index and enrich these documents without compromising the encryption status of your stored documents.
2222

2323
Starting with previously encrypted whole documents (unstructured text) such as PDF, HTML, DOCX, and PPTX in Azure Blob Storage, this tutorial uses a REST client and the Search REST APIs to perform the following tasks:
2424

articles/search/search-indexer-how-to-access-private-sql.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,15 +6,13 @@ description: Configure an indexer connection to access content in an Azure SQL M
66
author: mattgotteiner
77
ms.author: magottei
88
ms.service: cognitive-search
9-
ms.custom:
10-
- ignite-2023
119
ms.topic: how-to
12-
ms.date: 09/29/2023
10+
ms.date: 05/23/2024
1311
---
1412

1513
# Create a shared private link for a SQL managed instance from Azure AI Search
1614

17-
This article explains how to configure an indexer in Azure AI Search for a private connection to a SQL managed instance that runs within a virtual network.
15+
This article explains how to configure an indexer in Azure AI Search for a private connection to a SQL managed instance that runs within a virtual network. The private connection is through a [shared private link](search-indexer-howto-access-private.md) and Azure Private Link.
1816

1917
On a private connection to a managed instance, the fully qualified domain name (FQDN) of the instance must include the [DNS Zone](/azure/azure-sql/managed-instance/connectivity-architecture-overview#virtual-cluster-connectivity-architecture). Currently, only the Azure AI Search Management REST API provides a `resourceRegion` parameter for accepting the DNS zone specification.
2018

@@ -36,7 +34,7 @@ Although you can call the Management REST API directly, it's easier to use the A
3634
+ Azure SQL Managed Instance connection string. Managed identity is not currently supported with shared private link. Your connection string must include a user name and password.
3735

3836
> [!NOTE]
39-
> Azure Private Link is used internally, at no charge, to set up the shared private link.
37+
> Shared private links are billable through [Azure Private Link pricing](https://azure.microsoft.com/pricing/details/private-link/) and charges are invoiced based on usage.
4038
4139
## 1 - Retrieve connection information
4240

articles/search/search-indexer-howto-access-private.md

Lines changed: 13 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ author: mrcarter8
88
ms.author: mcarter
99
ms.service: cognitive-search
1010
ms.topic: how-to
11-
ms.date: 05/21/2024
11+
ms.date: 05/23/2024
1212
---
1313

1414
# Make outbound connections through a shared private link
@@ -20,7 +20,7 @@ Setting up a private connection allows a search service to connect to a virtual
2020
Shared private link is a premium feature that's billed by usage. When you set up a shared private link, charges for the private endpoint are added to your Azure invoice. As you use the shared private link, data transfer rates for inbound and outbound access are also invoiced. For details, see [Azure Private Link pricing](https://azure.microsoft.com/pricing/details/private-link/).
2121

2222
> [!NOTE]
23-
> If you're setting up a private indexer connection to a SQL Managed Instance, see [this article](search-indexer-how-to-access-private-sql.md) instead.
23+
> If you're setting up a private indexer connection to a SQL Managed Instance, see [this article](search-indexer-how-to-access-private-sql.md) instead for steps specific to that resource type.
2424
2525
## When to use a shared private link
2626

@@ -64,6 +64,8 @@ When evaluating shared private links for your scenario, remember these constrain
6464

6565
+ Indexer execution must use the private execution environment that's specific to your search service. Private endpoint connections aren't supported from the multitenant environment. The configuration setting for this requirement is covered in this article.
6666

67+
+
68+
6769
## Prerequisites
6870

6971
+ An Azure AI Search at the Basic tier or higher. If you're using [AI enrichment](cognitive-search-concept-intro.md) and skillsets, the tier must be Standard 2 (S2) or higher. See [Service limits](search-limits-quotas-capacity.md#shared-private-link-resource-limits) for details.
@@ -90,22 +92,24 @@ You can create a shared private link for the following resources.
9092
|-----------------------------------|----------------------------|
9193
| Microsoft.Storage/storageAccounts <sup>1</sup> | `blob`, `table`, `dfs`, `file` |
9294
| Microsoft.DocumentDB/databaseAccounts <sup>2</sup>| `Sql` |
93-
| Microsoft.Sql/servers | `sqlServer` |
95+
| Microsoft.Sql/servers <sup>3</sup> | `sqlServer` |
9496
| Microsoft.KeyVault/vaults | `vault` |
9597
| Microsoft.DBforMySQL/servers (preview) | `mysqlServer`|
96-
| Microsoft.Web/sites (preview) <sup>3</sup> | `sites` |
97-
| Microsoft.Sql/managedInstances (preview) <sup>4</sup>| `managedInstance` |
98-
| Microsoft.CognitiveServices/accounts (preview) <sup>5</sup>| `openai_account` |
98+
| Microsoft.Web/sites (preview) <sup>4</sup> | `sites` |
99+
| Microsoft.Sql/managedInstances (preview) <sup>5</sup>| `managedInstance` |
100+
| Microsoft.CognitiveServices/accounts (preview) <sup>6</sup>| `openai_account` |
99101

100102
<sup>1</sup> If Azure Storage and Azure AI Search are in the same region, the connection to storage is made over the Microsoft backbone network, which means a shared private link is redundant for this configuration. However, if you already set up a private endpoint for Azure Storage, you should also set up a shared private link or the connection is refused on the storage side. Also, if you're using multiple storage formats for various scenarios in search, make sure to create a separate shared private link for each subresource.
101103

102104
<sup>2</sup> The `Microsoft.DocumentDB/databaseAccounts` resource type is used for indexer connections to Azure Cosmos DB for NoSQL. The provider name and group ID are case-sensitive.
103105

104-
<sup>3</sup> The `Microsoft.Web/sites` resource type is used for App service and Azure functions. In the context of Azure AI Search, an Azure function is the more likely scenario. An Azure function is commonly used for hosting the logic of a custom skill. Azure Function has Consumption, Premium, and Dedicated [App Service hosting plans](../app-service/overview-hosting-plans.md). The [App Service Environment (ASE)](../app-service/environment/overview.md) and [Azure Kubernetes Service (AKS)](../aks/intro-kubernetes.md) aren't supported at this time.
106+
<sup>3</sup> The `Microsoft.Sql/servers` resource type is used for connections to Azure SQL database. There's currently no support for a shared private link to Azure Synapse SQL.
107+
108+
<sup>4</sup> The `Microsoft.Web/sites` resource type is used for App service and Azure functions. In the context of Azure AI Search, an Azure function is the more likely scenario. An Azure function is commonly used for hosting the logic of a custom skill. Azure Function has Consumption, Premium, and Dedicated [App Service hosting plans](../app-service/overview-hosting-plans.md). The [App Service Environment (ASE)](../app-service/environment/overview.md) and [Azure Kubernetes Service (AKS)](../aks/intro-kubernetes.md) aren't supported at this time.
105109

106-
<sup>4</sup> See [Create a shared private link for a SQL Managed Instance](search-indexer-how-to-access-private-sql.md) for instructions.
110+
<sup>5</sup> See [Create a shared private link for a SQL Managed Instance](search-indexer-how-to-access-private-sql.md) for instructions.
107111

108-
<sup>5</sup> The `Microsoft.CognitiveServices/accounts` resource type is used for vectorizer and indexer connections to Azure OpenAI when implementing [integrated Vectorization](vector-search-integrated-vectorization.md). There's currently no support for shared private link to embedding models in the Azure AI Studio model catalog or to the Azure AI Vision multimodal API.
112+
<sup>6</sup> The `Microsoft.CognitiveServices/accounts` resource type is used for vectorizer and indexer connections to Azure OpenAI when implementing [integrated Vectorization](vector-search-integrated-vectorization.md). There's currently no support for shared private link to embedding models in the Azure AI Studio model catalog or to the Azure AI Vision multimodal API.
109113

110114
## 1 - Create a shared private link
111115

0 commit comments

Comments
 (0)