Share via

Quickstart: Een sleutel instellen en ophalen uit Azure Key Vault met behulp van Azure CLI

  • Artikel

In deze quickstart maakt u een sleutelkluis in Azure Key Vault met behulp van de Azure CLI. Azure Key Vault is een cloudservice die werkt als een beveiligd geheimenarchief. U kunt veilig sleutels, wachtwoorden, certificaten en andere geheime informatie opslaan. Raadpleeg het Overzicht voor meer informatie over Key Vault. Azure CLI wordt gebruikt voor het maken en beheren van Azure-resources met behulp van opdrachten of scripts. Zodra u dat hebt voltooid, slaat u een sleutel op.

Als u geen Azure-abonnement hebt, kunt u een gratis Azure-account maken voordat u begint.

Vereisten

  • Voor deze quickstart is versie 2.0.4 of hoger van Azure CLI vereist. Als u Azure Cloud Shell gebruikt, is de nieuwste versie al geïnstalleerd.

Een brongroep maken

Een resourcegroep is een logische container waarin Azure-resources worden geïmplementeerd en beheerd. Gebruik de opdracht az group create om een resourcegroep met de naam myResourceGroup te maken op de locatie eastus.

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

Maak een sleutelkluis.

Gebruik de azure CLI az keyvault create command om een Key Vault te maken in de resourcegroep uit de vorige stap. U moet enkele gegevens verstrekken:

  • Sleutelkluisnaam: een tekenreeks van 3 tot 24 tekens die alleen cijfers (0-9), letters (a-z, A-Z) en afbreekstreepjes (-) mogen bevatten

    Belangrijk

    Elke sleutelkluis moet een unieke naam hebben. Vervang <uw unieke sleutelkluisnaam> door de naam van uw sleutelkluis in de volgende voorbeelden.

  • Naam van resourcegroep: myResourceGroup.

  • De locatie: EastUS.

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

In de uitvoer van deze opdracht ziet u eigenschappen van de zojuist gemaakte sleutelkluis. Noteer deze twee eigenschappen:

  • Kluisnaam: de naam die u hebt opgegeven voor de --name parameter.
  • Kluis-URI: In dit voorbeeld is de kluis-URI https://< your-unique-keyvault-name.vault.azure.net/>. Toepassingen die via de REST API gebruikmaken van uw kluis, moeten deze URI gebruiken.

Geef uw gebruikersaccount machtigingen voor het beheren van geheimen in Key Vault

Als u machtigingen wilt verkrijgen voor uw sleutelkluis via op rollen gebaseerd toegangsbeheer (RBAC), wijst u een rol toe aan uw UPN (User Principal Name) met behulp van de Azure CLI-opdracht az role assignment create.

az role assignment create --role "Key Vault Crypto Officer" --assignee "<upn>" --scope "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.KeyVault/vaults/<your-unique-keyvault-name>"

Vervang <upn>, <subscription-id>, <resource-group-name> en <your-unique-keyvault-name> door uw werkelijke waarden. Uw UPN heeft doorgaans de indeling van een e-mailadres (bijvoorbeeld username@domain.com).

Een sleutel toevoegen aan Key Vault

Als u een sleutel wilt toevoegen aan de kluis, hoeft u maar een paar extra stappen uit te voeren. Deze sleutel zou kunnen worden gebruikt door een toepassing.

Typ deze opdracht om een sleutel met de naam ExampleKey te maken:

az keyvault key create --vault-name "<your-unique-keyvault-name>" -n ExampleKey --protection software

U kunt nu naar deze sleutel die u aan Azure Key Vault hebt toegevoegd, verwijzen met behulp van de URI ervan. Gebruik https://<your-unique-keyvault-name>.vault.azure.net/keys/ExampleKey om de huidige versie op te halen.

Een eerder opgeslagen sleutel weergeven:


az keyvault key show --name "ExampleKey" --vault-name "<your-unique-keyvault-name>"

U hebt nu een sleutelkluis gemaakt, een sleutel opgeslagen en opgehaald.

Resources opschonen

Andere snelstartgidsen en zelfstudies in deze verzameling zijn gebaseerd op deze snelstartgids. Als u van plan bent om verder te gaan met volgende snelstarts en zelfstudies, kunt u deze resources intact laten.

U kunt de opdracht az group delete van Azure CLI gebruiken om de resourcegroep en alle gerelateerde resources te verwijderen wanneer u deze niet meer nodig hebt.

az group delete --name "myResourceGroup"

Volgende stappen

In deze snelstart hebt u een sleutelkluis gemaakt en daar een sleutel in opgeslagen. Ga verder met deze artikelen voor meer informatie over Key Vault en hoe u deze integreert met uw toepassingen.