Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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-*oteam-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): lecturatest-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-'
)
)
Contenido relacionado
- Adición de condiciones de asignación de roles para Key Vault secretos mediante CLI de Azure (versión preliminar)
- Adición de condiciones de asignación de roles para secretos de Key Vault mediante Azure PowerShell (versión preliminar)
- ¿Qué es el control de acceso basado en atributos de Azure (Azure ABAC)?
- Sintaxis y formato de las condiciones de asignación de roles de Azure
- Proporcionar acceso a claves, certificados y secretos de Key Vault con RBAC de Azure
- Solución de problemas de condiciones de asignación de roles de Azure
- Solución de problemas de acceso a Key Vault
- Preparación de Key Vault API versión 2026-02-01 y posteriores