Cofres/chaves Microsoft.KeyVault

Definição de recurso do Bicep

O tipo de recurso cofres/chaves pode ser implementado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.

Observações

Para obter orientações sobre como utilizar cofres de chaves para valores seguros, veja Gerir segredos com o Bicep.

Para obter um início rápido sobre a criação de um segredo, veja Início Rápido: Definir e obter um segredo do Azure Key Vault através de um modelo do ARM.

Para obter um início rápido sobre a criação de uma chave, veja Início Rápido: Criar um cofre de chaves do Azure e uma chave com o modelo do ARM.

Formato do recurso

Para criar um recurso Microsoft.KeyVault/vaults/keys, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.KeyVault/vaults/keys@2023-07-01' = {
  name: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    attributes: {
      enabled: bool
      exp: int
      exportable: bool
      nbf: int
    }
    curveName: 'string'
    keyOps: [
      'string'
    ]
    keySize: int
    kty: 'string'
    release_policy: {
      contentType: 'string'
      data: 'string'
    }
    rotationPolicy: {
      attributes: {
        expiryTime: 'string'
      }
      lifetimeActions: [
        {
          action: {
            type: 'string'
          }
          trigger: {
            timeAfterCreate: 'string'
            timeBeforeExpiry: 'string'
          }
        }
      ]
    }
  }
}

Valores de propriedade

cofres/chaves

Nome Descrição Valor
name O nome do recurso

Veja como definir nomes e tipos para recursos subordinados no Bicep.
cadeia (obrigatório)
etiquetas As etiquetas que serão atribuídas à chave. Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
principal No Bicep, pode especificar o recurso principal de um recurso subordinado. Só precisa de adicionar esta propriedade quando o recurso subordinado for declarado fora do recurso principal.

Para obter mais informações, veja Recurso subordinado fora do recurso principal.
Nome simbólico para recurso do tipo: cofres
propriedades As propriedades da chave a criar. KeyProperties (obrigatório)

KeyProperties

Nome Descrição Valor
atributos Os atributos da chave. KeyAttributes
curveName O nome da curva elíptica. Para valores válidos, veja JsonWebKeyCurveName. "P-256"
"P-256K"
"P-384"
"P-521"
keyOps Matriz de cadeias que contém qualquer um dos seguintes:
"desencriptar"
"encriptar"
"importar"
'release'
"sinal"
'unwrapKey'
"verificar"
'wrapKey'
keySize O tamanho da chave em bits. Por exemplo: 2048, 3072 ou 4096 para RSA. int
kty O tipo da chave. Para valores válidos, veja JsonWebKeyType. "CE"
"EC-HSM"
"RSA"
"RSA-HSM"
release_policy Política de lançamento de chaves em resposta. Será utilizado para saída e entrada. Omitido se estiver vazio KeyReleasePolicy
rotationPolicy Política de rotação de chaves em resposta. Será utilizado para saída e entrada. Omitido se estiver vazio RotationPolicy

KeyAttributes

Nome Descrição Valor
ativado Determina se o objeto está ou não ativado. bool
exp Data de expiração em segundos desde 1970-01-01T00:00:00Z. int
exportável Indica se a chave privada pode ser exportada. bool
nbf Não antes da data em segundos desde 1970-01-01T00:00:00Z. int

KeyReleasePolicy

Nome Descrição Valor
contentType Tipo de conteúdo e versão da política de lançamento de chaves string
dados Codificar blobs com as regras de política nas quais a chave pode ser lançada. string

RotationPolicy

Nome Descrição Valor
atributos Os atributos da política de rotação de chaves. KeyRotationPolicyAttributes
lifetimeActions A lifetimeActions para a ação de rotação de chaves. LifetimeAction[]

KeyRotationPolicyAttributes

Nome Descrição Valor
expiryTime O tempo de expiração da nova versão da chave. Deve estar no formato ISO8601. Por exemplo: "P90D", "P1Y". string

LifetimeAction

Nome Descrição Valor
action A ação de lifetimeAction da política de rotação de chaves. Ação
acionador O acionador da duração da política de rotação de chavesAction. Acionador

Ação

Nome Descrição Valor
tipo O tipo de ação. "notificar"
'rodar'

Acionador

Nome Descrição Valor
timeAfterCreate A duração do tempo após a criação da chave para rodar a chave. Aplica-se apenas à rotação. Estará no formato de duração ISO 8601. Por exemplo: "P90D", "P1Y". string
timeBeforeExpiry A duração do tempo antes de a chave expirar para rodar ou notificar. Estará no formato de duração ISO 8601. Por exemplo: "P90D", "P1Y". string

Modelos de início rápido

