Corregir los recursos no conformes con Azure Policy

Los recursos que no cumplen las directivas con efectos deployIfNotExists o modify se pueden colocar en estado de cumplimiento mediante la funcionalidad de Corrección. La corrección se consigue mediante tareas de corrección que implementan la plantilla deployIfNotExists o las operaciones modify de la directiva asignada en los recursos y suscripciones existentes, tanto si esa asignación está en un grupo de administración, una suscripción, un grupo de recursos o un solo recurso. En este artículo se muestran los pasos necesarios para comprender y realizar correcciones con Azure Policy.

Funcionamiento del control de acceso a la corrección

Cuando Azure Policy inicia una implementación de plantilla al evaluar directivas deployIfNotExists o modifica un recurso al evaluar directivas modify, lo hace mediante una identidad administrada asociada a la asignación de directiva. Las asignaciones de directivas usan identidades administradas para la autorización de recursos de Azure. Puede usar una identidad administrada asignada por el sistema creada el servicio de directivas o una identidad asignada por el usuario que proporciona el usuario. La identidad administrada debe tener asignado el rol mínimo de control de acceso basado en rol de Azure (RBAC de Azure) necesario para corregir los recursos. Si faltan roles en la identidad administrada, se muestra un error durante la asignación de la directiva o una iniciativa. Al usar el portal, Azure Policy concede automáticamente a la identidad administrada los roles enumerados cuando se inicia la asignación. Al usar un kit de desarrollo de software (SDK) de Azure, los roles se deben conceder manualmente a la identidad administrada. La propiedad location de la identidad administrada no afecta a su funcionamiento con Azure Policy.

Nota:

Al cambiar una definición de directiva no se actualiza automáticamente la asignación ni la identidad administrada asociada.

La seguridad de corrección se puede configurar mediante los pasos siguientes:

• Configuración de la definición de directiva
• Configuración de la identidad administrada
• Concesión de permisos a la identidad administrada mediante roles definidos
• Crear una tarea de corrección

Configuración de la definición de directiva

Como requisito previo, la definición de directiva debe definir los roles que deployIfNotExists y modify necesitan para implementar correctamente el contenido de la plantilla incluida. No se requiere ninguna acción para una definición de directiva integrada porque estos roles se rellenan previamente. Para una definición de directiva personalizada, en la propiedad details, agregue una propiedad roleDefinitionIds. Esta propiedad es una matriz de cadenas que coinciden con los roles de su entorno. Para obtener un ejemplo completo, consulte deployIfNotExists o modify.

"details": {
    ...
    "roleDefinitionIds": [
    "/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/roleDefinitions/{roleGUID}",
    "/providers/Microsoft.Authorization/roleDefinitions/{builtinroleGUID}"
  ]
}

La propiedad roleDefinitionIds usa el identificador de recurso completo y no toma el roleName corto del rol. Para obtener el identificador del rol Colaborador en su entorno, use el siguiente código de CLI de Azure:

az role definition list --name "Contributor"

Importante

Los permisos deben restringirse al menor conjunto posible al definir roleDefinitionIds dentro de una definición de directiva o asignar permisos a una identidad administrada manualmente. Consulte las recomendaciones de procedimientos recomendados de identidad administrada para más procedimientos recomendados.

Configuración de la identidad administrada

Cada asignación de Azure Policy solo se puede asociar a una identidad administrada. Sin embargo, a la identidad administrada se le pueden asignar varios roles. La configuración tiene lugar en dos pasos: primero cree una identidad administrada asignada por el sistema o asignada por el usuario y, luego, concédale los roles necesarios.

Nota

Al crear una identidad administrada mediante el portal, se concederán roles automáticamente a la identidad administrada. Si roleDefinitionIds se edita más adelante en la definición de directiva, se deben conceder manualmente los nuevos permisos, incluso en el portal.

Creación de la identidad administrada

Portal

Al crear una asignación mediante el portal, Azure Policy puede generar una identidad administrada asignada por el sistema y concederle los roles definidos en el valor roleDefinitionIds de la definición de directiva. Como alternativa, puede especificar una identidad administrada asignada por el usuario que reciba la misma asignación de roles.

