Titkosított objektumok és információk keresése

Az Azure AI Keresés az ügyfél által felügyelt titkosítási kulcsokat Azure Key Vault hozza létre, tárolja és kezeli. Ha meg kell határoznia, hogy egy objektum titkosítva van-e, vagy milyen kulcsnevet vagy verziót használ a Azure Key Vault, a REST API-val vagy egy Azure SDK lekérheti a encryptionKey tulajdonságot a keresési szolgáltatás objektumdefiníciójából.

Az ügyfél által felügyelt kulccsal nem titkosított objektumok üres encryptionKey tulajdonsággal rendelkeznek. Ellenkező esetben az alábbi példához hasonló definíció jelenhet meg.

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

A encryptionKey szerkezet minden titkosított objektum esetében ugyanaz. Ez egy első szintű tulajdonság, ugyanazon a szinten, mint az objektum neve és leírása.

Engedélyek az objektumdefiníciók lekéréséhez

Keressési szolgáltatás közreműködője vagy azzal egyenértékű engedélyekkel kell rendelkeznie. Kulcsalapú hitelesítés használatához adjon meg egy rendszergazdai API-kulcsot. Rendszergazdai engedélyekre van szükség az objektumdefiníciókat és metaadatokat visszaadandó kérelmekhez. A rendszergazdai API-kulcs lekérésének legegyszerűbb módja a Azure portálon keresztül.

1. Nyissa meg a keresőszolgáltatást a Azure portálon.

2. A bal oldalon válassza a Kulcsok lehetőséget , és másolja a rendszergazdai API-t.

A többi lépéshez váltson a PowerShellre és a REST API-ra. A Azure portál nem jeleníti meg az objektumok titkosítási kulcsának adatait.

Objektumtulajdonságok lekérése

A PowerShell és a REST használatával futtassa a következő parancsokat a változók beállításához és az objektumdefiníciók lekéréséhez.

Alternatívaként használhatja az Azure SDK-t .NET, Python, JavaScript és Java számára.

Először csatlakozzon Azure fiókjához.

Connect-AzAccount

Ha egynél több aktív előfizetéssel rendelkezik a bérlői környezetében, adja meg azt az előfizetést, amely tartalmazza a keresési szolgáltatást:

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

Állítsa be az aktuális munkamenet minden egyes kéréséhez használt fejléceket. Adja meg a keresési szolgáltatás hitelesítéséhez használt rendszergazdai API-kulcsot.

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

Az összes keresési index listájának visszaadásához állítsa a végpontot az indexek gyűjteményére.

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

Az adott indexdefiníció visszaadásához adja meg a nevét az útvonalban. A encryptionKey tulajdonság a végén található.

$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

Szinonimák leképezéseinek visszaadásához állítsa a végpontot a szinonimák gyűjteményére, majd küldje el a kérést.

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

Az alábbi példa egy adott szinonimatérkép-definíciót ad vissza, beleértve a encryptionKey tulajdonságot is a definíció vége felé.

$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

Ugyanezzel a mintával adja vissza a encryptionKey tulajdonságot más legfelső szintű objektumokhoz, például indexelőkhöz, képességkészletekhez, adatforrásokhoz és index aliasokhoz.

Kapcsolódó tartalom

• Azure Key Vault naplózás
• Gyorsindítás: Titok beállítása és lekérése az Azure Key Vaultból a PowerShell használatával
• Ügyfél által felügyelt kulcsok konfigurálása Azure AI Keresés titkosított adatokhoz