Microsoft.Cdn Profiles/securityPolicies 2020-09-01

Bicep-Ressourcendefinition

Der Ressourcentyp "profiles/securityPolicies" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Verwendungsbeispiele

Bicep-Beispiele

Ein grundlegendes Beispiel für die Bereitstellung der Front Door-Sicherheitsrichtlinie (Standard/Premium).

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource profile 'Microsoft.Cdn/profiles@2021-06-01' = {
  name: resourceName
  location: 'global'
  sku: {
    name: 'Premium_AzureFrontDoor'
  }
  properties: {
    originResponseTimeoutSeconds: 120
  }
}

resource securityPolicy 'Microsoft.Cdn/profiles/securityPolicies@2021-06-01' = {
  name: resourceName
  parent: profile
  properties: {
    parameters: {
      associations: [
        {
          domains: [
            {
              id: customDomain.id
            }
          ]
          patternsToMatch: [
            '/*'
          ]
        }
      ]
      type: 'WebApplicationFirewall'
      wafPolicy: {
        id: frontDoorWebApplicationFirewallPolicy.id
      }
    }
  }
}

resource frontDoorWebApplicationFirewallPolicy 'Microsoft.Network/FrontDoorWebApplicationFirewallPolicies@2020-11-01' = {
  name: resourceName
  location: 'global'
  sku: {
    name: 'Premium_AzureFrontDoor'
  }
  properties: {
    customRules: {
      rules: [
        {
          action: 'Block'
          enabledState: 'Enabled'
          matchConditions: [
            {
              matchValue: [
                '192.168.1.0/24'
                '10.0.0.0/24'
              ]
              matchVariable: 'RemoteAddr'
              negateCondition: false
              operator: 'IPMatch'
            }
          ]
          name: 'Rule1'
          priority: 1
          rateLimitDurationInMinutes: 1
          rateLimitThreshold: 10
          ruleType: 'MatchRule'
        }
      ]
    }
    managedRules: {
      managedRuleSets: [
        {
          ruleGroupOverrides: [
            {
              ruleGroupName: 'PHP'
              rules: [
                {
                  action: 'Block'
                  enabledState: 'Disabled'
                  ruleId: '933111'
                }
              ]
            }
          ]
          ruleSetAction: 'Block'
          ruleSetType: 'DefaultRuleSet'
          ruleSetVersion: 'preview-0.1'
        }
        {
          ruleSetAction: 'Block'
          ruleSetType: 'BotProtection'
          ruleSetVersion: 'preview-0.1'
        }
      ]
    }
    policySettings: {
      customBlockResponseBody: 'PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=='
      customBlockResponseStatusCode: 403
      enabledState: 'Enabled'
      mode: 'Prevention'
      redirectUrl: 'https://www.fabrikam.com'
    }
  }
}

resource dnsZone 'Microsoft.Network/dnsZones@2018-05-01' = {
  name: '${resourceName}.com'
  location: 'global'
}

resource customDomain 'Microsoft.Cdn/profiles/customDomains@2021-06-01' = {
  name: resourceName
  parent: profile
  properties: {
    azureDnsZone: {
      id: dnsZone.id
    }
    hostName: 'fabrikam.${resourceName}.com'
    tlsSettings: {
      certificateType: 'ManagedCertificate'
      minimumTlsVersion: 'TLS12'
    }
  }
}

Von Azure verifizierte Module

Die folgenden Azure Verified Modules können verwendet werden, um diesen Ressourcentyp bereitzustellen.

Module BESCHREIBUNG
CDN-Profil – Sicherheitspolitik AVM-Kindmodul für CDN-Profil – Sicherheitspolitik

Azure-Schnellstartbeispiele

Die folgenden Azure-Schnellstartvorlagen Bicep-Beispiele für die Bereitstellung dieses Ressourcentyps enthalten.

