Keyvault Klass

Hanterar hemligheter som lagras i Azure Key Vault som är associerade med en Azure Machine Learning-arbetsyta.

Varje Azure Machine Learning-arbetsyta har en associerad Azure-Key Vault. Klassen Keyvault är en förenklad omslutning av Azure Key Vault som gör att du kan hantera hemligheter i nyckelvalvet, inklusive inställning, hämtning, borttagning och lista med hemligheter. Använd klassen Keyvault för att skicka hemligheter till fjärrkörningar på ett säkert sätt utan att exponera känslig information i klartext.

Mer information finns i Använda hemligheter i träningskörningar.

Class Keyvault-konstruktor.

Arv

builtins.object

Keyvault

Konstruktor

Keyvault(workspace)

Parametrar

workspace

Workspace

Obligatorisk

Azure Machine Learning-arbetsytan som är associerad med det här nyckelvalvet.

workspace

Workspace

Obligatorisk

Azure Machine Learning-arbetsytan som är associerad med det här nyckelvalvet.

Kommentarer

I skickade körningar på lokal och fjärransluten get_secret beräkning kan du använda metoden för Kör-instansen för att hämta det hemliga värdet från Key Vault. Om du vill hämta flera hemligheter använder du get_secrets metoden för Kör-instansen.

De här Körningsmetoderna ger dig en enkel genväg eftersom Run-instansen är medveten om dess arbetsyta och nyckelvalv och kan hämta hemligheten direkt utan att behöva instansiera arbetsytan och nyckelvalvet inom fjärrkörningen.

I följande exempel visas hur du kommer åt standardnyckelvalvet som är associerat med en arbetsyta och anger en hemlighet.

   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)

Fullständigt exempel är tillgängligt från https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/manage-azureml-service/authentication-in-azureml/authentication-in-azureml.ipynb

Metoder

delete_secret	Ta bort hemligheten med det angivna namnet.
delete_secrets	Ta bort en lista över hemligheter från Azure-Key Vault som är associerade med arbetsytan.
get_secret	Returnera det hemliga värdet för ett visst hemligt namn.
get_secret_content_type	Returnera hemlighetens innehållstyp för ett visst hemligt namn.
get_secrets	Returnera de hemliga värdena för en viss lista med hemliga namn.
list_secrets	Returnera listan med hemliga namn från Azure-Key Vault som är associerade med arbetsytan. Den här metoden returnerar inte de hemliga värdena.
set_secret	Lägg till en hemlighet i Azure-Key Vault som är associerad med arbetsytan.
set_secrets	Lägg till en ordlista med hemligheter i Azure-Key Vault som är associerad med arbetsytan.

delete_secret

Ta bort hemligheten med det angivna namnet.

delete_secret(name)

Parametrar

name

str

Obligatorisk

Namnet på hemligheten som ska tas bort.

Returtyp

None

delete_secrets

Ta bort en lista över hemligheter från Azure-Key Vault som är associerade med arbetsytan.

delete_secrets(secrets)

Parametrar

secrets_batch

list[str]

Obligatorisk

Listan över hemligheter som ska tas bort.

secrets

Obligatorisk

Returtyp

None

get_secret

Returnera det hemliga värdet för ett visst hemligt namn.

get_secret(name)

Parametrar

name

str

Obligatorisk

Det hemliga namn som värdet ska returneras för.

Returer

Det hemliga värdet för ett angivet hemligt namn.

Returtyp

str

get_secret_content_type

Returnera hemlighetens innehållstyp för ett visst hemligt namn.

get_secret_content_type(name)

Parametrar

name

str

Obligatorisk

Det hemliga namn som innehållstypen ska returneras för.

Returer

Den hemliga innehållstypen för ett angivet hemligt namn.

Returtyp

str

get_secrets

Returnera de hemliga värdena för en viss lista med hemliga namn.

get_secrets(secrets)

Parametrar

secrets

list[str]

Obligatorisk

Listan med hemliga namn att hämta värden för.

Returer

En ordlista över hittade och hittade inte hemligheter.

Returtyp

dict(<xref:str: str>)

list_secrets

Returnera listan med hemliga namn från Azure-Key Vault som är associerade med arbetsytan.

Den här metoden returnerar inte de hemliga värdena.

list_secrets()

Returer

En lista över ordlistor med hemliga namn med formatet {name : "secretName"}

Returtyp

dict(<xref:str:str>)

set_secret

Lägg till en hemlighet i Azure-Key Vault som är associerad med arbetsytan.

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

Parametrar

name

str

Obligatorisk

Namnet på hemligheten som ska läggas till.

value

<xref:azureml.core.azureml._restclient.models.KeyVaultContentType>

Obligatorisk

Värdet för hemligheten som ska läggas till.

value

Obligatorisk

Innehållstypen för hemligheten som ska läggas till.

content_type

standardvärde: KeyVaultContentType.not_provided

Returtyp

None

set_secrets

Lägg till en ordlista med hemligheter i Azure-Key Vault som är associerad med arbetsytan.

set_secrets(secrets_batch)

Parametrar

secrets_batch

dict(<xref:str:str>)

Obligatorisk

En ordlista med hemliga namn och värden att lägga till.

Returtyp

None