Os seguintes modelos de início rápido implementam este tipo de recurso.

Modelo Description
Criar uma Chave no Azure KeyVault

Implementar no Azure
Este módulo permite-lhe criar uma chave num KeyVault existente.
Encriptação de Conta de Armazenamento do Azure com chave gerida pelo cliente

Implementar no Azure
Este modelo implementa uma Conta de Armazenamento com uma chave gerida pelo cliente para encriptação gerada e colocada dentro de um Key Vault.

Definição de recurso de modelo do ARM

O tipo de recurso cofres/chaves pode ser implementado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.

Observações

Para obter orientações sobre como utilizar cofres de chaves para valores seguros, veja Gerir segredos com o Bicep.

Para obter um início rápido sobre a criação de um segredo, veja Início Rápido: Definir e obter um segredo do Azure Key Vault através de um modelo do ARM.

Para obter um início rápido sobre a criação de uma chave, veja Início Rápido: Criar um cofre de chaves do Azure e uma chave com o modelo do ARM.

Formato do recurso

Para criar um recurso Microsoft.KeyVault/vaults/keys, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.KeyVault/vaults/keys",
  "apiVersion": "2023-07-01",
  "name": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "attributes": {
      "enabled": "bool",
      "exp": "int",
      "exportable": "bool",
      "nbf": "int"
    },
    "curveName": "string",
    "keyOps": [ "string" ],
    "keySize": "int",
    "kty": "string",
    "release_policy": {
      "contentType": "string",
      "data": "string"
    },
    "rotationPolicy": {
      "attributes": {
        "expiryTime": "string"
      },
      "lifetimeActions": [
        {
          "action": {
            "type": "string"
          },
          "trigger": {
            "timeAfterCreate": "string",
            "timeBeforeExpiry": "string"
          }
        }
      ]
    }
  }
}

Valores de propriedade

cofres/chaves

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.KeyVault/vaults/keys"
apiVersion A versão da API de recursos '2023-07-01'
name O nome do recurso

Veja como definir nomes e tipos para recursos subordinados em modelos do ARM JSON.
cadeia (obrigatório)
etiquetas As etiquetas que serão atribuídas à chave. Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
propriedades As propriedades da chave a criar. KeyProperties (obrigatório)

KeyProperties

Nome Descrição Valor
atributos Os atributos da chave. KeyAttributes
curveName O nome da curva elíptica. Para valores válidos, veja JsonWebKeyCurveName. "P-256"
"P-256K"
"P-384"
"P-521"
keyOps Matriz de cadeias que contém qualquer um dos seguintes:
"desencriptar"
"encriptar"
"importar"
'release'
"sinal"
'unwrapKey'
"verificar"
'wrapKey'
keySize O tamanho da chave em bits. Por exemplo: 2048, 3072 ou 4096 para RSA. int
kty O tipo da chave. Para valores válidos, veja JsonWebKeyType. "CE"
"EC-HSM"
"RSA"
"RSA-HSM"
release_policy Política de lançamento de chaves em resposta. Será utilizado para saída e entrada. Omitido se estiver vazio KeyReleasePolicy
rotationPolicy Política de rotação de chaves em resposta. Será utilizado para saída e entrada. Omitido se estiver vazio RotationPolicy

KeyAttributes

Nome Descrição Valor
ativado Determina se o objeto está ou não ativado. bool
exp Data de expiração em segundos desde 1970-01-01T00:00:00Z. int
exportável Indica se a chave privada pode ser exportada. bool
nbf Não antes da data em segundos desde 1970-01-01T00:00:00Z. int

KeyReleasePolicy

Nome Descrição Valor
contentType Tipo de conteúdo e versão da política de lançamento de chaves string
dados Codificar blobs com as regras de política nas quais a chave pode ser lançada. string

RotationPolicy

Nome Descrição Valor
atributos Os atributos da política de rotação de chaves. KeyRotationPolicyAttributes
lifetimeActions A lifetimeActions para a ação de rotação de chaves. LifetimeAction[]

KeyRotationPolicyAttributes

Nome Descrição Valor
expiryTime O tempo de expiração da nova versão da chave. Deve estar no formato ISO8601. Por exemplo: "P90D", "P1Y". string

LifetimeAction

Nome Descrição Valor
action A ação de lifetimeAction da política de rotação de chaves. Ação
acionador O acionador de lifetimeAction da política de rotação de chaves. Acionador

Ação

Nome Descrição Valor
tipo O tipo de ação. "notificar"
"rodar"

Acionador

