Partilhar via


Microsoft.Network FrontDoorWebApplicationFirewallPolicies 2018-08-01

Definição de recursos do bíceps

O tipo de recurso FrontDoorWebApplicationFirewallPolicies pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Network/FrontDoorWebApplicationFirewallPolicies, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.Network/FrontDoorWebApplicationFirewallPolicies@2018-08-01' = {
  etag: 'string'
  location: 'string'
  name: 'string'
  properties: {
    customRules: {
      rules: [
        {
          action: 'string'
          matchConditions: [
            {
              matchValue: [
                'string'
              ]
              matchVariable: 'string'
              negateCondition: bool
              operator: 'string'
              selector: 'string'
            }
          ]
          name: 'string'
          priority: int
          rateLimitDurationInMinutes: int
          rateLimitThreshold: int
          ruleType: 'string'
          transforms: [
            'string'
          ]
        }
      ]
    }
    managedRules: {
      ruleSets: [
        {
          priority: int
          version: int
          ruleSetType: 'string'
          // For remaining properties, see ManagedRuleSet objects
        }
      ]
    }
    policySettings: {
      enabledState: 'string'
      mode: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Objetos ManagedRuleSet

Defina a propriedade ruleSetType para especificar o tipo de objeto.

Para AzureManagedRuleSet , use:

{
  ruleGroupOverrides: [
    {
      action: 'string'
      ruleGroupOverride: 'string'
    }
  ]
  ruleSetType: 'AzureManagedRuleSet'
}

Valores de propriedade

AzureManagedOverrideRuleGroup

Designação Descrição Valor
ação Tipo de Ações 'Permitir'
'Bloqueio'
'Log' (obrigatório)
ruleGroupOverride Descreve o grupo de regras de substituição 'SqlInjection'
'XSS' (obrigatório)

AzureManagedRuleSet

Designação Descrição Valor
ruleGroupSubstitui Lista de configuração de substituição do provedor gerenciado do azure (opcional) AzureManagedOverrideRuleGroup[]
ruleSetType RuleSetType - AzureManagedRuleSet ou OWASP RuleSets. 'AzureManagedRuleSet' (obrigatório)

Regra Personalizada

Designação Descrição Valor
ação Tipo de Ações 'Permitir'
'Bloqueio'
'Log' (obrigatório)
matchCondições Lista de condições de jogo MatchConditionAutoGenerated[] (obrigatório)
Designação Obtém o nome do recurso que é exclusivo dentro de uma política. Esse nome pode ser usado para acessar o recurso. string

Restrições:
Comprimento máximo =
prioridade Descreve a prioridade da regra. As regras com um valor mais baixo serão avaliadas antes das regras com um valor mais elevado int (obrigatório)
rateLimitDurationInMinutes Define a duração do limite de taxa. Padrão - 1 minuto Int
rateLimitThreshold Define o limite de taxa Int
ruleType Descreve o tipo de regra 'Regra de correspondência'
'RateLimitRule' (obrigatório)
transforma Lista de transformações Matriz de cadeia de caracteres contendo qualquer uma das:
'HtmlEntityDecode'
'Minúsculas'
'RemoveNulls'
'Guarnição'
'Maiúsculas'
'UrlDecode'
'UrlEncode'

Regras Personalizadas

Designação Descrição Valor
regras Lista de regras CustomRule[]

ManagedRuleSet

Designação Descrição Valor
prioridade Descreve a prioridade da regra Int
ruleSetType Defina como 'AzureManagedRuleSet' para o tipo AzureManagedRuleSet. 'AzureManagedRuleSet' (obrigatório)
Versão define a versão do conjunto de regras Int

ManagedRuleSets

Designação Descrição Valor
ruleSets Lista de regras ManagedRuleSet []

MatchConditionAutoGenerated

Designação Descrição Valor
matchValue Valor correspondente string[] (obrigatório)
matchVariable Variável de correspondência 'PostArgs'
'QueryString'
'RemoteAddr'
'RequestBody'
'RequestHeader'
'RequestMethod'
'RequestUri' (obrigatório)
negateCondition Descreve se esta é condição negada ou não Bool
Operador Descreve o operador a ser correspondido 'Qualquer'
'Começa com'
«Contém»
'Acaba com'
'Igual'
'GeoMatch'
'MaiorQue'
'MaiorThanOrEqual'
'IPMatch'
'Menosque'
'LessThanOrEqual' (obrigatório)
seletor Nome do seletor em RequestHeader ou RequestBody a ser correspondido string

Microsoft.Network/FrontDoorWebApplicationFirewallPolicies

Designação Descrição Valor
etag Obtém uma cadeia de caracteres somente leitura exclusiva que muda sempre que o recurso é atualizado. string
Localização Localização do recurso. string
Designação O nome do recurso string

Restrições:
Comprimento máximo = (obrigatório)
propriedades Propriedades da política de firewall do aplicativo Web. WebApplicationFirewallPolicyPropertiesFormat
Etiquetas Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

Configurações de política

Designação Descrição Valor
enabledState descreve se a política está no estado habilitado ou desabilitado 'Desativado'
'Habilitado'
modo Descreve se ele está no modo de deteção ou no modo de prevenção no nível da política 'Detecção'
'Prevenção'

Tags de Recursos

Designação Descrição Valor

WebApplicationFirewallPolicyPropertiesFormat

Designação Descrição Valor
customRules Descreve regras personalizadas dentro da política CustomRules
managedRegras Descreve as regras gerenciadas dentro da política ManagedRuleSets
policySettings Descreve policySettings para política PolicySettings

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep Descrição
Configurar defaultRuleSet gerenciado pelo WAF para o Azure Front Door Este modelo configura defaultRuleSet gerenciado pelo WAF para o Azure Front Door
Front Door Premium com origem blob e Private Link Este modelo cria um Front Door Premium e um contêiner de blob de Armazenamento do Azure e usa um ponto de extremidade privado para Front Door para enviar tráfego para a conta de armazenamento.
Front Door Premium com WAF e conjuntos de regras gerenciados pela Microsoft Este modelo cria um Front Door Premium, incluindo um firewall de aplicativo Web com os conjuntos de regras padrão e de proteção de bot gerenciados pela Microsoft.
Porta dianteira Standard/Premium com de filtragem geográfica Este modelo cria um Front Door Standard/Premium, incluindo um firewall de aplicativo da Web com uma regra de filtragem geográfica.
Porta da frente Standard/Premium com limite de tarifa Este modelo cria um Front Door Standard/Premium, incluindo um firewall de aplicativo da Web com uma regra de limite de taxa.
Porta da frente Standard/Premium com WAF e regras personalizadas Este modelo cria um Front Door Standard/Premium, incluindo um firewall de aplicativo da Web com uma regra personalizada.
Front Door com origens de blob para blobs carregar Este modelo cria uma Porta de Entrada com origens, rotas e conjuntos de regras e uma conta de Armazenamento do Azure com contêineres de blob. Front Door envia tráfego para as contas de armazenamento ao carregar arquivos.
CDN FrontDoor com WAF, domínios e logs para o EventHub Este modelo cria um novo perfil cdn do Azure FrontDoor. Crie WAF com regras personalizadas e gerenciadas, rotas cdn, origem e grupos com sua associação com WAF e rotas, configure domínios personalizados, crie hub de eventos e configurações de diagnóstico para enviar logs de acesso CDN usando hub de eventos.
Function App protegido pelo Azure Frontdoor Este modelo permite implantar uma função azure premium protegida e publicada pelo Azure Frontdoor premium. A conexão entre o Azure Frontdoor e o Azure Functions é protegida pelo Azure Private Link.

Definição de recurso de modelo ARM

O tipo de recurso FrontDoorWebApplicationFirewallPolicies pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Network/FrontDoorWebApplicationFirewallPolicies, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.Network/FrontDoorWebApplicationFirewallPolicies",
  "apiVersion": "2018-08-01",
  "name": "string",
  "etag": "string",
  "location": "string",
  "properties": {
    "customRules": {
      "rules": [
        {
          "action": "string",
          "matchConditions": [
            {
              "matchValue": [ "string" ],
              "matchVariable": "string",
              "negateCondition": "bool",
              "operator": "string",
              "selector": "string"
            }
          ],
          "name": "string",
          "priority": "int",
          "rateLimitDurationInMinutes": "int",
          "rateLimitThreshold": "int",
          "ruleType": "string",
          "transforms": [ "string" ]
        }
      ]
    },
    "managedRules": {
      "ruleSets": [ {
        "priority": "int",
        "version": "int",
        "ruleSetType": "string"
        // For remaining properties, see ManagedRuleSet objects
      } ]
    },
    "policySettings": {
      "enabledState": "string",
      "mode": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Objetos ManagedRuleSet

Defina a propriedade ruleSetType para especificar o tipo de objeto.

Para AzureManagedRuleSet , use:

{
  "ruleGroupOverrides": [
    {
      "action": "string",
      "ruleGroupOverride": "string"
    }
  ],
  "ruleSetType": "AzureManagedRuleSet"
}

Valores de propriedade

AzureManagedOverrideRuleGroup

Designação Descrição Valor
ação Tipo de Ações 'Permitir'
'Bloqueio'
'Log' (obrigatório)
ruleGroupOverride Descreve o grupo de regras de substituição 'SqlInjection'
'XSS' (obrigatório)

AzureManagedRuleSet

Designação Descrição Valor
ruleGroupSubstitui Lista de configuração de substituição do provedor gerenciado do azure (opcional) AzureManagedOverrideRuleGroup[]
ruleSetType RuleSetType - AzureManagedRuleSet ou OWASP RuleSets. 'AzureManagedRuleSet' (obrigatório)

Regra Personalizada

Designação Descrição Valor
ação Tipo de Ações 'Permitir'
'Bloqueio'
'Log' (obrigatório)
matchCondições Lista de condições de jogo MatchConditionAutoGenerated[] (obrigatório)
Designação Obtém o nome do recurso que é exclusivo dentro de uma política. Esse nome pode ser usado para acessar o recurso. string

Restrições:
Comprimento máximo =
prioridade Descreve a prioridade da regra. As regras com um valor mais baixo serão avaliadas antes das regras com um valor mais elevado int (obrigatório)
rateLimitDurationInMinutes Define a duração do limite de taxa. Padrão - 1 minuto Int
rateLimitThreshold Define o limite de taxa Int
ruleType Descreve o tipo de regra 'Regra de correspondência'
'RateLimitRule' (obrigatório)
transforma Lista de transformações Matriz de cadeia de caracteres contendo qualquer uma das:
'HtmlEntityDecode'
'Minúsculas'
'RemoveNulls'
'Guarnição'
'Maiúsculas'
'UrlDecode'
'UrlEncode'

Regras Personalizadas

Designação Descrição Valor
regras Lista de regras CustomRule[]

ManagedRuleSet

Designação Descrição Valor
prioridade Descreve a prioridade da regra Int
ruleSetType Defina como 'AzureManagedRuleSet' para o tipo AzureManagedRuleSet. 'AzureManagedRuleSet' (obrigatório)
Versão define a versão do conjunto de regras Int

ManagedRuleSets

Designação Descrição Valor
ruleSets Lista de regras ManagedRuleSet []

MatchConditionAutoGenerated

Designação Descrição Valor
matchValue Valor correspondente string[] (obrigatório)
matchVariable Variável de correspondência 'PostArgs'
'QueryString'
'RemoteAddr'
'RequestBody'
'RequestHeader'
'RequestMethod'
'RequestUri' (obrigatório)
negateCondition Descreve se esta é condição negada ou não Bool
Operador Descreve o operador a ser correspondido 'Qualquer'
'Começa com'
«Contém»
'Acaba com'
'Igual'
'GeoMatch'
'MaiorQue'
'MaiorThanOrEqual'
'IPMatch'
'Menosque'
'LessThanOrEqual' (obrigatório)
seletor Nome do seletor em RequestHeader ou RequestBody a ser correspondido string

Microsoft.Network/FrontDoorWebApplicationFirewallPolicies

Designação Descrição Valor
apiVersion A versão api '2018-08-01'
etag Obtém uma cadeia de caracteres somente leitura exclusiva que muda sempre que o recurso é atualizado. string
Localização Localização do recurso. string
Designação O nome do recurso string

Restrições:
Comprimento máximo = (obrigatório)
propriedades Propriedades da política de firewall do aplicativo Web. WebApplicationFirewallPolicyPropertiesFormat
Etiquetas Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.Network/FrontDoorWebApplicationFirewallPolicies'

Configurações de política

Designação Descrição Valor
enabledState descreve se a política está no estado habilitado ou desabilitado 'Desativado'
'Habilitado'
modo Descreve se ele está no modo de deteção ou no modo de prevenção no nível da política 'Detecção'
'Prevenção'

Tags de Recursos

Designação Descrição Valor

WebApplicationFirewallPolicyPropertiesFormat

Designação Descrição Valor
customRules Descreve regras personalizadas dentro da política CustomRules
managedRegras Descreve as regras gerenciadas dentro da política ManagedRuleSets
policySettings Descreve policySettings para política PolicySettings

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Configurar a restrição de IP do cliente WAF para o Azure Front Door

Implantar no Azure
Este modelo configura a restrição de IP do cliente WAF para o ponto de extremidade da Porta da Frente do Azure
Configurar defaultRuleSet gerenciado pelo WAF para o Azure Front Door

Implantar no Azure
Este modelo configura defaultRuleSet gerenciado pelo WAF para o Azure Front Door
Configurar a regra de limagem de taxa WAF para o ponto de extremidade do Azure Front Door

Implantar no Azure
Este modelo configura uma regra WAF para o Azure Front Door para limitar o tráfego de entrada para um determinado host frontend.
Configurar regras WAF com parâmetros http para Front Door

Implantar no Azure
Este modelo configura regras personalizadas do WAF com base em parâmetros http específicos para o ponto de extremidade do Azure Front Door.
Criar a Porta da Frente do Azure em frente ao de Gerenciamento de API do Azure

Implantar no Azure
Este exemplo demonstra como usar o Azure Front Door como um balanceador de carga global na frente do Gerenciamento de API do Azure.
Criar regra de Filtragem Geográfica WAF para o ponto de extremidade do Azure Front Door

Implantar no Azure
Este modelo cria uma regra de filtragem geográfica WAF para o Azure Front Door que permite/bloqueia o tráfego de determinados países.
Front Door Premium com origem blob e Private Link

Implantar no Azure
Este modelo cria um Front Door Premium e um contêiner de blob de Armazenamento do Azure e usa um ponto de extremidade privado para Front Door para enviar tráfego para a conta de armazenamento.
Front Door Premium com WAF e conjuntos de regras gerenciados pela Microsoft

Implantar no Azure
Este modelo cria um Front Door Premium, incluindo um firewall de aplicativo Web com os conjuntos de regras padrão e de proteção de bot gerenciados pela Microsoft.
Porta dianteira Standard/Premium com de filtragem geográfica

Implantar no Azure
Este modelo cria um Front Door Standard/Premium, incluindo um firewall de aplicativo da Web com uma regra de filtragem geográfica.
Porta da frente Standard/Premium com limite de tarifa

Implantar no Azure
Este modelo cria um Front Door Standard/Premium, incluindo um firewall de aplicativo da Web com uma regra de limite de taxa.
Porta da frente Standard/Premium com WAF e regras personalizadas

Implantar no Azure
Este modelo cria um Front Door Standard/Premium, incluindo um firewall de aplicativo da Web com uma regra personalizada.
Front Door com origens de blob para blobs carregar

Implantar no Azure
Este modelo cria uma Porta de Entrada com origens, rotas e conjuntos de regras e uma conta de Armazenamento do Azure com contêineres de blob. Front Door envia tráfego para as contas de armazenamento ao carregar arquivos.
CDN FrontDoor com WAF, domínios e logs para o EventHub

Implantar no Azure
Este modelo cria um novo perfil cdn do Azure FrontDoor. Crie WAF com regras personalizadas e gerenciadas, rotas cdn, origem e grupos com sua associação com WAF e rotas, configure domínios personalizados, crie hub de eventos e configurações de diagnóstico para enviar logs de acesso CDN usando hub de eventos.
Function App protegido pelo Azure Frontdoor

Implantar no Azure
Este modelo permite implantar uma função azure premium protegida e publicada pelo Azure Frontdoor premium. A conexão entre o Azure Frontdoor e o Azure Functions é protegida pelo Azure Private Link.

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso FrontDoorWebApplicationFirewallPolicies pode ser implantado com operações direcionadas:

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Network/FrontDoorWebApplicationFirewallPolicies, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/FrontDoorWebApplicationFirewallPolicies@2018-08-01"
  name = "string"
  etag = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      customRules = {
        rules = [
          {
            action = "string"
            matchConditions = [
              {
                matchValue = [
                  "string"
                ]
                matchVariable = "string"
                negateCondition = bool
                operator = "string"
                selector = "string"
              }
            ]
            name = "string"
            priority = int
            rateLimitDurationInMinutes = int
            rateLimitThreshold = int
            ruleType = "string"
            transforms = [
              "string"
            ]
          }
        ]
      }
      managedRules = {
        ruleSets = [
          {
            priority = int
            version = int
            ruleSetType = "string"
            // For remaining properties, see ManagedRuleSet objects
          }
        ]
      }
      policySettings = {
        enabledState = "string"
        mode = "string"
      }
    }
  })
}

