Acciones y atributos para Azure Key Vault condiciones de ABAC (versión preliminar)

Note

Azure ABAC para Key Vault está en versión preliminar. Algunos aspectos pueden cambiar antes de la disponibilidad general. Para obtener los términos de versión preliminar, consulte los términos de uso complementarios.

En este artículo se describen las acciones, atributos y operadores admitidos que puede usar en condiciones en Azure asignaciones de roles para Azure Key Vault. Para obtener información general sobre cómo funcionan las condiciones de asignación de roles, consulte ¿Qué es Azure control de acceso basado en atributos (Azure ABAC)?. Para obtener la lista de acciones de datos de Key Vault a las que afecta un permiso específico, consulte la guía de operaciones de Azure RBAC para Key Vault plano de datos.

Visión general

Azure ABAC para Key Vault se basa en Azure RBAC agregando condiciones a las asignaciones de roles. Azure evalúa cada condición en tiempo de ejecución con los atributos del recurso al que se accede o la solicitud entrante, y permite o deniega la solicitud en función de los operadores de comparación.

Las ventajas de usar condiciones de asignación de roles para Key Vault son:

  • Acceso más específico a los secretos. Restrinja una entidad de seguridad a secretos cuyos nombres coincidan con un patrón específico (por ejemplo, app-* o team-prod-*) o a almacenes de claves específicos por nombre del almacén.
  • Menos asignaciones de roles para administrar. Use una sola asignación de roles con puerta de condición para un grupo de seguridad en lugar de muchas asignaciones individuales que modele los mismos permisos. ABAC le ayuda a escalar la administración de roles: no concede permisos que aún no concede una asignación de roles.
  • Extiende el RBAC de Azure existente. Capas de ABAC sobre las asignaciones de roles existentes. No tiene que reemplazar RBAC para usarlo.

En esta versión preliminar, ABAC para Key Vault solo se aplica a las acciones de datos secretas y admite dos atributos: el nombre del almacén y el nombre del secreto. No se incluyen las acciones de datos clave, las acciones de datos de certificado, los atributos basados Key Vault en etiquetas, los atributos de token y las condiciones de ABAC integradas en ningún rol.

Para usar condiciones de ABAC, el modelo de permisos del almacén de claves debe establecerse en Azure RBAC. Para obtener información general, consulte Azure directivas de RBAC frente a directivas de acceso y Preparación de Key Vault API versión 2026-02-01 y versiones posteriores.

Formato de condición

Las condiciones usan el siguiente formato general:

@Resource[<ResourceType>:<AttributeName>] <Operator> '<Value>'
Componente Description
@Resource Hace referencia a un atributo del recurso al que se accede. Use @Request cuando el atributo describa la solicitud entrante (por ejemplo, el nombre de un secreto que aún no existe).
ResourceType Tipo de recurso Azure Resource Manager. Para Key Vault en esta versión preliminar, o Microsoft.KeyVault/vaultsMicrosoft.KeyVault/vaults/secrets.
AttributeName Atributo específico que se va a evaluar. En esta versión preliminar, name es el único atributo admitido.
Operator Operador de comparación. Consulte Operadores admitidos.
Value Valor literal con el que se va a comparar.

La versión de la condición debe establecerse en 2.0. Para obtener la gramática completa, consulte Azure formato y sintaxis de la condición de asignación de roles.

Operadores compatibles

Azure Key Vault condiciones de ABAC admiten todos los operadores de comparación de cadenas definidos en el formato de condición de ABAC de Azure. Para obtener la lista completa de operadores y su comportamiento, consulte Operadores de comparación de cadenas.

Note

Azure operadores de comparación de cadenas de ABAC incluyen variantes que distinguen mayúsculas de minúsculas, pero Key Vault nombres de almacén y nombres de objeto no distinguen mayúsculas de minúsculas y se normalizan en minúsculas. Como resultado, la coincidencia que distingue mayúsculas de minúsculas no se aplica a Key Vault condiciones de ABAC. Use valores en minúsculas en las condiciones: un valor que contenga caracteres en mayúsculas no coincidirá con ningún nombre de almacén o secreto.

acciones de Azure Key Vault

Puede aplicar condiciones de ABAC a las siguientes acciones de datos secretos Key Vault. Cada subsección describe la acción, dataAction subyacente, el origen del atributo que evalúa (recurso o solicitud) y una condición de ejemplo.

Obtener clave secreta