Para establecer una identidad administrada asignada por el sistema en el portal, haga lo siguiente:

1. En la pestaña Corrección de la vista de asignación de creación o edición, en Types of Managed Identity (Tipos de identidad administrada), asegúrese de que la opción Identidad administrada asignada por el sistema está seleccionada.

2. Especifique la ubicación en la que se va a ubicar la identidad administrada.

3. No asigne un ámbito para la identidad administrada asignada por el sistema porque el ámbito se heredará del ámbito de asignación.

Para establecer una identidad administrada asignada por el usuario en el portal, haga lo siguiente:

1. En la pestaña Corrección de la vista de asignación de creación o edición, en Types of Managed Identity (Tipos de identidad administrada), asegúrese de que la opción Identidad administrada asignada por el usuario está seleccionada.

2. Especifique el ámbito donde se hospeda la identidad administrada. El ámbito de la identidad administrada no tiene que ser igual al ámbito de la asignación, pero debe estar en el mismo inquilino.

3. En Existing user assigned identities (Identidades asignadas por el usuario existentes), seleccione la identidad administrada.

PowerShell

Para crear una identidad durante la asignación de la directiva, debe definirse Ubicación y debe usarse Identidad.

En el siguiente ejemplo se obtiene la definición de la directiva integrada Implementar cifrado de datos transparente de SQL DB, se establece el grupo de recursos de destino y después se crea la asignación mediante una identidad administrada asignada por el sistema.

# Login first with Connect-AzAccount if not using Cloud Shell

# Get the built-in "Deploy SQL DB transparent data encryption" policy definition
$policyDef = Get-AzPolicyDefinition -Id '/providers/Microsoft.Authorization/policyDefinitions/86a912f6-9a06-4e26-b447-11b16ba8659f'

# Get the reference to the resource group
$resourceGroup = Get-AzResourceGroup -Name 'MyResourceGroup'

# Create the assignment using the -Location and -Identity properties
$assignment = New-AzPolicyAssignment -Name 'sqlDbTDE' -DisplayName 'Deploy SQL DB transparent data encryption' -Scope $resourceGroup.ResourceId -PolicyDefinition $policyDef -Location 'westus' -IdentityType "SystemAssigned"

En el ejemplo siguiente se obtiene la definición de la directiva integrada Implementar cifrado de datos transparente de SQL DB, se establece el grupo de recursos de destino y después se crea la asignación mediante una identidad administrada asignada por el usuario.

# Login first with Connect-AzAccount if not using Cloud Shell

# Get the built-in "Deploy SQL DB transparent data encryption" policy definition
$policyDef = Get-AzPolicyDefinition -Id '/providers/Microsoft.Authorization/policyDefinitions/86a912f6-9a06-4e26-b447-11b16ba8659f'

# Get the reference to the resource group
$resourceGroup = Get-AzResourceGroup -Name 'MyResourceGroup'

# Get the existing user assigned managed identity ID
$userassignedidentity = Get-AzUserAssignedIdentity -ResourceGroupName $rgname -Name $userassignedidentityname
$userassignedidentityid = $userassignedidentity.Id

# Create the assignment using the -Location and -Identity properties
$assignment = New-AzPolicyAssignment -Name 'sqlDbTDE' -DisplayName 'Deploy SQL DB transparent data encryption' -Scope $resourceGroup.ResourceId -PolicyDefinition $policyDef -Location 'westus' -IdentityType "UserAssigned" -IdentityId $userassignedidentityid

La variable $assignment contiene ahora el identificador principal de la identidad administrada junto con los valores estándar devueltos cuando se crea una asignación de directiva. Se puede acceder mediante $assignment.Identity.PrincipalId para identidades administradas asignadas por el sistema y mediante $assignment.Identity.UserAssignedIdentities[$userassignedidentityid].PrincipalId para identidades administradas asignadas por el usuario.

CLI de Azure

Para crear una identidad durante la asignación de la directiva, use los comandos az policy assignment create con los parámetros --location, --mi-system-assigned, --mi-user-assigned y --identity-scope en función de si la identidad administrada debe ser asignada por el sistema o por el usuario.

