Keyvault Kelas

Mengelola rahasia yang disimpan di Azure Key Vault yang terkait dengan ruang kerja Azure Machine Learning.

Setiap ruang kerja Azure Machine Learning memiliki Azure Key Vault terkait. Kelas Keyvault adalah wrapper Azure Key Vault yang disederhanakan yang memungkinkan Anda mengelola rahasia di brankas kunci termasuk pengaturan, pengambilan, penghapusan, dan daftar rahasia. Gunakan kelas Keyvault untuk meneruskan rahasia ke eksekusi jarak jauh dengan aman tanpa mengekspos informasi sensitif dalam teksbersih.

Untuk informasi selengkapnya, lihat Menggunakan rahasia dalam eksekusi pelatihan.

Konstruktor Keyvault Kelas.

Warisan

builtins.object

Keyvault

Konstruktor

Keyvault(workspace)

Parameter

Nama	Deskripsi
workspace Diperlukan	Workspace Ruang Kerja Azure Machine Learning yang terkait dengan brankas kunci ini.
workspace Diperlukan	Workspace Ruang Kerja Azure Machine Learning yang terkait dengan brankas kunci ini.

Keterangan

Dalam eksekusi yang dikirimkan pada komputasi lokal dan jarak jauh, Anda dapat menggunakan metode get_secret dari instans Eksekusi untuk mendapatkan nilai rahasia dari Key Vault. Untuk mendapatkan beberapa rahasia, gunakan metode get_secrets instans Eksekusi.

Metode Eksekusi ini memberi Anda pintasan sederhana karena instans Eksekusi mengetahui Ruang kerja dan Keyvault-nya, dan bisa langsung mendapatkan rahasianya tanpa perlu membuat instans Ruang kerja dan Keyvault dalam eksekusi jarak jauh.

Contoh berikut menunjukkan cara mengakses brankas kunci default yang terkait dengan ruang kerja dan mengatur rahasia.

   import uuid

   local_secret = os.environ.get("LOCAL_SECRET", default = str(uuid.uuid4())) # Use random UUID as a substitute for real secret.
   keyvault = ws.get_default_keyvault()
   keyvault.set_secret(name="secret-name", value = local_secret)

Sampel lengkap tersedia dari https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/manage-azureml-service/authentication-in-azureml/authentication-in-azureml.ipynb

Metode

delete_secret	Hapus rahasia dengan nama yang ditentukan.
delete_secrets	Hapus daftar rahasia dari Azure Key Vault yang terkait dengan ruang kerja.
get_secret	Kembalikan nilai rahasia untuk nama rahasia yang diberikan.
get_secret_content_type	Mengembalikan jenis konten rahasia untuk nama rahasia tertentu.
get_secrets	Kembalikan nilai rahasia untuk daftar nama rahasia yang diberikan.
list_secrets	Kembalikan daftar nama rahasia dari Azure Key Vault yang terkait dengan ruang kerja. Metode ini tidak mengembalikan nilai rahasia.
set_secret	Tambahkan rahasia ke Azure Key Vault yang terkait dengan ruang kerja.
set_secrets	Tambahkan kamus rahasia ke Azure Key Vault yang terkait dengan ruang kerja.

delete_secret

Hapus rahasia dengan nama yang ditentukan.

delete_secret(name)

Parameter

Nama	Deskripsi
name Diperlukan	str Nama rahasia yang akan dihapus.

Mengembalikan

Jenis	Deskripsi
None

delete_secrets

Hapus daftar rahasia dari Azure Key Vault yang terkait dengan ruang kerja.

delete_secrets(secrets)

Parameter

Nama	Deskripsi
secrets_batch Diperlukan	list[str] Daftar rahasia yang akan dihapus.
secrets Diperlukan

Mengembalikan

Jenis	Deskripsi
None

get_secret

Kembalikan nilai rahasia untuk nama rahasia yang diberikan.

get_secret(name)

Parameter

Nama	Deskripsi
name Diperlukan	str Nama rahasia yang nilainya dikembalikan.

Mengembalikan

Jenis	Deskripsi
str	Nilai rahasia untuk nama rahasia yang ditentukan.

get_secret_content_type

Mengembalikan jenis konten rahasia untuk nama rahasia tertentu.

get_secret_content_type(name)

Parameter

Nama	Deskripsi
name Diperlukan	str Nama rahasia untuk mengembalikan tipe konten.

Mengembalikan

Jenis	Deskripsi
str	Jenis konten rahasia untuk nama rahasia tertentu.

get_secrets

Kembalikan nilai rahasia untuk daftar nama rahasia yang diberikan.

get_secrets(secrets)

Parameter

Nama	Deskripsi
secrets Diperlukan	list[str] Daftar nama rahasia yang nilainya diambil.

Mengembalikan

Jenis	Deskripsi
dict(str: str)	Kamus berisi rahasia yang ditemukan dan tidak.

list_secrets

Kembalikan daftar nama rahasia dari Azure Key Vault yang terkait dengan ruang kerja.

Metode ini tidak mengembalikan nilai rahasia.

list_secrets()

Mengembalikan

Jenis	Deskripsi
dict(str:str)	Daftar kamus nama rahasia dengan format {nama : "secretName"}

set_secret

Tambahkan rahasia ke Azure Key Vault yang terkait dengan ruang kerja.

set_secret(name, value, content_type=KeyVaultContentType.not_provided)

Parameter

Nama	Deskripsi
name Diperlukan	str Nama rahasia yang akan ditambahkan.
value Diperlukan	<xref:azureml.core.azureml._restclient.models.KeyVaultContentType> Nilai rahasia yang akan ditambahkan.
value Diperlukan	Jenis konten rahasia yang akan ditambahkan.
content_type	Nilai default: KeyVaultContentType.not_provided

Mengembalikan

Jenis	Deskripsi
None

set_secrets

Tambahkan kamus rahasia ke Azure Key Vault yang terkait dengan ruang kerja.

set_secrets(secrets_batch)

Parameter

Nama	Deskripsi
secrets_batch Diperlukan	dict(<xref:str:str>) Kamus nama dan nilai rahasia yang akan ditambahkan.

Mengembalikan

Jenis	Deskripsi
None