Propiedad Value
Nombre para mostrar Obtener clave secreta
Description Obtiene el valor de un secreto.
DataAction Microsoft.KeyVault/vaults/secrets/getSecret/action
Atributos del recurso Nombre del secreto
Example !(ActionMatches{'Microsoft.KeyVault/vaults/secrets/getSecret/action'}) OR @Resource[Microsoft.KeyVault/vaults/secrets:name] StringStartsWith 'test-app'

Leer metadatos secretos

Propiedad Value
Nombre para mostrar Leer metadatos secretos
Description Muestra o ve las propiedades de un secreto, pero no su valor.
DataAction Microsoft.KeyVault/vaults/secrets/readMetadata/action
Atributos del recurso Nombre del secreto
Example !(ActionMatches{'Microsoft.KeyVault/vaults/secrets/readMetadata/action'}) OR @Resource[Microsoft.KeyVault/vaults/secrets:name] StringStartsWith 'api-'

Advertencia

readMetadata/action Abarca la recuperación de las propiedades de un solo secreto (que incluye un nombre de secreto) y la enumeración de secretos en un almacén (una llamada de colección sin nombre por secreto). ABAC evalúa una condición por acción, no fila por fila en los resultados de la lista, por lo que una condición secret-name en readMetadata/action produce un error de lista con un error 403: el name atributo no está presente en la solicitud de recopilación y no puede coincidir. Este comportamiento se muestra en la hoja Secretos del portal como una lista en blanco.

Si desea que una entidad de seguridad vea todos los nombres de secreto en la lista, pero abra solo los valores que coinciden con un patrón, no compuerta readMetadata/action. En su lugar, conceda readMetadata/action incondicionalmente y aplique la condición secret-name a getSecret/action. Consulte el ejemplo Restringir el acceso de lectura a secretos con un prefijo de nombre .

Establecer secreto

Propiedad Value
Nombre para mostrar Establecer secreto
Description Establece el valor de un secreto. Si el secreto no existe, se crea la primera versión. De lo contrario, se crea una versión nueva con el valor especificado.
DataAction Microsoft.KeyVault/vaults/secrets/setSecret/action
Atributos de solicitud Nombre del secreto
Example !(ActionMatches{'Microsoft.KeyVault/vaults/secrets/setSecret/action'}) OR @Request[Microsoft.KeyVault/vaults/secrets:name] StringStartsWith 'app-'

Actualizar secreto

Propiedad Value
Nombre para mostrar Actualizar secreto
Description Actualiza los atributos asociados al secreto especificado.
DataAction Microsoft.KeyVault/vaults/secrets/update/action
Atributos del recurso Nombre del secreto
Example !(ActionMatches{'Microsoft.KeyVault/vaults/secrets/update/action'}) OR @Resource[Microsoft.KeyVault/vaults/secrets:name] StringStartsWith 'app-'

Eliminar un secreto

Propiedad Value
Nombre para mostrar Eliminar un secreto
Description Elimina un secreto. Se eliminan todas las versiones.
DataAction Microsoft.KeyVault/vaults/secrets/delete
Atributos del recurso Nombre del secreto
Example !(ActionMatches{'Microsoft.KeyVault/vaults/secrets/delete'}) OR @Resource[Microsoft.KeyVault/vaults/secrets:name] StringStartsWith 'temp-'

Secreto de copia de seguridad

Propiedad Value
Nombre para mostrar Secreto de copia de seguridad
Description Crea el archivo de copia de seguridad de un secreto. El archivo se puede usar para restaurar el secreto en un almacén de claves de la misma suscripción. Es posible que se apliquen restricciones.
DataAction Microsoft.KeyVault/vaults/secrets/backup/action
Atributos del recurso Nombre del secreto
Example !(ActionMatches{'Microsoft.KeyVault/vaults/secrets/backup/action'}) OR @Resource[Microsoft.KeyVault/vaults/secrets:name] StringStartsWith 'critical-'

Restauración del secreto

Propiedad Value
Nombre para mostrar Restauración del secreto
Description Restaura un secreto y todas sus versiones a partir de un archivo de copia de seguridad generado por Key Vault.
DataAction Microsoft.KeyVault/vaults/secrets/restore/action
Atributos de solicitud Nombre del secreto
Example !(ActionMatches{'Microsoft.KeyVault/vaults/secrets/restore/action'}) OR @Request[Microsoft.KeyVault/vaults/secrets:name] StringStartsWith 'app-'

Recuperar secreto