Bicep-Datei BESCHREIBUNG
Front Door Premium mit Blob-Ursprung und privatem Link Diese Vorlage erstellt einen Front Door Premium- und einen Azure Storage-BLOB-Container und verwendet einen privaten Endpunkt für Front Door, um Datenverkehr an das Speicherkonto zu senden.
Front Door Premium mit WAF- und von Microsoft verwalteten Regelsätzen Diese Vorlage erstellt eine Front Door Premium einschließlich einer Webanwendungsfirewall mit den von Microsoft verwalteten Standard- und Bot-Schutzregelsätzen.
Front Door Standard/Premium mit Geofilterung Diese Vorlage erstellt einen Front Door Standard/Premium einschließlich einer Webanwendungsfirewall mit einer Geofilterregel.
Front Door Standard/Premium mit Zinslimit Diese Vorlage erstellt einen Front Door Standard/Premium einschließlich einer Webanwendungsfirewall mit einer Satzgrenzregel.
Front Door Standard/Premium mit WAF und benutzerdefinierter Regel Diese Vorlage erstellt einen Front Door Standard/Premium einschließlich einer Webanwendungsfirewall mit einer benutzerdefinierten Regel.
Front Door mit Blob-Ursprüngen für blobs uploads Diese Vorlage erstellt eine Front Door mit Ursprüngen, Routen und RuleSets und einem Azure Storage-Konto mit BLOB-Containern. Front Door sendet Datenverkehr an die Speicherkonten beim Hochladen von Dateien.
FrontDoor CDN mit WAF, Domänen und Protokollen an EventHub Diese Vorlage erstellt ein neues Azure FrontDoor CDN-Profil. Erstellen Sie WAF mit benutzerdefinierten und verwalteten Regeln, cdn-Routen, Ursprung und Gruppen mit ihrer Zuordnung zu WAF und Routen, konfiguriert benutzerdefinierte Domänen, erstellen Sie Event Hub- und Diagnoseeinstellungen zum Senden von CDN-Zugriffsprotokollen mithilfe des Event Hubs.
Durch Azure Frontdoor gesicherte Funktions-App Mit dieser Vorlage können Sie eine azure Premium-Funktion bereitstellen, die durch Azure Frontdoor Premium geschützt und veröffentlicht wird. Die Verbindung zwischen Azure Frontdoor und Azure Functions ist durch azure Private Link geschützt.

Ressourcenformat

Um eine Microsoft.Cdn/profiles/securityPolicies-Ressource zu erstellen, fügen Sie ihrer Vorlage die folgende Bicep hinzu.

resource symbolicname 'Microsoft.Cdn/profiles/securityPolicies@2020-09-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    parameters: {
      type: 'string'
      // For remaining properties, see SecurityPolicyParameters objects
    }
  }
}

SecurityPolicyParameters-Objekte

Legen Sie den Typ Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für WebApplicationFirewall Folgendes:

{
  associations: [
    {
      domains: [
        {
          id: 'string'
        }
      ]
      patternsToMatch: [
        'string'
      ]
    }
  ]
  type: 'WebApplicationFirewall'
  wafPolicy: {
    id: 'string'
  }
}

Eigenschaftswerte

Microsoft.Cdn/profiles/securityPolicies

Name BESCHREIBUNG Wert
Name Der Ressourcenname Zeichenfolge (erforderlich)
Elternteil In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird.

Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource.
Symbolischer Name für Ressource vom Typ: Profile
Eigenschaften Das JSON-Objekt, das Eigenschaften enthält, die zum Erstellen einer Sicherheitsrichtlinie erforderlich sind SecurityPolicyProperties-

ResourceReference (Ressource)

Name BESCHREIBUNG Wert
id Ressourcen-ID. Schnur

SecurityPolicyParameters

Name BESCHREIBUNG Wert
Typ Auf 'WebApplicationFirewall' für den Typ "SecurityPolicyWebApplicationFirewallParameters" festgelegt. 'WebApplicationFirewall' (erforderlich)

SecurityPolicyEigenschaften

Name BESCHREIBUNG Wert
Parameter Objekt, das Sicherheitsrichtlinienparameter enthält SecurityPolicyParameters

