Niet-compatibele resources herstellen met Azure Policy

Resources die niet compatibel zijn met beleid of deployIfNotExists modify effecten, kunnen via herstel in een compatibele status worden geplaatst. Herstel wordt uitgevoerd via hersteltaken waarmee de deployIfNotExists sjabloon of de modify bewerkingen van het toegewezen beleid voor uw bestaande resources en abonnementen worden geïmplementeerd, ongeacht of deze toewijzing deel uitmaakt van een beheergroep, abonnement, resourcegroep of afzonderlijke resource. In dit artikel worden de stappen beschreven die nodig zijn om herstel met Azure Policy te begrijpen en uit te voeren.

Hoe hersteltoegangsbeheer werkt

Wanneer Azure Policy een sjabloonimplementatie start bij het evalueren van beleidsregels of een resource wijzigt bij het evalueren deployIfNotExists van modify beleidsregels, gebeurt dit met behulp van een beheerde identiteit die is gekoppeld aan de beleidstoewijzing. De beleidstoewijzingen gebruiken beheerde identiteiten voor Azure-resourceautorisatie. U kunt een door het systeem toegewezen beheerde identiteit gebruiken die is gemaakt door de beleidsservice of een door de gebruiker toegewezen identiteit die door de gebruiker wordt geleverd. Aan de beheerde identiteit moet de minimale Azure RBAC-rol (op rollen gebaseerd toegangsbeheer) van Azure worden toegewezen die nodig is om resources te herstellen. Als er rollen ontbreken in de beheerde identiteit, wordt er een fout weergegeven in de portal tijdens de toewijzing van het beleid of een initiatief. Wanneer u de portal gebruikt, verleent Azure Policy automatisch de beheerde identiteit de vermelde rollen zodra de toewijzing is gestart. Wanneer u een Azure Software Development Kit (SDK) gebruikt, moeten de rollen handmatig worden verleend aan de beheerde identiteit. De locatie van de beheerde identiteit heeft geen invloed op de bewerking met Azure Policy.

Notitie

Als u een beleidsdefinitie wijzigt, wordt de toewijzing of de bijbehorende beheerde identiteit niet automatisch bijgewerkt.

Herstelbeveiliging kan worden geconfigureerd via de volgende stappen:

• De beleidsdefinitie configureren
• De beheerde identiteit configureren
• Machtigingen verlenen aan de beheerde identiteit via gedefinieerde rollen
• Een hersteltaak maken

De beleidsdefinitie configureren

Als vereiste moet de beleidsdefinitie de rollen definiëren die deployIfNotExists de inhoud van de opgenomen sjabloon moeten implementeren.modify Er is geen actie vereist voor een ingebouwde beleidsdefinitie omdat deze rollen vooraf worden ingevuld. Voeg onder de details eigenschap een eigenschap toe voor een roleDefinitionIds aangepaste beleidsdefinitie. Deze eigenschap is een matrix met tekenreeksen die overeenkomen met rollen in uw omgeving. Zie deployIfNotExists of modify voor een volledig voorbeeld.

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

De roleDefinitionIds eigenschap maakt gebruik van de volledige resource-id en neemt niet het korte roleName deel van de rol in beslag. Gebruik de volgende Azure CLI-code om de id op te halen voor de rol Inzender in uw omgeving:

az role definition list --name "Contributor"

Belangrijk

Machtigingen moeten worden beperkt tot de kleinste mogelijke set bij het definiëren roleDefinitionIds binnen een beleidsdefinitie of het handmatig toewijzen van machtigingen aan een beheerde identiteit. Zie aanbevelingen voor aanbevolen procedures voor beheerde identiteiten voor meer aanbevolen procedures.

De beheerde identiteit configureren

Elke Azure Policy-toewijzing kan worden gekoppeld aan slechts één beheerde identiteit. De beheerde identiteit kan echter meerdere rollen worden toegewezen. Configuratie vindt plaats in twee stappen: maak eerst een door het systeem toegewezen of door de gebruiker toegewezen beheerde identiteit en verdeel deze vervolgens de benodigde rollen.

Notitie

Bij het maken van een beheerde identiteit via de portal worden rollen automatisch verleend aan de beheerde identiteit. Als roleDefinitionIds deze later worden bewerkt in de beleidsdefinitie, moeten de nieuwe machtigingen handmatig worden verleend, zelfs in de portal.

De beheerde identiteit maken

Portal