Propiedad Value
Nombre para mostrar Recuperar secreto
Description Recupera un secreto eliminado. La operación realiza la inversión de la operación De eliminación y se aplica en almacenes habilitados para la eliminación temporal.
DataAction Microsoft.KeyVault/vaults/secrets/recover/action
Atributos del recurso Nombre del secreto
Example !(ActionMatches{'Microsoft.KeyVault/vaults/secrets/recover/action'}) OR @Resource[Microsoft.KeyVault/vaults/secrets:name] StringStartsWith 'app-'

Purgar secreto

Propiedad Value
Nombre para mostrar Purgar secreto
Description Purga un secreto eliminado, lo que hace que sea irrecuperable.
DataAction Microsoft.KeyVault/vaults/secrets/purge/action
Atributos del recurso Nombre del secreto
Example !(ActionMatches{'Microsoft.KeyVault/vaults/secrets/purge/action'}) OR @Resource[Microsoft.KeyVault/vaults/secrets:name] StringStartsWith 'old-'

Orígenes de atributos

Los atributos describen las propiedades evaluadas en el momento de la solicitud. Los atributos de recurso describen el recurso al que se accede. Los atributos de solicitud describen la solicitud entrante cuando es posible que el recurso aún no exista (por ejemplo, durante setSecret o restore).

Nombre de la bóveda

Use este atributo para definir el ámbito del acceso a los almacenes de claves cuyos nombres coinciden con un patrón determinado. Al aplicar una condición en el ámbito de la suscripción o del grupo de recursos, Azure evalúa el nombre del almacén para cada almacén al que la entidad de seguridad intenta acceder.

Propiedad Value
Nombre para mostrar Nombre de la bóveda
Description Nombre del almacén de claves al que se accede.
Attribute Microsoft.KeyVault/vaults:name
Origen de atributo Resource
Tipo de atributo String
Acciones aplicables Todas las acciones de datos secretos Key Vault (atributo global)

Condiciones de ejemplo:

@Resource[Microsoft.KeyVault/vaults:name] StringStartsWith 'prod-'
@Resource[Microsoft.KeyVault/vaults:name] StringEquals 'sample-vault'
@Resource[Microsoft.KeyVault/vaults:name] StringLike 'team-*-prod'

Nombre del secreto (recurso)

Use este atributo cuando el secreto ya exista en el momento de la evaluación.

Propiedad Value
Nombre para mostrar Nombre del secreto
Description Nombre del secreto al que se accede.
Attribute Microsoft.KeyVault/vaults/secrets:name
Origen de atributo Resource
Tipo de atributo String
Acciones aplicables getSecret/action, readMetadata/action, update/action, delete, backup/action, , recover/actionpurge/action

Condiciones de ejemplo:

@Resource[Microsoft.KeyVault/vaults/secrets:name] StringStartsWith 'test-app'
@Resource[Microsoft.KeyVault/vaults/secrets:name] StringLike 'api-key-*'

Nombre del secreto (solicitud)

Use este atributo cuando el secreto todavía no exista en el momento de la evaluación, como durante la creación o restauración.

Propiedad Value
Nombre para mostrar Nombre del secreto (solicitud)
Description Nombre de un secreto que se solicita.
Attribute Microsoft.KeyVault/vaults/secrets:name
Origen de atributo Solicitud
Tipo de atributo String
Acciones aplicables setSecret/action, restore/action

Condiciones de ejemplo:

@Request[Microsoft.KeyVault/vaults/secrets:name] StringStartsWith 'app-'
@Request[Microsoft.KeyVault/vaults/secrets:name] StringLike 'config-*'

Roles que admiten condiciones de ABAC

Puede aplicar condiciones de ABAC a cualquier rol que incluya Key Vault secretodataActions. Los roles que solo contienen acciones del plano de control (como propietario o administrador de directivas) no admiten condiciones de ABAC porque Azure evalúa las condiciones exclusivamente en las operaciones del plano de datos. En esta versión preliminar, ningún rol integrado incluye una condición de ABAC preasignada Key Vault : se crea la condición al crear la asignación de roles.

Los siguientes roles integrados incluyen acciones de datos secretos y admiten condiciones de ABAC en esta versión preliminar. Para obtener las definiciones de roles y los identificadores completos, consulte Azure roles integrados para Key Vault operaciones del plano de datos.