Para agregar una identidad asignada por el sistema o una identidad asignada por el usuario a una asignación de directiva, siga los comandos az policy assignment identity assign de ejemplo.

Concesión de permisos a la identidad administrada mediante roles definidos

Importante

Si la identidad administrada no tiene los permisos necesarios para ejecutar la tarea de corrección necesaria, solo se le concederán permisos automáticamente mediante el portal. Puede omitir este paso si crea una identidad administrada mediante el portal.

Para todos los demás métodos, la identidad administrada de la asignación debe concederse acceso manualmente mediante la adición de roles o, de lo contrario, se producirá un error en la implementación de corrección.

Escenarios de ejemplo que requieren permisos manuales:

• Si la asignación se crea mediante un kit de desarrollo de software (SDK) de Azure
• Si un recurso modificado por deployIfNotExists o modify está fuera del ámbito de la asignación de directiva
• Si la plantilla obtiene acceso a las propiedades de los recursos fuera del ámbito de la asignación de directiva.

Portal

Hay dos maneras de conceder los roles definidos a la identidad administrada de una asignación: mediante Control de acceso (IAM) o editando la asignación de directiva o iniciativa y seleccionando Guardar.

Para agregar un rol a la identidad administrada de la asignación, siga estos pasos:

1. Inicie el servicio Azure Policy en Azure Portal. Para ello, seleccione Todos los servicios y, a continuación, busque y seleccione Directiva.

2. Seleccione Asignaciones en el panel izquierdo de la página de Azure Policy.

3. Busque la asignación que tiene una identidad administrada y seleccione el nombre.

4. Busque la propiedad Id. de asignación en la página Editar. El identificador de asignación tiene un aspecto similar al ejemplo siguiente:

   /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Authorization/policyAssignments/2802056bfc094dfb95d4d7a5
   

   El nombre de la identidad administrada es la última parte del identificador del recurso de asignación, que es 2802056bfc094dfb95d4d7a5 en este ejemplo. Copie esta parte del identificador de recursos de asignación.

5. Navegue hasta el contenedor primario del recurso o recursos (grupo de recursos, suscripción, grupo de administración) al que se debe agregar manualmente la definición de función.

6. Seleccione el vínculo Control de acceso (IAM) en la página de recursos y luego + Agregar asignación de rol en la parte superior de la página de control de acceso.

7. Seleccione el rol adecuado que coincide con un roleDefinitionIds de la definición de directiva. Deje Asignar acceso a con el valor predeterminado de "usuario, grupo o aplicación". En el cuadro Seleccionar, pegue o escriba la parte del identificador del recurso de asignación que buscó anteriormente. Una vez finalizada la búsqueda, seleccione el objeto con el mismo nombre que el identificador seleccionado y elija Guardar.

PowerShell

La nueva identidad administrada debe completar la replicación a través de Microsoft Entra ID antes de que se le puedan conceder los roles necesarios. Una vez que se completa la replicación, los ejemplos siguientes iteran la definición de directiva en $policyDef para roleDefinitionIds y usa New-AzRoleAssignment para conceder la nueva identidad administrada a los roles.

En concreto, en el primer ejemplo se muestra cómo conceder roles en el ámbito de la directiva. En el segundo ejemplo se muestra cómo conceder los roles en el ámbito de iniciativa (conjunto de directivas).

###################################################
# Grant roles to managed identity at policy scope #
###################################################

# Use the $policyDef to get to the roleDefinitionIds array
$roleDefinitionIds = $policyDef.Properties.policyRule.then.details.roleDefinitionIds

if ($roleDefinitionIds.Count -gt 0)
{
    $roleDefinitionIds | ForEach-Object {
        $roleDefId = $_.Split("/") | Select-Object -Last 1
        New-AzRoleAssignment -Scope $resourceGroup.ResourceId -ObjectId $assignment.Identity.PrincipalId
        -RoleDefinitionId $roleDefId
    }
}

#######################################################
# Grant roles to managed identity at initiative scope #
#######################################################