SicherheitRichtlinieWebApplicationFirewallAssociation

Name BESCHREIBUNG Wert
Domänen Liste der Domänen. ResourceReference-[]
patternsToMatch Liste der Pfade Zeichenfolge[]

SicherheitRichtlinieWebApplicationFirewallParameter

Name BESCHREIBUNG Wert
Vereinigungen Waf-Zuordnungen SicherheitRichtlinieWebApplicationFirewallAssociation[]
Typ Der Typ der zu erstellenden Sicherheitsrichtlinie. 'WebApplicationFirewall' (erforderlich)
waf-Richtlinie Ressourcen-ID. ResourceReference-

ARM-Vorlagenressourcendefinition

Der Ressourcentyp "profiles/securityPolicies" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Verwendungsbeispiele

Azure-Schnellstartvorlagen

Die folgenden Azure-Schnellstartvorlagen diesen Ressourcentyp bereitstellen.

Schablone BESCHREIBUNG
Front Door Premium mit Blob-Ursprung und privatem Link

Bereitstellung in Azure
Diese Vorlage erstellt einen Front Door Premium- und einen Azure Storage-BLOB-Container und verwendet einen privaten Endpunkt für Front Door, um Datenverkehr an das Speicherkonto zu senden.
Front Door Premium mit WAF- und von Microsoft verwalteten Regelsätzen

Bereitstellung in Azure
Diese Vorlage erstellt eine Front Door Premium einschließlich einer Webanwendungsfirewall mit den von Microsoft verwalteten Standard- und Bot-Schutzregelsätzen.
Front Door Standard/Premium mit Geofilterung

Bereitstellung in Azure
Diese Vorlage erstellt einen Front Door Standard/Premium einschließlich einer Webanwendungsfirewall mit einer Geofilterregel.
Front Door Standard/Premium mit Zinslimit

Bereitstellung in Azure
Diese Vorlage erstellt einen Front Door Standard/Premium einschließlich einer Webanwendungsfirewall mit einer Satzgrenzregel.
Front Door Standard/Premium mit WAF und benutzerdefinierter Regel

Bereitstellung in Azure
Diese Vorlage erstellt einen Front Door Standard/Premium einschließlich einer Webanwendungsfirewall mit einer benutzerdefinierten Regel.
Front Door mit Blob-Ursprüngen für blobs uploads

Bereitstellung in Azure
Diese Vorlage erstellt eine Front Door mit Ursprüngen, Routen und RuleSets und einem Azure Storage-Konto mit BLOB-Containern. Front Door sendet Datenverkehr an die Speicherkonten beim Hochladen von Dateien.
FrontDoor CDN mit WAF, Domänen und Protokollen an EventHub

Bereitstellung in Azure
Diese Vorlage erstellt ein neues Azure FrontDoor CDN-Profil. Erstellen Sie WAF mit benutzerdefinierten und verwalteten Regeln, cdn-Routen, Ursprung und Gruppen mit ihrer Zuordnung zu WAF und Routen, konfiguriert benutzerdefinierte Domänen, erstellen Sie Event Hub- und Diagnoseeinstellungen zum Senden von CDN-Zugriffsprotokollen mithilfe des Event Hubs.
Durch Azure Frontdoor gesicherte Funktions-App

Bereitstellung in Azure
Mit dieser Vorlage können Sie eine azure Premium-Funktion bereitstellen, die durch Azure Frontdoor Premium geschützt und veröffentlicht wird. Die Verbindung zwischen Azure Frontdoor und Azure Functions ist durch azure Private Link geschützt.

Ressourcenformat

Um eine Microsoft.Cdn/profiles/securityPolicies-Ressource zu erstellen, fügen Sie Der Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.Cdn/profiles/securityPolicies",
  "apiVersion": "2020-09-01",
  "name": "string",
  "properties": {
    "parameters": {
      "type": "string"
      // For remaining properties, see SecurityPolicyParameters objects
    }
  }
}