Función Description ID Compatibilidad con condiciones
Administrador de Key Vault Realice todas las operaciones del plano de datos en una bóveda de claves y en todos los objetos que contiene. 00482a5a-887f-4fb3-b363-3b7fe8e74483 Atributos de recurso y solicitud en operaciones secretas
Director de secretos de Key Vault Realice cualquier acción en secretos. b86a8fe4-44ce-4948-aee5-eccb2c155cd7 Atributos de recursos en operaciones de lectura y ciclo de vida; Solicitud de atributos en setSecret operaciones y restore
Usuario de secretos de Key Vault Permite leer el contenido de los secretos. 4633458b-17de-408a-b874-0445c86b69e6 Atributos de recursos en operaciones de lectura secreta
Lector de Key Vault Lee los metadatos de los almacenes y sus objetos. 21090545-7ca7-4776-b22c-e363652d74d2 Atributos de recurso en readMetadata/action para un único secreto. Una condición de nombre secreto aquí bloquea las llamadas de lista; consulte la advertencia en Leer metadatos secretos.
Usuario de certificado de Key Vault Leer el contenido del certificado. db79e9a7-68ee-4b58-9aeb-b90e7c24fcba Atributos de recurso en getSecret y readMetadata (los certificados se recuperan a través del punto de conexión secreto: el nombre del secreto es igual al nombre del certificado)
Roles personalizados Cualquier definición de rol personalizada que incluya el secreto dataActions para Key Vault. - Depende de qué secreto dataActions se incluya

Note

Solo los roles asignados a través de Azure RBAC (no las directivas de acceso del almacén heredado) admiten condiciones de ABAC. El almacén de claves debe tener su modelo de permisos establecido en Azure control de acceso basado en rol. A partir de la versión de API 2026-02-01, Azure RBAC es el valor predeterminado para los almacenes recién creados. Para obtener más información, consulte Prepare for Key Vault API versión 2026-02-01 y versiones posteriores.

Ejemplos de condiciones

En los ejemplos siguientes se muestran patrones de ABAC comunes para Key Vault secretos. Para obtener más información sobre la sintaxis de la condición, consulte Azure formato y sintaxis de la condición de asignación de roles.

Ejemplo: Restricción del acceso de lectura a secretos con un prefijo de nombre

Permitir que una entidad de seguridad lea solo secretos cuyos nombres empiecen por test-app:

  • Role: usuario de secretos de Key Vault
  • Ámbito: recurso del almacén de claves
  • Condición:
(
  !(ActionMatches{'Microsoft.KeyVault/vaults/secrets/getSecret/action'})
  OR
  (
    @Resource[Microsoft.KeyVault/vaults/secrets:name] StringStartsWith 'test-app'
  )
)

Comportamiento:

  • Permitido: Lectura de test-app-secret1.
  • Denegado (ForbiddenByRbac): lectura test-db-passwordde .

Ejemplo: Restricción del acceso a secretos en almacenes específicos por prefijo de nombre del almacén

Permitir que una entidad de seguridad lea secretos solo en almacenes cuyos nombres comiencen por kv-prod:

  • Role: usuario de secretos de Key Vault
  • Ámbito: Suscripción
  • Condición:
@Resource[Microsoft.KeyVault/vaults:name] StringStartsWith 'kv-prod'

Comportamiento:

  • Permitido: acceso a kv-prod-1.
  • Denegado: acceso a test-kv.

Ejemplo: Restringir los secretos recién creados a un prefijo de nombre

Permitir que una entidad de seguridad cree secretos solo cuando el nombre del secreto comience por app-. Dado que el secreto aún no existe en el momento de la evaluación, use el atributo Request:

  • Rol: oficial de secretos de Key Vault
  • Ámbito: recurso del almacén de claves
  • Condición:
(
  !(ActionMatches{'Microsoft.KeyVault/vaults/secrets/setSecret/action'})
  OR
  (
    @Request[Microsoft.KeyVault/vaults/secrets:name] StringStartsWith 'app-'
  )
)

Ejemplo: Combinación de condiciones de nombre de almacén y secreto

Restrinja una entidad de seguridad para leer solo los secretos que comienzan por api- en almacenes cuyos nombres comienzan por kv-prod:

  • Role: usuario de secretos de Key Vault
  • Ámbito: Suscripción
  • Condición:
(
  !(ActionMatches{'Microsoft.KeyVault/vaults/secrets/getSecret/action'})
  OR
  (
    @Resource[Microsoft.KeyVault/vaults:name] StringStartsWith 'kv-prod'
    AND
    @Resource[Microsoft.KeyVault/vaults/secrets:name] StringStartsWith 'api-'
  )
)