你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

快速入门:使用 Azure CLI 在 Azure Key Vault 中设置和检索机密

在本快速入门中,你将使用 Azure CLI 在 Azure Key Vault 中创建一个密钥保管库。 Azure Key Vault 是一项云服务,用作安全的机密存储。 可以安全地存储密钥、密码、证书和其他机密。 有关 Key Vault 的详细信息,可以参阅概述。 Azure CLI 用于通过命令或脚本创建和管理 Azure 资源。 完成该操作后,即可存储机密。

如果没有 Azure 订阅,请在开始之前创建一个 Azure 免费帐户

先决条件

本快速入门需要 Azure CLI 版本 2.0.4 或更高版本。 如果使用 Azure Cloud Shell,则最新版本已安装。

创建资源组

资源组是在其中部署和管理 Azure 资源的逻辑容器。 使用 az group create 命令在 eastus 位置创建一个名为 myResourceGroup 的资源组 。

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

创建密钥保管库

使用 Azure CLI az keyvault create 命令在上一步骤的资源组中创建 Key Vault。 需要提供某些信息:

  • Key Vault 名称:由 3 到 24 个字符构成的字符串,只能包含数字 (0-9)、字母(a-z、A-Z)和连字符 (-)

    重要

    每个密钥保管库必须具有唯一的名称。 在以下示例中,将 <your-unique-keyvault-name> 替换为密钥保管库的名称。

  • 资源组名称:myResourceGroup。

  • 位置:EastUS。

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

此命令的输出会显示新建的 Key Vault 的属性。 记下以下两个属性:

  • 保管库名称:为 --name 参数提供的名称。
  • 保管库 URI:在本示例中,保管库 URI 为 https://<密钥保管库唯一名称>.vault.azure.net/。 通过其 REST API 使用保管库的应用程序必须使用此 URI。

向用户帐户授予管理 Key Vault 中的机密的权限

若要通过基于角色的访问控制 (RBAC) 授予对密钥保管库的权限,请使用 Azure CLI 命令 az role assignment create 将角色分配给你的“用户主体名称”(UPN)。

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

将 <upn>、<subscription-id>、<resource-group-name> 和 <your-unique-keyvault-name> 替换为你的实际值。 你的 UPN 通常采用电子邮件地址格式(例如 username@domain.com)。

向 Key Vault 添加机密

只需再执行几个步骤即可向保管库添加机密。 此密码可供应用程序使用。 此密码将名为 ExamplePassword,将在其中存储的值为 hVFkk965BuUv

使用以下 Azure CLI az keyvault secret set 命令在密钥保管库中创建一个名为 ExamplePassword 的机密,该机密将存储值 hVFkk965BuUv

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

从 Key Vault 检索机密

现在,可以通过使用密码的 URI,引用已添加到 Azure Key Vault 的此密码。 使用 https://<your-unique-keyvault-name>.vault.azure.net/secrets/ExamplePassword 获取当前版本。

若要以纯文本格式查看机密中包含的值,请使用 Azure CLI az keyvault secret show 命令:

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

现在,你已创建 Key Vault 并存储和检索了机密。

清理资源

本系列中的其他快速入门和教程是在本快速入门的基础上制作的。 如果打算继续使用后续的快速入门和教程,则可能需要保留这些资源。

如果不再需要资源组和所有相关的资源,可以使用 Azure CLI az group delete 命令将其删除:

az group delete --name "myResourceGroup"

后续步骤

在本快速入门中,你创建了 Key Vault 并在其中存储了一个机密。 若要详细了解 Key Vault 以及如何将其与应用程序集成,请继续阅读以下文章。