SecurityPolicyParameters-Objekte

Legen Sie den Typ Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für WebApplicationFirewall Folgendes:

{
  "associations": [
    {
      "domains": [
        {
          "id": "string"
        }
      ],
      "patternsToMatch": [ "string" ]
    }
  ],
  "type": "WebApplicationFirewall",
  "wafPolicy": {
    "id": "string"
  }
}

Eigenschaftswerte

Microsoft.Cdn/profiles/securityPolicies

Name BESCHREIBUNG Wert
apiVersion (Englisch) Die API-Version '2020-09-01'
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eigenschaften Das JSON-Objekt, das Eigenschaften enthält, die zum Erstellen einer Sicherheitsrichtlinie erforderlich sind SecurityPolicyProperties-
Typ Der Ressourcentyp "Microsoft.Cdn/profiles/securityPolicies"

ResourceReference (Ressource)

Name BESCHREIBUNG Wert
id Ressourcen-ID. Schnur

SecurityPolicyParameters

Name BESCHREIBUNG Wert
Typ Auf 'WebApplicationFirewall' für den Typ "SecurityPolicyWebApplicationFirewallParameters" festgelegt. 'WebApplicationFirewall' (erforderlich)

SecurityPolicyEigenschaften

Name BESCHREIBUNG Wert
Parameter Objekt, das Sicherheitsrichtlinienparameter enthält SecurityPolicyParameters

SicherheitRichtlinieWebApplicationFirewallAssociation

Name BESCHREIBUNG Wert
Domänen Liste der Domänen. ResourceReference-[]
patternsToMatch Liste der Pfade Zeichenfolge[]

SicherheitRichtlinieWebApplicationFirewallParameter

Name BESCHREIBUNG Wert
Vereinigungen Waf-Zuordnungen SicherheitRichtlinieWebApplicationFirewallAssociation[]
Typ Der Typ der zu erstellenden Sicherheitsrichtlinie. 'WebApplicationFirewall' (erforderlich)
waf-Richtlinie Ressourcen-ID. ResourceReference-

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp "profiles/securityPolicies" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Change Log.

Verwendungsbeispiele

Terraform-Beispiele