#If the policy had no managed identity in its logic, then no impact. If there is a managed identity
used for enforcement, replicate it on the new assignment.
$getNewInitiativeAssignment = Get-AzPolicyAssignment -Name $newInitiativeDefinition.Name

#Create an array to store role definition's IDs used by policies inside the initiative.
$InitiativeRoleDefinitionIds = @();

#Loop through the policy definitions inside the initiative and gather their role definition IDs
foreach ($policyDefinitionIdInsideInitiative in $InitiativeDefinition.Properties.PolicyDefinitions.policyDefinitionId) {
  $policyDef = Get-AzPolicyDefinition -Id $policyDefinitionIdInsideInitiative
  $roleDefinitionIds = $policyDef.Properties.PolicyRule.then.details.roleDefinitionIds
  $InitiativeRoleDefinitionIds += $roleDefinitionIds
}

#Create the role assignments used by the initiative assignment at the subscription scope.
if ($InitiativeRoleDefinitionIds.Count -gt 0) {
  $InitiativeRoleDefinitionIds | Sort-Object -Unique | ForEach-Object {
    $roleDefId = $_.Split("/") | Select-Object -Last 1
    New-AzRoleAssignment -Scope "/subscriptions/$($subscription)" -ObjectId $getNewInitiativeAssignment.Identity.PrincipalId
    -RoleDefinitionId $roleDefId
  }
}

CLI de Azure

La nueva identidad administrada debe completar la replicación a través de Microsoft Entra ID antes de que se le puedan conceder los roles necesarios. Una vez completada la replicación, se deben conceder a la identidad administrada los roles especificados en el valor roleDefinitionIds de la definición de directiva.

Acceda a los roles especificados en la definición de directiva mediante el comando az policy definition show y, luego, itere sobre cada roleDefinitionIds para crear la asignación de roles mediante el comando az role assignment create.

Crear una tarea de corrección

Portal

Inicie el servicio Azure Policy en Azure Portal. Para ello, seleccione Todos los servicios y, a continuación, busque y seleccione Directiva.

Paso 1: Inicio de la creación de tareas de corrección

Hay tres maneras de crear una tarea de corrección mediante el portal.

Opción 1: Crear una tarea de corrección desde la página Corrección

1. Seleccione Corrección en el lado izquierdo de la página Azure Policy.

   

2. Todas las asignaciones de directivas deployIfNotExists y modify se muestran en la pestaña Directivas para corregir. Seleccione una con los recursos no conformes para abrir la página Nueva tarea de corrección.

3. Siga los pasos para especificar los detalles de la tarea de corrección.

Opción 2: Crear una tarea de corrección a partir de una asignación de directiva no compatible

1. Seleccione Cumplimiento en el panel izquierdo de la página de Azure Policy.

2. Seleccione una asignación de iniciativa o directiva no conforme que contenga los efectos deployIfNotExists o modify.

3. Seleccione el botón Crear tarea de corrección en la parte superior de la página para abrir la página Nueva tarea de corrección.

4. Siga los pasos para especificar los detalles de la tarea de corrección.

Opción 3: Crear una tarea de corrección durante la asignación de directiva

Si la definición de directiva o iniciativa que se va a asignar tiene un efecto deployIfNotExists o modify, la pestaña Corrección del asistente ofrece la opción Crear una tarea de corrección, que crea una tarea de corrección al mismo tiempo que la asignación de directiva.

Nota:

Este es el enfoque más simplificado para crear una tarea de corrección y es compatible con las directivas asignadas en una suscripción. En el caso de las directivas asignadas en un grupo de administración, las tareas de corrección se deben crear mediante la opción 1 o la opción 2 después de que la evaluación haya determinado el cumplimiento de los recursos.

1. En el Asistente para asignaciones del portal, vaya a la pestaña Corrección y active la casilla Crear una tarea de corrección.

2. Si la tarea de corrección se inicia desde una asignación de iniciativa, seleccione la directiva que se va a corregir en la lista desplegable.

3. Configure la identidad administrada y rellene el resto del asistente. La tarea de corrección se crea cuando se crea la asignación.

Paso 2: Especificación de los detalles de la tarea de corrección