Objetos ManagedRuleSet

Defina a propriedade ruleSetType para especificar o tipo de objeto.

Para AzureManagedRuleSet , use:

{
  ruleGroupOverrides = [
    {
      action = "string"
      ruleGroupOverride = "string"
    }
  ]
  ruleSetType = "AzureManagedRuleSet"
}

Valores de propriedade

AzureManagedOverrideRuleGroup

Designação Descrição Valor
ação Tipo de Ações 'Permitir'
'Bloqueio'
'Log' (obrigatório)
ruleGroupOverride Descreve o grupo de regras de substituição 'SqlInjection'
'XSS' (obrigatório)

AzureManagedRuleSet

Designação Descrição Valor
ruleGroupSubstitui Lista de configuração de substituição do provedor gerenciado do azure (opcional) AzureManagedOverrideRuleGroup[]
ruleSetType RuleSetType - AzureManagedRuleSet ou OWASP RuleSets. 'AzureManagedRuleSet' (obrigatório)

Regra Personalizada

Designação Descrição Valor
ação Tipo de Ações 'Permitir'
'Bloqueio'
'Log' (obrigatório)
matchCondições Lista de condições de jogo MatchConditionAutoGenerated[] (obrigatório)
Designação Obtém o nome do recurso que é exclusivo dentro de uma política. Esse nome pode ser usado para acessar o recurso. string

