Compartir a través de


Almacenes de Microsoft.KeyVault/keys 2021-10-01

Definición de recursos de Bicep

El tipo de recurso vaults/keys se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Comentarios

Para obtener instrucciones sobre el uso de almacenes de claves para valores seguros, consulte Administración de secretos mediante Bicep.

Para ver un inicio rápido sobre cómo crear un secreto, consulte Inicio rápido: Establecimiento y recuperación de un secreto de Azure Key Vault mediante una plantilla de ARM.

Para ver un inicio rápido sobre cómo crear una clave, consulte Inicio rápido: Creación de un almacén de claves de Azure y una clave mediante una plantilla de ARM.

Formato de los recursos

Para crear un recurso Microsoft.KeyVault/vaults/keys, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.KeyVault/vaults/keys@2021-10-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'
  }
}

Valores de propiedad

vaults/keys

Nombre Descripción Value
name El nombre del recurso

Vea cómo establecer nombres y tipos para recursos secundarios en Bicep.
string (obligatorio)
etiquetas Etiquetas que se asignarán a la clave. Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
primario En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para más información, consulte Recurso secundario fuera del recurso primario.
Nombre simbólico del recurso de tipo: almacenes
properties Propiedades de la clave que se va a crear. KeyProperties (obligatorio)

KeyProperties

Nombre Descripción Valor
attributes Atributos de la clave. KeyAttributes
curveName Nombre de la curva elíptica. Para obtener valores válidos, consulte JsonWebKeyCurveName. 'P-256'
'P-256K'
'P-384'
'P-521'
keyOps Matriz de cadenas que contiene cualquiera de:
'descifrar'
'encrypt'
'import'
'sign'
'unwrapKey'
'verify'
'wrapKey'
keySize Tamaño de la clave en bits. Por ejemplo: 2048, 3072 o 4096 para RSA. int
kty Tipo de la clave. Para obtener valores válidos, consulte JsonWebKeyType. 'CE'
'EC-HSM'
'RSA'
'RSA-HSM'

KeyAttributes

Nombre Descripción Valor
enabled Determina si el objeto está habilitado o no. bool
exp Fecha de expiración en segundos desde 1970-01-01T00:00:00Z. int
Exportable Indica si se puede exportar la clave privada. bool
nbf No antes de la fecha en segundos desde 1970-01-01T00:00:00Z. int

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Creación de una clave en Azure KeyVault

Implementación en Azure
Este módulo permite crear una clave en un keyVault existente.
Cifrado de cuenta de Azure Storage con clave administrada por el cliente

Implementación en Azure
Esta plantilla implementa una cuenta de almacenamiento con una clave administrada por el cliente para el cifrado generado y colocado dentro de un Key Vault.

Definición de recursos de plantilla de ARM

El tipo de recurso vaults/keys se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Comentarios

Para obtener instrucciones sobre el uso de almacenes de claves para valores seguros, consulte Administración de secretos mediante Bicep.

Para ver un inicio rápido sobre cómo crear un secreto, consulte Inicio rápido: Establecimiento y recuperación de un secreto de Azure Key Vault mediante una plantilla de ARM.

Para ver un inicio rápido sobre cómo crear una clave, consulte Inicio rápido: Creación de un almacén de claves de Azure y una clave mediante una plantilla de ARM.

Formato de los recursos

Para crear un recurso Microsoft.KeyVault/vaults/keys, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.KeyVault/vaults/keys",
  "apiVersion": "2021-10-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"
  }
}

Valores de propiedad

vaults/keys

Nombre Descripción Value
type Tipo de recurso "Microsoft.KeyVault/vaults/keys"
apiVersion La versión de la API de recursos '2021-10-01'
name El nombre del recurso

Vea cómo establecer nombres y tipos para recursos secundarios en plantillas de ARM JSON.
string (obligatorio)
etiquetas Etiquetas que se asignarán a la clave. Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
properties Propiedades de la clave que se va a crear. KeyProperties (obligatorio)

KeyProperties

Nombre Descripción Valor
attributes Atributos de la clave. KeyAttributes
curveName Nombre de la curva elíptica. Para obtener valores válidos, consulte JsonWebKeyCurveName. 'P-256'
'P-256K'
'P-384'
'P-521'
keyOps Matriz de cadenas que contiene cualquiera de:
'descifrar'
'encrypt'
'import'
'sign'
'unwrapKey'
'verify'
'wrapKey'
keySize Tamaño de la clave en bits. Por ejemplo: 2048, 3072 o 4096 para RSA. int
kty Tipo de la clave. Para obtener valores válidos, consulte JsonWebKeyType. 'CE'
'EC-HSM'
'RSA'
'RSA-HSM'

KeyAttributes

Nombre Descripción Valor
enabled Determina si el objeto está habilitado o no. bool
exp Fecha de expiración en segundos desde 1970-01-01T00:00:00Z. int
Exportable Indica si se puede exportar la clave privada. bool
nbf No antes de la fecha en segundos desde 1970-01-01T00:00:00Z. int

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Creación de una clave en Azure KeyVault

Implementación en Azure
Este módulo permite crear una clave en un keyVault existente.
Cifrado de cuenta de Azure Storage con clave administrada por el cliente

Implementación en Azure
Esta plantilla implementa una cuenta de almacenamiento con una clave administrada por el cliente para el cifrado generado y colocado dentro de un Key Vault.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso vaults/keys se puede implementar con operaciones destinadas a:

  • Grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.KeyVault/vaults/keys, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.KeyVault/vaults/keys@2021-10-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"
    }
  })
}

Valores de propiedad

vaults/keys

Nombre Descripción Value
type Tipo de recurso "Microsoft.KeyVault/vaults/keys@2021-10-01"
name El nombre del recurso string (obligatorio)
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: almacenes
etiquetas Etiquetas que se asignarán a la clave. Diccionario de nombres y valores de etiqueta.
properties Propiedades de la clave que se va a crear. KeyProperties (obligatorio)

KeyProperties

Nombre Descripción Valor
attributes Atributos de la clave. KeyAttributes
curveName Nombre de la curva elíptica. Para obtener valores válidos, consulte JsonWebKeyCurveName. "P-256"
"P-256K"
"P-384"
"P-521"
keyOps Matriz de cadenas que contiene cualquiera de:
"descifrar"
"cifrar"
"import"
"sign"
"unwrapKey"
"verify"
"wrapKey"
keySize Tamaño de la clave en bits. Por ejemplo: 2048, 3072 o 4096 para RSA. int
kty Tipo de la clave. Para obtener valores válidos, consulte JsonWebKeyType. "CE"
"EC-HSM"
"RSA"
"RSA-HSM"

KeyAttributes

Nombre Descripción Valor
enabled Determina si el objeto está habilitado o no. bool
exp Fecha de expiración en segundos desde 1970-01-01T00:00:00Z. int
Exportable Indica si se puede exportar la clave privada. bool
nbf No antes de la fecha en segundos desde 1970-01-01T00:00:00Z. int