Szybki start: konfigurowanie i pobieranie wpisów tajnych z usługi Azure Key Vault przy użyciu interfejsu wiersza polecenia platformy Azure

W tym przewodniku Szybki start utworzysz magazyn kluczy w usłudze Azure Key Vault interfejsie wiersza polecenia platformy Azure. Azure Key Vault to usługa w chmurze, która działa jako bezpieczny magazyn wpisów tajnych. Możesz bezpiecznie przechowywać klucze, hasła, certyfikaty oraz inne wpisy tajne. Aby uzyskać więcej informacji na Key Vault, zapoznaj się z tematem Omówienie. Interfejs wiersza polecenia platformy Azure służy do tworzenia zasobów platformy Azure i zarządzanie nimi za pomocą poleceń lub skryptów. a następnie umieszczanie w nim wpisu tajnego.

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem Utwórz bezpłatne konto .

Wymagania wstępne

  • Ten przewodnik Szybki start wymaga interfejsu wiersza polecenia platformy Azure w wersji 2.0.4 lub nowszej. Jeśli używasz Azure Cloud Shell, najnowsza wersja jest już zainstalowana.

Tworzenie grupy zasobów

Grupa zasobów to logiczny kontener przeznaczony do wdrażania zasobów platformy Azure i zarządzania nimi. Użyj polecenia AZ Group Create , aby utworzyć grupę zasobów o nazwie Moja zasobów w lokalizacji Wschodnie .

az group create --name "myResourceGroup" -l "EastUS"

Tworzenie magazynu kluczy

Użyj interfejsu wiersza polecenia platformy Azure AZ Resource Create , aby utworzyć Key Vault w grupie zasobów z poprzedniego kroku. Konieczne będzie podanie pewnych informacji:

  • Nazwa magazynu kluczy: ciąg od 3 do 24 znaków, który może zawierać tylko cyfry (0-9), litery (a-z, A-Z) i łączniki (-)

    Ważne

    Każdy Magazyn kluczy musi mieć unikatową nazwę. Zastąp nazwą magazynu klucza w poniższych przykładach.

  • Nazwa grupy zasobów: Grupa zasobów.

  • Lokalizacja: wschód.

az keyvault create --name "<your-unique-keyvault-name>" --resource-group "myResourceGroup" --location "EastUS"

Dane wyjściowe tego polecenia przedstawiają właściwości nowo utworzonego magazynu kluczy. Zanotuj dwie poniższe właściwości:

  • Nazwa magazynu: podana nazwa powyższego parametru--name.
  • Identyfikator URI magazynu: w tym przykładzie jest to https:// < — unikatowy — Nazwa magazynu kluczy > . Vault.Azure.NET/. Aplikacje korzystające z magazynu za pomocą jego interfejsu API REST muszą używać tego identyfikatora URI.

Twoje konto platformy Azure jest teraz jedynym kontem z uprawnieniami do wykonywania jakichkolwiek operacji na tym nowym magazynie.

Dodawanie wpisu tajnego do usługi Key Vault

Aby dodać wpis tajny do magazynu, wystarczy tylko wykonać kilka dodatkowych czynności. Tego hasła może używać aplikacja. Hasło będzie miało nazwę ExamplePassword i będzie w nim przechowywana wartość hVFkk965BuUv.

Użyj poniższego polecenia az keyvault secret set interfejsu wiersza polecenia platformy Azure, aby utworzyć w usłudze Key Vault klucz tajny o nazwie ExamplePassword, który będzie przechowywać wartość hVFkk965BuUv:

az keyvault secret set --vault-name "<your-unique-keyvault-name>" --name "ExamplePassword" --value "hVFkk965BuUv"

Pobieranie tajnego Key Vault

Teraz możesz odwoływać się do hasła dodanego do usługi Azure Key Vault za pomocą jego identyfikatora URI. Użyj adresu "https://.vault.azure.net/secrets/ExamplePassword", aby uzyskać bieżącą wersję.

Aby wyświetlić wartość zawartą we wpisie tajnym jako zwykły tekst:

az keyvault secret show --name "ExamplePassword" --vault-name "<your-unique-keyvault-name>" --query "value"

Utworzono usługę Key Vault, umieszczono w niej wpis tajny i pobrano go.

Czyszczenie zasobów

Inne przewodniki szybkiego startu i samouczki w tej kolekcji bazują na tym przewodniku. Jeśli planujesz korzystać z kolejnych przewodników Szybki start i samouczków, pozostaw te zasoby na swoim miejscu.

Gdy grupa zasobów i wszystkie pokrewne zasoby nie będą już potrzebne, można je usunąć za pomocą interfejsu wiersza polecenia platformy Azure AZ Group Delete .

az group delete --name "myResourceGroup"

Następne kroki

W tym przewodniku Szybki start utworzono Key Vault przechowywany w nim klucz tajny. Aby dowiedzieć się więcej Key Vault o tym, jak zintegrować ją z aplikacjami, przejdź do poniższych artykułów.