Compartir a través de

如何使用资源管理器模板创建 Azure 密钥保管库

Azure Key Vault 是一项云服务,它为密钥、密码和证书等机密提供了安全的存储。 本文介绍了部署 Azure 资源管理器模板(ARM 模板)以创建密钥保管库的过程。

重要

Azure RBAC 是 Azure Key Vault 的建议授权模型。 有关详细信息,请参阅 适用于 Key Vault 的 Azure RBAC。 旧访问策略模型具有已知的安全漏洞,不应用于新部署。

Azure 资源管理器模板是定义项目基础结构和配置的 JavaScript 对象表示法 (JSON) 文件。 模板使用声明性语法。 你可以在不编写用于创建部署的编程命令序列的情况下,描述预期部署。

先决条件

完成本文中的步骤:

  • 如果没有 Azure 订阅,请在开始前创建一个试用版订阅

创建 Key Vault 资源管理器模板

以下模板显示了创建密钥保管库的基本方式。 某些值在模板中指定。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "keyVaultName": {
      "type": "string",
      "metadata": {
        "description": "Specifies the name of the key vault."
      }
    },
    "skuName": {
      "type": "string",
      "defaultValue": "Standard",
      "allowedValues": [
        "Standard",
        "Premium"
      ],
      "metadata": {
        "description": "Specifies whether the key vault is a standard vault or a premium vault."
      }
    }
   },
  "resources": [
    {
      "type": "Microsoft.KeyVault/vaults",
      "apiVersion": "2023-07-01",
      "name": "[parameters('keyVaultName')]",
      "location": "[resourceGroup().location]",
      "properties": {
        "enabledForDeployment": false,
        "enabledForDiskEncryption": false,
        "enabledForTemplateDeployment": false,
        "tenantId": "[subscription().tenantId]",
        "enableRbacAuthorization": true,
        "enableSoftDelete": true,
        "softDeleteRetentionInDays": 90,
        "enablePurgeProtection": true,
        "sku": {
          "name": "[parameters('skuName')]",
          "family": "A"
        },
        "networkAcls": {
          "defaultAction": "Deny",
          "bypass": "AzureServices"
        }
      }
    }
  ]
}

有关 Key Vault 模板设置的详细信息,请参阅 Key Vault ARM 模板参考

注释

此模板使用 Azure RBAC 进行授权,这是建议的方法。 若要授予对 Key Vault 数据的访问权限,请将 Azure RBAC 角色(例如 Key Vault 机密官或 Key Vault 加密官员)分配给用户、组或服务主体。 有关详细信息,请参阅 适用于 Key Vault 的 Azure RBAC

如果需要改用旧访问策略,请参阅 “分配 Key Vault 访问策略”。 请注意,旧访问策略模型存在已知的安全漏洞,并且缺少对 Privileged Identity Management (PIM)的支持。

更多 Key Vault 资源管理器模板

还有其他资源管理器模板可用于 Key Vault 对象:

机密 证书
空值 空值

可在以下文章中找到更多 Key Vault 模板:Key Vault 资源管理器参考

部署模板

可以使用 Azure 门户来部署上述模板,方法是按下面所述使用“在编辑器中生成自己的模板”选项:从自定义模板部署资源

还可以将上述模板保存到文件,并使用以下命令:New-AzResourceGroupDeploymentaz deployment group create

New-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -TemplateFile key-vault-template.json
az deployment group create --resource-group ExampleGroup --template-file key-vault-template.json

清理资源

如果打算继续使用后续的快速入门和教程,则可以将这些资源保留在原处。 当不再需要资源时,请删除资源组。 如果删除该组,则也会删除密钥保管库和相关资源。 若要使用 Azure CLI 或 Azure PowerShell 删除资源组,请完成以下步骤:

echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."

资源

后续步骤