Ein grundlegendes Beispiel für die Bereitstellung der Front Door-Sicherheitsrichtlinie (Standard/Premium).

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "dnsZone" {
  type                      = "Microsoft.Network/dnsZones@2018-05-01"
  parent_id                 = azapi_resource.resourceGroup.id
  name                      = "${var.resource_name}.com"
  location                  = "global"
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "profile" {
  type      = "Microsoft.Cdn/profiles@2021-06-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = "global"
  body = {
    properties = {
      originResponseTimeoutSeconds = 120
    }
    sku = {
      name = "Premium_AzureFrontDoor"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "FrontDoorWebApplicationFirewallPolicy" {
  type      = "Microsoft.Network/FrontDoorWebApplicationFirewallPolicies@2020-11-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = "global"
  body = {
    properties = {
      customRules = {
        rules = [
          {
            action       = "Block"
            enabledState = "Enabled"
            matchConditions = [
              {
                matchValue = [
                  "192.168.1.0/24",
                  "10.0.0.0/24",
                ]
                matchVariable   = "RemoteAddr"
                negateCondition = false
                operator        = "IPMatch"
              },
            ]
            name                       = "Rule1"
            priority                   = 1
            rateLimitDurationInMinutes = 1
            rateLimitThreshold         = 10
            ruleType                   = "MatchRule"
          },
        ]
      }
      managedRules = {
        managedRuleSets = [
          {
            ruleGroupOverrides = [
              {
                ruleGroupName = "PHP"
                rules = [
                  {
                    action       = "Block"
                    enabledState = "Disabled"
                    ruleId       = "933111"
                  },
                ]
              },
            ]
            ruleSetAction  = "Block"
            ruleSetType    = "DefaultRuleSet"
            ruleSetVersion = "preview-0.1"
          },
          {
            ruleSetAction  = "Block"
            ruleSetType    = "BotProtection"
            ruleSetVersion = "preview-0.1"
          },
        ]
      }
      policySettings = {
        customBlockResponseBody       = "PGh0bWw+CjxoZWFkZXI+PHRpdGxlPkhlbGxvPC90aXRsZT48L2hlYWRlcj4KPGJvZHk+CkhlbGxvIHdvcmxkCjwvYm9keT4KPC9odG1sPg=="
        customBlockResponseStatusCode = 403
        enabledState                  = "Enabled"
        mode                          = "Prevention"
        redirectUrl                   = "https://www.fabrikam.com"
      }
    }
    sku = {
      name = "Premium_AzureFrontDoor"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "customDomain" {
  type      = "Microsoft.Cdn/profiles/customDomains@2021-06-01"
  parent_id = azapi_resource.profile.id
  name      = var.resource_name
  body = {
    properties = {
      azureDnsZone = {
        id = azapi_resource.dnsZone.id
      }
      hostName = "fabrikam.${var.resource_name}.com"
      tlsSettings = {
        certificateType   = "ManagedCertificate"
        minimumTlsVersion = "TLS12"
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "securityPolicy" {
  type      = "Microsoft.Cdn/profiles/securityPolicies@2021-06-01"
  parent_id = azapi_resource.profile.id
  name      = var.resource_name
  body = {
    properties = {
      parameters = {
        associations = [
          {
            domains = [
              {
                id = azapi_resource.customDomain.id
              },
            ]
            patternsToMatch = [
              "/*",
            ]
          },
        ]
        type = "WebApplicationFirewall"
        wafPolicy = {
          id = azapi_resource.FrontDoorWebApplicationFirewallPolicy.id
        }
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Ressourcenformat

Um eine Microsoft.Cdn/profiles/securityPolicies-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Cdn/profiles/securityPolicies@2020-09-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      parameters = {
        type = "string"
        // For remaining properties, see SecurityPolicyParameters objects
      }
    }
  }
}

SecurityPolicyParameters-Objekte

Legen Sie den Typ Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für WebApplicationFirewall Folgendes:

{
  associations = [
    {
      domains = [
        {
          id = "string"
        }
      ]
      patternsToMatch = [
        "string"
      ]
    }
  ]
  type = "WebApplicationFirewall"
  wafPolicy = {
    id = "string"
  }
}

Eigenschaftswerte

Microsoft.Cdn/profiles/securityPolicies

Name BESCHREIBUNG Wert
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eltern-ID Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource des Typs: Profile
Eigenschaften Das JSON-Objekt, das Eigenschaften enthält, die zum Erstellen einer Sicherheitsrichtlinie erforderlich sind SecurityPolicyProperties-
Typ Der Ressourcentyp "Microsoft.Cdn/profiles/securityPolicies@2020-09-01"

ResourceReference (Ressource)

Name BESCHREIBUNG Wert
id Ressourcen-ID. Schnur

SecurityPolicyParameters

Name BESCHREIBUNG Wert
Typ Auf 'WebApplicationFirewall' für den Typ "SecurityPolicyWebApplicationFirewallParameters" festgelegt. 'WebApplicationFirewall' (erforderlich)

SecurityPolicyEigenschaften

Name BESCHREIBUNG Wert
Parameter Objekt, das Sicherheitsrichtlinienparameter enthält SecurityPolicyParameters

SicherheitRichtlinieWebApplicationFirewallAssociation

Name BESCHREIBUNG Wert
Domänen Liste der Domänen. ResourceReference-[]
patternsToMatch Liste der Pfade Zeichenfolge[]

SicherheitRichtlinieWebApplicationFirewallParameter

Name BESCHREIBUNG Wert
Vereinigungen Waf-Zuordnungen SicherheitRichtlinieWebApplicationFirewallAssociation[]
Typ Der Typ der zu erstellenden Sicherheitsrichtlinie. 'WebApplicationFirewall' (erforderlich)
waf-Richtlinie Ressourcen-ID. ResourceReference-