Restrições:
Comprimento máximo =
prioridade Descreve a prioridade da regra. As regras com um valor mais baixo serão avaliadas antes das regras com um valor mais elevado int (obrigatório)
rateLimitDurationInMinutes Define a duração do limite de taxa. Padrão - 1 minuto Int
rateLimitThreshold Define o limite de taxa Int
ruleType Descreve o tipo de regra 'Regra de correspondência'
'RateLimitRule' (obrigatório)
transforma Lista de transformações Matriz de cadeia de caracteres contendo qualquer uma das:
'HtmlEntityDecode'
'Minúsculas'
'RemoveNulls'
'Guarnição'
'Maiúsculas'
'UrlDecode'
'UrlEncode'

Regras Personalizadas

Designação Descrição Valor
regras Lista de regras CustomRule[]

ManagedRuleSet

Designação Descrição Valor
prioridade Descreve a prioridade da regra Int
ruleSetType Defina como 'AzureManagedRuleSet' para o tipo AzureManagedRuleSet. 'AzureManagedRuleSet' (obrigatório)
Versão define a versão do conjunto de regras Int

ManagedRuleSets

Designação Descrição Valor
ruleSets Lista de regras ManagedRuleSet []

MatchConditionAutoGenerated

Designação Descrição Valor
matchValue Valor correspondente string[] (obrigatório)
matchVariable Variável de correspondência 'PostArgs'
'QueryString'
'RemoteAddr'
'RequestBody'
'RequestHeader'
'RequestMethod'
'RequestUri' (obrigatório)
negateCondition Descreve se esta é condição negada ou não Bool
Operador Descreve o operador a ser correspondido 'Qualquer'
'Começa com'
«Contém»
'Acaba com'
'Igual'
'GeoMatch'
'MaiorQue'
'MaiorThanOrEqual'
'IPMatch'
'Menosque'
'LessThanOrEqual' (obrigatório)
seletor Nome do seletor em RequestHeader ou RequestBody a ser correspondido string

Microsoft.Network/FrontDoorWebApplicationFirewallPolicies

Designação Descrição Valor
etag Obtém uma cadeia de caracteres somente leitura exclusiva que muda sempre que o recurso é atualizado. string
Localização Localização do recurso. string
Designação O nome do recurso string

Restrições:
Comprimento máximo = (obrigatório)
propriedades Propriedades da política de firewall do aplicativo Web. WebApplicationFirewallPolicyPropertiesFormat
Etiquetas Etiquetas de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.Network/FrontDoorWebApplicationFirewallPolicies@2018-08-01"

Configurações de política

Designação Descrição Valor
enabledState descreve se a política está no estado habilitado ou desabilitado 'Desativado'
'Habilitado'
modo Descreve se ele está no modo de deteção ou no modo de prevenção no nível da política 'Detecção'
'Prevenção'

Tags de Recursos

Designação Descrição Valor

WebApplicationFirewallPolicyPropertiesFormat

Designação Descrição Valor
customRules Descreve regras personalizadas dentro da política CustomRules
managedRegras Descreve as regras gerenciadas dentro da política ManagedRuleSets
policySettings Descreve policySettings para política PolicySettings