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

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

项目
04/10/2024

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

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

先决条件

在 Azure Cloud Shell 中使用 Bash 环境。有关详细信息，请参阅 Azure Cloud Shell 中的 Bash 快速入门。
如需在本地运行 CLI 参考命令，请安装 Azure CLI。如果在 Windows 或 macOS 上运行，请考虑在 Docker 容器中运行 Azure CLI。有关详细信息，请参阅如何在 Docker 容器中运行 Azure CLI。
- 如果使用的是本地安装，请使用 az login 命令登录到 Azure CLI。若要完成身份验证过程，请遵循终端中显示的步骤。有关其他登录选项，请参阅使用 Azure CLI 登录。
- 出现提示时，请在首次使用时安装 Azure CLI 扩展。有关扩展详细信息，请参阅使用 Azure CLI 的扩展。
- 运行 az version 以查找安装的版本和依赖库。若要升级到最新版本，请运行 az upgrade。

本快速入门需要 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" --location "EastUS"

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

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

目前，只有你的 Azure 帐户才有权对这个新保管库执行任何操作。

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

若要通过基于角色的访问控制 (RBAC) 授予用户账户对密钥保管库的权限，请使用 Azure CLI 命令 az role assignment create 分配角色。

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

将 <your-email-address>、<subscription-id>、<resource-group-name> 和 <your-unique-keyvault-name> 替换为你的实际值。 <your-email-address> 是你的登录名称。

向 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 以及如何将其与应用程序集成，请继续阅读以下文章。