Wanneer u een toewijzing maakt met behulp van de portal, kan Azure Policy een door het systeem toegewezen beheerde identiteit genereren en deze de rollen verlenen die zijn gedefinieerd in de beleidsdefinitie roleDefinitionIds. U kunt ook een door de gebruiker toegewezen beheerde identiteit opgeven die dezelfde roltoewijzing ontvangt.

Een door het systeem toegewezen beheerde identiteit instellen in de portal:

1. Controleer op het tabblad Herstel van de toewijzingsweergave maken/bewerken onder Typen beheerde identiteit of door het systeem toegewezen beheerde identiteit is geselecteerd.

2. Geef de locatie op waar de beheerde identiteit zich moet bevinden.

3. Wijs geen bereik toe voor door het systeem toegewezen beheerde identiteit, omdat het bereik wordt overgenomen van het toewijzingsbereik.

Een door de gebruiker toegewezen beheerde identiteit instellen in de portal:

1. Controleer op het tabblad Herstel van de toewijzingsweergave maken/bewerken onder Typen beheerde identiteit of door de gebruiker toegewezen beheerde identiteit is geselecteerd.

2. Geef het bereik op waarin de beheerde identiteit wordt gehost. Het bereik van de beheerde identiteit hoeft niet gelijk te zijn aan het bereik van de toewijzing, maar moet zich in dezelfde tenant bevinden.

3. Selecteer onder Bestaande door de gebruiker toegewezen identiteiten de beheerde identiteit.

PowerShell

Als u een identiteit wilt maken tijdens de toewijzing van het beleid, moet Locatie worden gedefinieerd en Identiteit worden gebruikt.

In het volgende voorbeeld wordt de definitie opgehaald van het ingebouwde beleid Transparante gegevensversleuteling voor SQL DB implementeren, wordt de doelresourcegroep ingesteld en wordt vervolgens de toewijzing gemaakt met behulp van een door het systeem toegewezen beheerde identiteit.

# 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"

In het volgende voorbeeld wordt de definitie opgehaald van het ingebouwde beleid Transparante gegevensversleuteling voor SQL DB implementeren, de doelresourcegroep ingesteld en vervolgens de toewijzing gemaakt met behulp van een door de gebruiker toegewezen beheerde identiteit.

# 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

De $assignment variabele bevat nu de principal-id van de beheerde identiteit, samen met de standaardwaarden die worden geretourneerd bij het maken van een beleidstoewijzing. Deze kan worden geopend voor $assignment.Identity.PrincipalId door het systeem toegewezen beheerde identiteiten en $assignment.Identity.UserAssignedIdentities[$userassignedidentityid].PrincipalId voor door de gebruiker toegewezen beheerde identiteiten.

Azure-CLI

Als u een identiteit wilt maken tijdens de toewijzing van het beleid, gebruikt u az policy assignment create opdrachten met de parameters --location, --mi-system-assigned--mi-user-assigneden --identity-scope afhankelijk van of de beheerde identiteit moet worden toegewezen aan het systeem of door de gebruiker toegewezen.

Als u een door het systeem toegewezen identiteit of een door de gebruiker toegewezen identiteit wilt toevoegen aan een beleidstoewijzing, volgt u het voorbeeld az policy assignment identity assign commands.

Machtigingen verlenen aan de beheerde identiteit via gedefinieerde rollen

Belangrijk

Als de beheerde identiteit niet beschikt over de machtigingen die nodig zijn om de vereiste hersteltaak uit te voeren, wordt deze automatisch alleen via de portal machtigingen verleend. U kunt deze stap overslaan als u een beheerde identiteit maakt via de portal.

Voor alle andere methoden moet de beheerde identiteit van de toewijzing handmatig toegang krijgen via het toevoegen van rollen, anders mislukt de herstelimplementatie.

Voorbeeldscenario's waarvoor handmatige machtigingen zijn vereist:

• Als de toewijzing wordt gemaakt via een Azure Software Development Kit (SDK)
• Als een resource is gewijzigd door deployIfNotExists of modify buiten het bereik van de beleidstoewijzing valt
• Als de sjabloon toegang heeft tot eigenschappen voor resources buiten het bereik van de beleidstoewijzing

Portal

Er zijn twee manieren om de beheerde identiteit van een toewijzing de gedefinieerde rollen te verlenen met behulp van de portal: met behulp van Toegangsbeheer (IAM) of door het beleid of initiatieftoewijzing te bewerken en Opslaan te selecteren.

Voer de volgende stappen uit om een rol toe te voegen aan de beheerde identiteit van de toewijzing:

1. Start de Azure Policy-service in Azure Portal door Alle services te selecteren en dan Beleid te zoeken en te selecteren.

