Menemukan objek dan informasi terenkripsi

Note

Pencarian Azure AI tersedia melalui portal Azure, REST API, dan Azure SDK. Ini juga mendukung Foundry IQ, lapisan pengetahuan terkelola yang mengubah konten perusahaan menjadi pangkalan pengetahuan yang dapat digunakan kembali dan sadar izin untuk agen di portal Microsoft Foundry.

Dalam Pencarian Azure AI, kunci enkripsi yang dikelola pelanggan dibuat, disimpan, dan dikelola dalam Azure Key Vault. Jika Anda perlu menentukan apakah objek dienkripsi, atau nama kunci atau versi apa yang digunakan dalam Azure Key Vault, gunakan REST API atau Azure SDK untuk mengambil properti encryptionKey dari definisi objek di layanan pencarian Anda.

Objek yang tidak dienkripsi dengan kunci yang dikelola pelanggan memiliki properti encryptionKey kosong. Jika tidak, Anda mungkin melihat definisi yang mirip dengan contoh berikut.

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

Konstruksi encryptionKey sama untuk semua objek terenkripsi. Ini adalah properti tingkat pertama, pada tingkat yang sama dengan nama objek dan deskripsi.

Izin untuk mengambil definisi objek

Anda harus memiliki Kontributor Layanan Pencarian atau izin yang setara. Untuk menggunakan autentikasi berbasis kunci, berikan kunci API admin. Izin admin diperlukan pada permintaan yang mengembalikan definisi objek dan metadata. Cara term mudah untuk mendapatkan kunci API admin adalah melalui portal Azure.

  1. Buka layanan pencarian Anda di portal Azure.

  2. Di sisi kiri, pilih Kunci dan salin API admin.

Untuk langkah-langkah berikutnya, beralihlah ke PowerShell dan REST API. Portal Azure tidak menampilkan informasi kunci enkripsi untuk objek apa pun.

Mengambil properti objek

Gunakan PowerShell dan REST untuk menjalankan perintah berikut untuk menyiapkan variabel dan mendapatkan definisi objek.

Atau, Anda juga dapat menggunakan Azure SDK untuk .NET, Python, JavaScript, dan Java.

Pertama, sambungkan ke akun Azure Anda.

Connect-AzAccount

Jika Anda memiliki lebih dari satu langganan aktif di penyewa Anda, tentukan langganan yang berisi layanan pencarian Anda:

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

Siapkan header yang digunakan pada setiap permintaan dalam sesi saat ini. Berikan kunci API admin yang digunakan untuk autentikasi layanan pencarian.

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

Untuk mengembalikan daftar semua indeks pencarian, atur titik akhir ke kumpulan indeks.

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

Untuk mengembalikan definisi indeks tertentu, berikan namanya dalam path. Properti encryptionKey ada di akhir.

$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

Untuk mengembalikan peta sinonim, atur titik akhir ke koleksi sinonim lalu kirim permintaan.

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

Contoh berikut mengembalikan definisi peta sinonim tertentu, termasuk properti encryptionKey yang terletak di bagian akhir definisi.

$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

Gunakan pola yang sama untuk mengembalikan properti encryptionKey untuk objek tingkat atas lainnya seperti pengindeks, set keterampilan, sumber data, dan alias indeks.

Konten terkait

  • Terakhir diperbarui pada