Поиск зашифрованных объектов и информации

В Поиск с использованием ИИ Azure ключи шифрования, управляемые клиентом, создаются, хранятся и управляются в Azure Key Vault. Если необходимо определить, шифруется ли объект или какая версия ключа используется в Azure Key Vault, используйте REST API или Azure SDK для получения свойства encryptionKey из определения объекта в службе поиска.

Объекты, которые не шифруются с помощью ключа, управляемого клиентом, имеют пустое свойство encryptionKey . В противном случае вы можете увидеть определение, аналогичное примеру ниже.

"encryptionKey":{
   "keyVaultUri":"https://demokeyvault.vault.azure.net",
   "keyVaultKeyName":"myEncryptionKey",
   "keyVaultKeyVersion":"eaab6a663d59439ebb95ce2fe7d5f660",
   "accessCredentials":{
      "applicationId":"00001111-aaaa-2222-bbbb-3333cccc4444",
      "applicationSecret":"myApplicationSecret"
   }
}

Конструкция encryptionKey одинаковая для всех зашифрованных объектов. Это свойство первого уровня, которое находится на том же уровне, что и имя и описание объекта.

Разрешения для получения определений объектов

У вас должны быть разрешения участника службы поиска (Search Service Contributor) или эквивалентные разрешения. Чтобы использовать проверку подлинности на основе ключей, укажите ключ API администратора. Разрешения администратора требуются для запросов, возвращающих определения объектов и метаданные. Самый простой способ получить ключ API администратора — через портал Azure.

1. Перейдите в службу поиска на портале Azure.

2. В левой части выберите ключи и скопируйте API администратора.

Для выполнения остальных шагов перейдите на PowerShell и REST API. На портале Azure не отображаются сведения о ключе шифрования для любого объекта.

Получение свойств объекта

Чтобы настроить переменные и получить определения объектов, выполните указанные ниже команды с помощью PowerShell и REST.

Кроме того, можно использовать Azure SDK для .NET, Python, JavaScript и Java.

Сначала подключитесь к учетной записи Azure.

Connect-AzAccount

Если у вас несколько активных подписок в клиенте, укажите подписку, содержащую службу поиска:

 Set-AzContext -Subscription <your-subscription-ID>

Настройте заголовки, используемые для каждого запроса в текущем сеансе. Укажите ключ API администратора, используемый для проверки подлинности службы поиска.

$headers = @{
'api-key' = '<YOUR-ADMIN-API-KEY>'
'Content-Type' = 'application/json'
'Accept' = 'application/json' }

Чтобы вернуть список всех индексов поиска, задайте конечную точку коллекции индексов.

$uri= 'https://<YOUR-SEARCH-SERVICE>.search.windows.net/indexes?api-version=2026-04-01&$select=name'
Invoke-RestMethod -Uri $uri -Headers $headers | ConvertTo-Json

Чтобы вернуть определенное определение индекса, укажите его имя в пути. Свойство encryptionKey находится в конце.

$uri= 'https://<YOUR-SEARCH-SERVICE>.search.windows.net/indexes/<YOUR-INDEX-NAME>?api-version=2026-04-01'
Invoke-RestMethod -Uri $uri -Headers $headers | ConvertTo-Json

Чтобы вернуть карты синонимов, задайте конечную точку коллекции синонимов и отправьте запрос.

$uri= 'https://<YOUR-SEARCH-SERVICE>.search.windows.net/synonyms?api-version=2026-04-01&$select=name'
Invoke-RestMethod -Uri $uri -Headers $headers | ConvertTo-Json

В следующем примере возвращается определенное определение карты синонимов, в том числе свойство encryptionKey находится в конце определения.

$uri= 'https://<YOUR-SEARCH-SERVICE>.search.windows.net/synonyms/<YOUR-SYNONYM-MAP-NAME>?api-version=2026-04-01'
Invoke-RestMethod -Uri $uri -Headers $headers | ConvertTo-Json

Используйте тот же шаблон, чтобы вернуть свойство encryptionKey для других объектов верхнего уровня, таких как индексаторы, наборы навыков, источники данных и псевдонимы индексов.

Связанный контент

• Логирование Azure Key Vault
• Quickstart: задайте и извлеките секрет из Azure Key Vault с помощью PowerShell
• Настройка ключей, управляемых клиентом, для Поиск с использованием ИИ Azure зашифрованных данных