Nome Descrição Valor
timeAfterCreate A duração do tempo após a criação da chave para rodar a chave. Aplica-se apenas à rotação. Estará no formato de duração ISO 8601. Por exemplo: "P90D", "P1Y". string
timeBeforeExpiry A duração do tempo antes de a chave expirar para rodar ou notificar. Estará no formato de duração ISO 8601. Por exemplo: "P90D", "P1Y". string

Modelos de início rápido

Os seguintes modelos de início rápido implementam este tipo de recurso.

Modelo Description
Criar uma Chave no Azure KeyVault

Implementar no Azure
Este módulo permite-lhe criar uma chave num KeyVault existente.
Encriptação da Conta de Armazenamento do Azure com chave gerida pelo cliente

Implementar no Azure
Este modelo implementa uma Conta de Armazenamento com uma chave gerida pelo cliente para encriptação gerada e colocada dentro de um Key Vault.

Definição de recurso terraform (fornecedor AzAPI)

O tipo de recurso cofres/chaves pode ser implementado com operações que visam:

  • Grupos de recursos

Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.KeyVault/vaults/keys, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.KeyVault/vaults/keys@2023-07-01"
  name = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      attributes = {
        enabled = bool
        exp = int
        exportable = bool
        nbf = int
      }
      curveName = "string"
      keyOps = [
        "string"
      ]
      keySize = int
      kty = "string"
      release_policy = {
        contentType = "string"
        data = "string"
      }
      rotationPolicy = {
        attributes = {
          expiryTime = "string"
        }
        lifetimeActions = [
          {
            action = {
              type = "string"
            }
            trigger = {
              timeAfterCreate = "string"
              timeBeforeExpiry = "string"
            }
          }
        ]
      }
    }
  })
}

Valores de propriedade

cofres/chaves

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.KeyVault/vaults/keys@2023-07-01"
name O nome do recurso cadeia (obrigatório)
parent_id O ID do recurso que é o principal para este recurso. ID do recurso do tipo: cofres
etiquetas As etiquetas que serão atribuídas à chave. Dicionário de nomes e valores de etiquetas.
propriedades As propriedades da chave a criar. KeyProperties (obrigatório)

KeyProperties

Nome Descrição Valor
atributos Os atributos da chave. KeyAttributes
curveName O nome da curva elíptica. Para obter valores válidos, veja JsonWebKeyCurveName. "P-256"
"P-256K"
"P-384"
"P-521"
keyOps Matriz de cadeia que contém qualquer um dos seguintes:
"desencriptar"
"encriptar"
"importar"
"release"
"sinal"
"unwrapKey"
"verificar"
"wrapKey"
keySize O tamanho da chave em bits. Por exemplo: 2048, 3072 ou 4096 para RSA. int
kty O tipo da chave. Para obter valores válidos, veja JsonWebKeyType. "EC"
"EC-HSM"
"RSA"
"RSA-HSM"
release_policy Política de lançamento chave em resposta. Será utilizado para saída e entrada. Omitido se estiver vazio KeyReleasePolicy
rotationPolicy Política de rotação de chaves em resposta. Será utilizado para saída e entrada. Omitido se estiver vazio RotationPolicy

KeyAttributes

Nome Descrição Valor
ativado Determina se o objeto está ou não ativado. bool
exp Data de expiração em segundos desde 1970-01-01T00:00:00Z. int
exportável Indica se a chave privada pode ser exportada. bool
nbf Não antes da data em segundos desde 1970-01-01T00:00:00Z. int

KeyReleasePolicy

Nome Descrição Valor
contentType Tipo de conteúdo e versão da política de lançamento de chaves string
dados Codificar blobs com as regras de política sob as quais a chave pode ser libertada. string

RotationPolicy

Nome Descrição Valor
atributos Os atributos da política de rotação de chaves. KeyRotationPolicyAttributes
lifetimeActions As lifetimeActions para a ação de rotação de chaves. LifetimeAction[]

KeyRotationPolicyAttributes

Nome Descrição Valor
expiryTime O tempo de expiração da nova versão da chave. Deve estar no formato ISO8601. Por exemplo: "P90D", "P1Y". string

LifetimeAction

Nome Descrição Valor
action A ação de lifetimeAction da política de rotação de chaves. Ação
acionador O acionador de lifetimeAction da política de rotação de chaves. Acionador

Ação

Nome Descrição Valor
tipo O tipo de ação. "notificar"
"rodar"

Acionador

Nome Descrição Valor
timeAfterCreate A duração do tempo após a criação da chave para rodar a chave. Aplica-se apenas à rotação. Estará no formato de duração ISO 8601. Por exemplo: "P90D", "P1Y". string
timeBeforeExpiry A duração do tempo antes de a chave expirar para rodar ou notificar. Estará no formato de duração ISO 8601. Por exemplo: "P90D", "P1Y". string