Este paso solo es aplicable cuando se usa la opción 1 o la opción 2 para iniciar la creación de tareas de corrección.

1. Si la tarea de corrección se inicia desde una asignación de iniciativa, seleccione la directiva que se va a corregir en la lista desplegable. Se puede corregir una directiva deployIfNotExists o modify a través de una sola tarea de corrección a la vez.

2. Opcionalmente, modifique la configuración de corrección en la página. Para obtener más información sobre qué controla cada configuración, consulte estructura de tareas de corrección.

3. En la misma página, filtre los recursos que se corregirán mediante la elipse Ámbito para escoger los recursos secundarios a partir de los cuales se asignó la directiva (incluidos los objetos de recursos individuales). Además, utilice la lista desplegable Ubicaciones para filtrar más los recursos.

   

4. Inicie la tarea de corrección después de que se hayan filtrado los recursos seleccionando Corregir. Se abre la página de cumplimiento de directivas en la pestaña Tareas de corrección para mostrar el estado del progreso de las tareas. Las implementaciones que ha creado la tarea de corrección se inician inmediatamente.

   

Paso 3: Seguimiento del progreso de la tarea de corrección

1. Vaya a la pestaña Tareas de corrección en la página Corrección. Seleccione una tarea de corrección para ver detalles sobre el filtrado usado, el estado actual y una lista de los recursos que se están corrigendo.

2. En la página Tarea de corrección, haga clic con el botón derecho en un recurso para ver el recurso o la implementación de la tarea de corrección. Al final de la fila, seleccione Eventos relacionados para ver detalles, como los mensajes de error.

   

Los recursos implementados mediante una tarea de corrección se agregan a la pestaña Recursos implementados en la página de detalles de las asignación de directiva.

PowerShell

Para crear una tarea de corrección con Azure PowerShell, use los comandos Start-AzPolicyRemediation. Reemplace {subscriptionId} por el identificador de la suscripción y {myAssignmentId} por el identificador de asignación de la directiva de deployIfNotExists o modify.

# Login first with Connect-AzAccount if not using Cloud Shell

# Create a remediation for a specific assignment
Start-AzPolicyRemediation -Name 'myRemedation' -PolicyAssignmentId '/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyAssignments/{myAssignmentId}'

También puede optar por ajustar la configuración de corrección mediante estos parámetros opcionales:

• -FailureThreshold (Porcentaje de umbral de error): se usa para especificar si se debe producir un error en la tarea de corrección si el porcentaje de errores supera el umbral especificado. Se proporciona como un número entre 0 y 100. De manera predeterminada, el umbral de error es 100 %.
• -ResourceCount: determina cuántos recursos no compatibles se corregirán en una tarea de corrección determinada. El valor predeterminado es 500 (el límite anterior). El número máximo de recursos es de 50 000.
• -ParallelDeploymentCount (Implementaciones en paralelo): determina cuántos recursos se corregirán al mismo tiempo. Los valores permitidos son de 1 a 30 recursos a la vez. El valor predeterminado es 10.

Para ver otros cmdlets de corrección y ejemplos, consulte el módulo Az.PolicyInsights.

CLI de Azure

Para crear una tarea de corrección con la CLI de Azure, use los comandos az policy remediation. Reemplace {subscriptionId} por el identificador de la suscripción y {myAssignmentId} por el identificador de asignación de la directiva de deployIfNotExists o modify.

# Login first with az login if not using Cloud Shell

# Create a remediation for a specific assignment
az policy remediation create --name myRemediation --policy-assignment '/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyAssignments/{myAssignmentId}'

Para ver otros comandos de corrección y ejemplos, consulte los comandos az policy remediation.

Pasos siguientes

• Puede consultar ejemplos en Ejemplos de Azure Policy.
• Revise la estructura de definición de Azure Policy.
• Vea la Descripción de los efectos de directivas.
• Obtenga información acerca de cómo se pueden crear directivas mediante programación.
• Obtenga información sobre cómo obtener datos de cumplimiento.
• En Organización de los recursos con grupos de administración de Azure, obtendrá información sobre lo que es un grupo de administración.