2. Selecteer Toewijzingen in het linkerdeelvenster van de Azure Policy-pagina.

3. Zoek de toewijzing met een beheerde identiteit en selecteer de naam.

4. Zoek de eigenschap Toewijzings-id op de bewerkingspagina. De toewijzings-id ziet eruit als in het volgende voorbeeld:

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

   De naam van de beheerde identiteit is het laatste gedeelte van de resource-id van de toewijzing, in 2802056bfc094dfb95d4d7a5 dit voorbeeld. Kopieer dit gedeelte van de resource-id van de toewijzing.

5. Navigeer naar de resource of de bovenliggende resourcecontainer (resourcegroep, abonnement, beheergroep) waarvoor de roldefinitie handmatig moet worden toegevoegd.

6. Selecteer de koppeling Toegangsbeheer (IAM) op de pagina resources en selecteer vervolgens + Roltoewijzing toevoegen boven aan de pagina toegangsbeheer.

7. Selecteer de juiste rol die overeenkomt met een roleDefinitionIds rol in de beleidsdefinitie. Laat Toewijzen staan om de standaardwaarde 'gebruiker, groep of toepassing' in te stellen. Plak of typ in het vak Selecteren het gedeelte van de resource-id van de toewijzing die u eerder hebt gevonden. Zodra de zoekopdracht is voltooid, selecteert u het object met dezelfde naam om de id te selecteren en selecteert u Opslaan.

PowerShell

De nieuwe beheerde identiteit moet de replicatie voltooien via Microsoft Entra-id voordat de benodigde rollen kunnen worden toegekend. Zodra de replicatie is voltooid, herhalen de volgende voorbeelden de beleidsdefinitie $policyDef voor de roleDefinitionIds en gebruikt New-AzRoleAssignment om de nieuwe beheerde identiteit de rollen te verlenen.

In het eerste voorbeeld ziet u hoe u rollen in het beleidsbereik kunt verlenen. In het tweede voorbeeld ziet u hoe u rollen toegeeft aan het bereik van het initiatief (beleidsset).

###################################################
# 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
  }
}

Azure-CLI

De nieuwe beheerde identiteit moet de replicatie voltooien via Microsoft Entra-id voordat de benodigde rollen kunnen worden toegekend. Zodra de replicatie is voltooid, moeten de rollen die zijn opgegeven in de beleidsdefinitie roleDefinitionIds , worden verleend aan de beheerde identiteit.

Open de rollen die zijn opgegeven in de beleidsdefinitie met behulp van de opdracht az policy definition show en herhaal roleDefinitionIds de rollen vervolgens om de roltoewijzing te maken met behulp van de opdracht az role assignment create .

Een hersteltaak maken

Portal

Start de Azure Policy-service in Azure Portal door Alle services te selecteren en dan Beleid te zoeken en te selecteren.

Stap 1: Het maken van hersteltaken initiëren

Er zijn drie manieren om een hersteltaak te maken via de portal.

Optie 1: Een hersteltaak maken op de pagina Herstel

1. Selecteer Herstel aan de linkerkant van de Azure Policy-pagina.

   

2. Alle deployIfNotExists toewijzingen en modify beleidstoewijzingen worden weergegeven op het tabblad Beleid om te herstellen . Selecteer een met resources die niet compatibel zijn om de pagina Nieuwe hersteltaak te openen.

3. Volg de stappen om details van hersteltaken op te geven.

Optie 2: Een hersteltaak maken op basis van een niet-compatibele beleidstoewijzing

1. Selecteer Naleving aan de linkerkant van de pagina Azure Policy.

2. Selecteer een niet-conform beleid of initiatieftoewijzing met deployIfNotExists of modify effecten.

3. Selecteer de knop Hersteltaak maken boven aan de pagina om de pagina Nieuwe hersteltaak te openen.

4. Volg de stappen om details van hersteltaken op te geven.

Optie 3: Een hersteltaak maken tijdens beleidstoewijzing

Als de beleids- of initiatiefdefinitie die moet worden toegewezen een deployIfNotExists of meer modify effect heeft, biedt het tabblad Herstel van de wizard een optie Een hersteltaak maken, waarmee een hersteltaak wordt gemaakt op hetzelfde moment als de beleidstoewijzing.

Notitie

Dit is de meest gestroomlijnde benadering voor het maken van een hersteltaak en wordt ondersteund voor beleidsregels die zijn toegewezen aan een abonnement. Voor beleidsregels die zijn toegewezen aan een beheergroep, moeten hersteltaken worden gemaakt met optie 1 of optie 2 nadat de evaluatie de resourcenaleving heeft vastgesteld.

