快速入门:使用 Azure CLI 在 Azure Key Vault 中设置和检索密钥
在本快速入门中,你将使用 Azure CLI 在 Azure Key Vault 中创建一个密钥保管库。 Azure Key Vault 是一项云服务,用作安全的机密存储。 可以安全地存储密钥、密码、证书和其他机密。 有关 Key Vault 的详细信息,可以参阅概述。 Azure CLI 用于通过命令或脚本创建和管理 Azure 资源。 完成该操作后,你将存储密钥。
如果没有 Azure 订阅,可在开始前创建一个试用帐户。
- 本快速入门需要 Azure CLI 版本 2.0.4 或更高版本。
创建资源组
资源组是在其中部署和管理 Azure 资源的逻辑容器。 使用 az group create 命令在 chinaeast 位置创建一个名为“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 添加密钥
只需再执行几个步骤便可向保管库中添加密钥。 此密钥可供应用程序使用。
键入以下命令,创建名为 ExampleKey 的密钥:
az keyvault key create --vault-name "<your-unique-keyvault-name>" -n ExampleKey --protection software
现在,可以通过 URI 来引用已添加到 Azure Key Vault 的此密钥。 使用 https://<your-unique-keyvault-name>.vault.azure.cn/keys/ExampleKey
获取当前版本。
若要查看以前存储的密钥,请使用以下命令:
az keyvault key show --name "ExampleKey" --vault-name "<your-unique-keyvault-name>"
现在,你已创建了一个 Key Vault,存储了一个密钥并检索了该密钥。
清理资源
本系列中的其他快速入门和教程是在本快速入门的基础上制作的。 如果打算继续使用后续的快速入门和教程,则可能需要保留这些资源。
如果不再需要资源组和所有相关的资源,可以使用 Azure CLI az group delete 命令将其删除:
az group delete --name "myResourceGroup"
后续步骤
在本快速入门中,你创建了一个密钥保管库并在其中存储了一个密钥。 若要详细了解 Key Vault 以及如何将其与应用程序集成,请继续阅读以下文章。
- 阅读 Azure Key Vault 概述
- 请参阅 Azure CLI az keyvault 命令参考
- 请参阅 Key Vault 安全性概述