AzPolicyAdvertizer

last sync: 2021-Oct-25 16:02:14 UTC

Azure Policy definition

[Preview]: Configure supported Windows virtual machines to automatically install the Guest Attestation extension

Name [Preview]: Configure supported Windows virtual machines to automatically install the Guest Attestation extension
Azure Portal
Id 98ea2fc7-6fc6-4fd1-9d8d-6331154da071
Version 2.0.0-preview
details on versioning
Category Security Center
Microsoft docs
Description Configure supported Windows virtual machines to automatically install the Guest Attestation extension to allow Azure Security Center to proactively attest and monitor the boot integrity. Boot integrity is attested via Remote Attestation.
Mode Indexed
Type BuiltIn
Preview True
Deprecated FALSE
Effect Default: DeployIfNotExists
Allowed: (DeployIfNotExists, Disabled)
Used RBAC Role
Role Name Role Id
Virtual Machine Contributor 9980e02c-c2be-4d73-94e8-173b1dc7cf3c
History
Date/Time (UTC ymd) (i) Change type Change detail
2021-10-22 15:42:38 change Major, suffix remains equal (1.0.0-preview > 2.0.0-preview)
2021-05-04 14:34:06 add 98ea2fc7-6fc6-4fd1-9d8d-6331154da071
Used in Initiatives
Initiative DisplayName Initiative Id Initiative Category State
[Preview]: Configure prerequisites to enable Guest Attestation on Trusted Launch enabled VMs 281d9e47-d14d-4f05-b8eb-18f2c4a034ff Trusted Launch Preview
JSON Changes

JSON 
{
  "displayName": "[Preview]: Configure supported Windows virtual machines to automatically install the Guest Attestation extension",
  "policyType": "BuiltIn",
  "mode": "Indexed",
  "description": "Configure supported Windows virtual machines to automatically install the Guest Attestation extension to allow Azure Security Center to proactively attest and monitor the boot integrity. Boot integrity is attested via Remote Attestation.",
  "metadata": {
    "category": "Security Center",
    "version": "2.0.0-preview",
    "preview": true
  },
  "parameters": {
    "effect": {
      "type": "String",
      "metadata": {
        "displayName": "Effect",
        "description": "Enable or disable the execution of the policy"
      },
      "allowedValues": [
        "DeployIfNotExists",
        "Disabled"
      ],
      "defaultValue": "DeployIfNotExists"
    },
    "attestationEndpoint": {
      "type": "String",
      "metadata": {
        "displayName": "Guest attestation tenant URL",
        "description": "The Microsoft Azure Attestation (MAA) custom tenant URL."
      },
      "defaultValue": ""
    }
  },
  "policyRule": {
    "if": {
      "allOf": [
        {
          "field": "type",
          "equals": "Microsoft.Compute/virtualMachines"
        },
        {
          "field": "Microsoft.Compute/virtualMachines/storageProfile.imageReference.offer",
          "like": "windows*"
        },
        {
          "field": "Microsoft.Compute/virtualMachines/securityProfile.uefiSettings",
          "exists": "true"
        },
        {
          "field": "Microsoft.Compute/virtualMachines/securityProfile.uefiSettings.vTpmEnabled",
          "equals": "true"
        },
        {
          "field": "Microsoft.Compute/virtualMachines/securityProfile.uefiSettings.secureBootEnabled",
          "equals": "true"
        }
      ]
    },
    "then": {
      "effect": "[parameters('effect')]",
      "details": {
        "type": "Microsoft.Compute/virtualMachines/extensions",
        "existenceCondition": {
          "allOf": [
            {
              "field": "Microsoft.Compute/virtualMachines/extensions/publisher",
              "equals": "Microsoft.Azure.Security.WindowsAttestation"
            },
            {
              "field": "Microsoft.Compute/virtualMachines/extensions/type",
              "equals": "GuestAttestation"
            },
            {
              "field": "Microsoft.Compute/virtualMachines/extensions/provisioningState",
              "in": [
                "Succeeded",
                "Provisioning succeeded"
              ]
            }
          ]
        },
        "roleDefinitionIds": [
          "/providers/microsoft.authorization/roleDefinitions/9980e02c-c2be-4d73-94e8-173b1dc7cf3c"
        ],
        "deployment": {
          "properties": {
            "mode": "incremental",
            "parameters": {
              "vmName": {
                "value": "[field('name')]"
              },
              "location": {
                "value": "[field('location')]"
              },
              "attestationEndpoint": {
                "value": "[parameters('attestationEndpoint')]"
              }
            },
            "template": {
              "$schema": "http://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
              "contentVersion": "1.0.0.0",
              "parameters": {
                "vmName": {
                  "type": "string"
                },
                "location": {
                  "type": "string"
                },
                "attestationEndpoint": {
                  "type": "string"
                }
              },
              "variables": {
                "extensionName": "GuestAttestation",
                "extensionPublisher": "Microsoft.Azure.Security.WindowsAttestation",
                "extensionVersion": "1.0",
                "maaTenantName": "GuestAttestation",
                "ascReportingEndpoint": ""
              },
              "resources": [
                {
                  "type": "Microsoft.Compute/virtualMachines/extensions",
                  "apiVersion": "2018-10-01",
                  "name": "[concat(parameters('vmName'), '/', variables('extensionName'))]",
                  "location": "[parameters('location')]",
                  "properties": {
                    "publisher": "[variables('extensionPublisher')]",
                    "type": "[variables('extensionName')]",
                    "typeHandlerVersion": "[variables('extensionVersion')]",
                    "autoUpgradeMinorVersion": true,
                    "settings": {
                      "AttestationConfig": {
                        "MaaSettings": {
                          "maaEndpoint": "[parameters('attestationEndpoint')]",
                          "maaTenantName": "[variables('maaTenantName')]"
                        },
                        "AscSettings": {
                          "ascReportingEndpoint": "[variables('ascReportingEndpoint')]",
                          "ascReportingFrequency": ""
                        },
                        "useCustomToken": "false",
                        "disableAlerts": "false"
                      }
                    }
                  }
                }
              ]
            }
          }
        }
      }
    }
  }
}