1. Navigeer vanuit de toewijzingswizard in de portal naar het tabblad Herstel . Schakel het selectievakje voor Een hersteltaak maken in.

2. Als de hersteltaak wordt gestart vanuit een initiatieftoewijzing, selecteert u het beleid dat u wilt herstellen in de vervolgkeuzelijst.

3. Configureer de beheerde identiteit en vul de rest van de wizard in. De hersteltaak wordt gemaakt wanneer de toewijzing wordt gemaakt.

Stap 2: Details van hersteltaak opgeven

Deze stap is alleen van toepassing wanneer u optie 1 of optie 2 gebruikt om het maken van hersteltaken te initiëren.

1. Als de hersteltaak wordt gestart vanuit een initiatieftoewijzing, selecteert u het beleid dat u wilt herstellen in de vervolgkeuzelijst. Een deployIfNotExists of modify beleid kan worden hersteld via één hersteltaak tegelijk.

2. U kunt eventueel herstelinstellingen op de pagina wijzigen. Zie de structuur van hersteltaken voor informatie over wat elke instelling bepaalt.

3. Filter op dezelfde pagina de resources die u wilt herstellen met behulp van het beletselteken bereik om onderliggende resources te kiezen van waaruit het beleid is toegewezen (inclusief de afzonderlijke resourceobjecten). Gebruik ook de vervolgkeuzelijst Locaties om de resources verder te filteren.

   

4. Begin de hersteltaak nadat de resources zijn gefilterd door Herstel te selecteren. De pagina beleidsnaleving wordt geopend op het tabblad Hersteltaken om de status van de voortgang van de taken weer te geven. Implementaties die door de hersteltaak zijn gemaakt, beginnen meteen.

   

Stap 3: Voortgang van hersteltaak bijhouden

1. Navigeer naar het tabblad Hersteltaken op de pagina Herstel . Selecteer een hersteltaak om details weer te geven over de gebruikte filters, de huidige status en een lijst met resources die worden hersteld.

2. Klik op de pagina Met details van de hersteltaak met de rechtermuisknop op een resource om de implementatie van de hersteltaak of de resource weer te geven. Selecteer aan het einde van de rij Gerelateerde gebeurtenissen om details weer te geven, zoals een foutbericht.

   

Resources die zijn geïmplementeerd via een hersteltaak , worden toegevoegd aan het tabblad Geïmplementeerde resources op de pagina met beleidstoewijzingsgegevens.

PowerShell

Gebruik de Start-AzPolicyRemediation opdrachten om een hersteltaak te maken met Azure PowerShell. Vervang {subscriptionId} door uw abonnements-id en {myAssignmentId} door uw deployIfNotExists of modify beleidstoewijzings-id.

# 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}'

U kunt er ook voor kiezen om herstelinstellingen aan te passen via deze optionele parameters:

• -FailureThreshold - Wordt gebruikt om op te geven of de hersteltaak moet mislukken als het percentage fouten de opgegeven drempelwaarde overschrijdt. Opgegeven als een getal tussen 0 en 100. Standaard is de drempelwaarde voor fouten 100%.
• -ResourceCount - Bepaalt hoeveel niet-compatibele resources moeten worden hersteld in een bepaalde hersteltaak. De standaardwaarde is 500 (de vorige limiet). Het maximumaantal is 50.000 resources.
• -ParallelDeploymentCount - Bepaalt hoeveel resources tegelijkertijd moeten worden hersteld. De toegestane waarden zijn 1 tot 30 resources tegelijk. De standaardwaarde is 10.

Zie de Module Az.PolicyInsights voor meer herstel-cmdlets en voorbeelden.

Azure-CLI

Gebruik de az policy remediation opdrachten om een hersteltaak te maken met Azure CLI. Vervang {subscriptionId} door uw abonnements-id en {myAssignmentId} door uw deployIfNotExists of modify beleidstoewijzings-id.

# 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}'

Zie de az policy remediation commands voor meer herstelopdrachten en voorbeelden.

Volgende stappen

• Bekijk voorbeelden in Azure Policy-voorbeelden.
• Lees over de structuur van Azure Policy-definities.
• Lees Informatie over de effecten van het beleid.
• Meer informatie over het programmatisch maken van beleid.
• Meer informatie over het ophalen van nalevingsgegevens.
• Bekijk wat een beheergroep is met Uw resources organiseren met Azure-beheergroepen.