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

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

如果没有 Azure 订阅,可在开始前创建一个试用帐户

先决条件

  • 如果需要,请安装 Azure CLI 来运行 CLI 参考命令。

    • 如果使用的是本地安装,请使用 az login 命令登录到 Azure CLI。 若要完成身份验证过程,请遵循终端中显示的步骤。 有关其他登录选项,请参阅登录 Azure CLI

    • 出现提示时,请在首次使用时安装 Azure CLI 扩展。 有关扩展详细信息,请参阅使用 Azure CLI 的扩展

    • 运行 az version 以查找安装的版本和依赖库。 若要升级到最新版本,请运行 az upgrade

  • 本快速入门需要 Azure CLI 版本 2.0.4 或更高版本。

创建资源组

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

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

创建密钥保管库

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

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

    重要

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

  • 资源组名称:myResourceGroup。

  • 位置:ChinaNorth。

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

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

  • 保管库名称:为上面的 --name 参数提供的名称。
  • 保管库 URI:在本示例中为 https://<your-unique-keyvault-name>.vault.azure.cn/。 通过其 REST API 使用保管库的应用程序必须使用此 URI。

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

向 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://.vault.azure.cn/secrets/ExamplePassword”来获取当前版本。

若要查看机密中包含的纯文本形式的值,请执行以下命令:

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