Partilhar via

Microsoft.Network ApplicationGatewayWebApplicationFirewallPolicies 2019-08-01

  • Artigo

Definição de recursos do bíceps

O tipo de recurso ApplicationGatewayWebApplicationFirewallPolicies 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/ApplicationGatewayWebApplicationFirewallPolicies, adicione o seguinte Bíceps ao seu modelo.

resource symbolicname 'Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies@2019-08-01' = {
  etag: 'string'
  location: 'string'
  name: 'string'
  properties: {
    customRules: [
      {
        action: 'string'
        matchConditions: [
          {
            matchValues: [
              'string'
            ]
            matchVariables: [
              {
                selector: 'string'
                variableName: 'string'
              }
            ]
            negationConditon: bool
            operator: 'string'
            transforms: [
              'string'
            ]
          }
        ]
        name: 'string'
        priority: int
        ruleType: 'string'
      }
    ]
    managedRules: {
      exclusions: [
        {
          matchVariable: 'string'
          selector: 'string'
          selectorMatchOperator: 'string'
        }
      ]
      managedRuleSets: [
        {
          ruleGroupOverrides: [
            {
              ruleGroupName: 'string'
              rules: [
                {
                  ruleId: 'string'
                  state: 'string'
                }
              ]
            }
          ]
          ruleSetType: 'string'
          ruleSetVersion: 'string'
        }
      ]
    }
    policySettings: {
      fileUploadLimitInMb: int
      maxRequestBodySizeInKb: int
      mode: 'string'
      requestBodyCheck: bool
      state: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

ManagedRuleGroupOverride

Designação Descrição Valor
ruleGroupName Descreve o grupo de regras gerenciadas a ser substituído. string (obrigatório)
regras Lista de regras que serão desativadas. Se nenhum for especificado, todas as regras do grupo serão desativadas. ManagedRuleOverride[]

ManagedRuleOverride

Designação Descrição Valor
ruleId Identificador da regra gerenciada. string (obrigatório)
Estado Descreve o estado da regra gerenciada. O padrão é Desativado se não for especificado. 'Desativado'

ManagedRulesDefinition

Designação Descrição Valor
Exclusões Descreve as Exclusões aplicadas na política. OwaspCrsExclusionEntry[]
managedRuleSets Descreve os ruleSets associados à política. ManagedRuleSet[] (obrigatório)

ManagedRuleSet

Designação Descrição Valor
ruleGroupSubstitui Define as substituições do grupo de regras a serem aplicadas ao conjunto de regras. ManagedRuleGroupOverride[]
ruleSetType Define o tipo de conjunto de regras a ser usado. string (obrigatório)
ruleSetVersion Define a versão do conjunto de regras a ser usado. string (obrigatório)

Condição de correspondência

Designação Descrição Valor
matchValues Valor correspondente. string[] (obrigatório)
matchVariables Lista de variáveis de correspondência. MatchVariable[] (obrigatório)
negaçãoConditon Descreve se esta é condição negada ou não. Bool
Operador Descreve o operador a ser correspondido. 'Começa com'
«Contém»
'Acaba com'
'Igual'
'MaiorQue'
'MaiorThanOrEqual'
'IPMatch'
'Menosque'
'LessThanOrEqual'
«Regex» (obrigatório)
transforma Lista de transformações. Matriz de cadeia de caracteres contendo qualquer uma das:
'HtmlEntityDecode'
'Minúsculas'
'RemoveNulls'
'Guarnição'
'UrlDecode'
'UrlEncode'

MatchVariable

Designação Descrição Valor
seletor Descreve o campo da coleção matchVariable. string
nomevariável Variável de correspondência. 'PostArgs'
'QueryString'
'RemoteAddr'
'RequestBody'
'RequestCookies'
'RequestHeaders'
'RequestMethod'
'RequestUri' (obrigatório)

Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies

Designação Descrição Valor
etag 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 Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

OwaspCrsExclusionEntry

Designação Descrição Valor
matchVariable A variável a excluir. 'RequestArgNames'
'RequestCookieNames'
'RequestHeaderNames' (obrigatório)
seletor Quando matchVariable é uma coleção, operador usado para especificar a quais elementos na coleção essa exclusão se aplica. string (obrigatório)
selectorMatchOperator Quando matchVariable for uma coleção, opere no seletor para especificar a quais elementos da coleção essa exclusão se aplica. «Contém»
'Acaba com'
'Iguais'
'EqualsAny'
'StartsWith' (obrigatório)

Configurações de política

Designação Descrição Valor
arquivoUploadLimitInMb Tamanho máximo de upload de arquivo em Mb para WAF. Int

Restrições:
Valor mínimo = 0
maxRequestBodySizeInKb Tamanho máximo do corpo da solicitação em Kb para WAF. Int

Restrições:
Valor mínimo = 8
Valor máximo = 128
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'
pedidoBodyCheck Se deve permitir que o WAF verifique o corpo da solicitação. Bool
Estado Descreve se a política está no estado habilitado ou desabilitado. 'Desativado'
'Habilitado'

Tags de Recursos

Designação Descrição Valor

WebApplicationFirewallCustomRule

Designação Descrição Valor
ação Tipo de Ações. 'Permitir'
'Bloqueio'
'Log' (obrigatório)
matchCondições Lista de condições de jogo. MatchCondition[] (obrigatório)
Designação 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)
ruleType Descreve o tipo de regra. 'Inválido'
'MatchRule' (obrigatório)

WebApplicationFirewallPolicyPropertiesFormat

Designação Descrição Valor
customRules Descreve regras personalizadas dentro da política. WebApplicationFirewallCustomRule[]
managedRegras Descreve a estrutura managedRules ManagedRulesDefinition (obrigatório)
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
Cluster AKS com um gateway NAT e um gateway de aplicativo Este exemplo mostra como implantar um cluster AKS com o NAT Gateway para conexões de saída e um Application Gateway para conexões de entrada.
cluster AKS com o Application Gateway Ingress Controller Este exemplo mostra como implantar um cluster AKS com o Application Gateway, o Application Gateway Ingress Controller, o Azure Container Registry, o Log Analytics e o Key Vault
Application Gateway com WAF e de política de firewall Este modelo cria um Gateway de Aplicativo com WAF configurado junto com uma política de firewall
Criar um WAF do Azure v2 no Azure Application Gateway Este modelo cria um Firewall de Aplicativo Web do Azure v2 no Gateway de Aplicativo do Azure com dois servidores Windows Server 2016 no pool de back-end
Porta da frente Standard/Premium com origem no Application Gateway Este modelo cria uma instância do Front Door Standard/Premium e do Application Gateway e usa uma política NSG e WAF para validar que o tráfego passou pela origem do Front Door.
porta de entrada com instâncias de contêiner e do Application Gateway Este modelo cria um Front Door Standard/Premium com um grupo de contêineres e Application Gateway.

Definição de recurso de modelo ARM

O tipo de recurso ApplicationGatewayWebApplicationFirewallPolicies 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/ApplicationGatewayWebApplicationFirewallPolicies, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies",
  "apiVersion": "2019-08-01",
  "name": "string",
  "etag": "string",
  "location": "string",
  "properties": {
    "customRules": [
      {
        "action": "string",
        "matchConditions": [
          {
            "matchValues": [ "string" ],
            "matchVariables": [
              {
                "selector": "string",
                "variableName": "string"
              }
            ],
            "negationConditon": "bool",
            "operator": "string",
            "transforms": [ "string" ]
          }
        ],
        "name": "string",
        "priority": "int",
        "ruleType": "string"
      }
    ],
    "managedRules": {
      "exclusions": [
        {
          "matchVariable": "string",
          "selector": "string",
          "selectorMatchOperator": "string"
        }
      ],
      "managedRuleSets": [
        {
          "ruleGroupOverrides": [
            {
              "ruleGroupName": "string",
              "rules": [
                {
                  "ruleId": "string",
                  "state": "string"
                }
              ]
            }
          ],
          "ruleSetType": "string",
          "ruleSetVersion": "string"
        }
      ]
    },
    "policySettings": {
      "fileUploadLimitInMb": "int",
      "maxRequestBodySizeInKb": "int",
      "mode": "string",
      "requestBodyCheck": "bool",
      "state": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

ManagedRuleGroupOverride

Designação Descrição Valor
ruleGroupName Descreve o grupo de regras gerenciadas a ser substituído. string (obrigatório)
regras Lista de regras que serão desativadas. Se nenhum for especificado, todas as regras do grupo serão desativadas. ManagedRuleOverride[]

ManagedRuleOverride

Designação Descrição Valor
ruleId Identificador da regra gerenciada. string (obrigatório)
Estado Descreve o estado da regra gerenciada. O padrão é Desativado se não for especificado. 'Desativado'

ManagedRulesDefinition

Designação Descrição Valor
Exclusões Descreve as Exclusões aplicadas na política. OwaspCrsExclusionEntry[]
managedRuleSets Descreve os ruleSets associados à política. ManagedRuleSet[] (obrigatório)

ManagedRuleSet

Designação Descrição Valor
ruleGroupSubstitui Define as substituições do grupo de regras a serem aplicadas ao conjunto de regras. ManagedRuleGroupOverride[]
ruleSetType Define o tipo de conjunto de regras a ser usado. string (obrigatório)
ruleSetVersion Define a versão do conjunto de regras a ser usado. string (obrigatório)

Condição de correspondência

Designação Descrição Valor
matchValues Valor correspondente. string[] (obrigatório)
matchVariables Lista de variáveis de correspondência. MatchVariable[] (obrigatório)
negaçãoConditon Descreve se esta é condição negada ou não. Bool
Operador Descreve o operador a ser correspondido. 'Começa com'
«Contém»
'Acaba com'
'Igual'
'MaiorQue'
'MaiorThanOrEqual'
'IPMatch'
'Menosque'
'LessThanOrEqual'
«Regex» (obrigatório)
transforma Lista de transformações. Matriz de cadeia de caracteres contendo qualquer uma das:
'HtmlEntityDecode'
'Minúsculas'
'RemoveNulls'
'Guarnição'
'UrlDecode'
'UrlEncode'

MatchVariable

Designação Descrição Valor
seletor Descreve o campo da coleção matchVariable. string
nomevariável Variável de correspondência. 'PostArgs'
'QueryString'
'RemoteAddr'
'RequestBody'
'RequestCookies'
'RequestHeaders'
'RequestMethod'
'RequestUri' (obrigatório)

Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies

Designação Descrição Valor
apiVersion A versão api '2019-08-01'
etag 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 Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies'

OwaspCrsExclusionEntry

Designação Descrição Valor
matchVariable A variável a excluir. 'RequestArgNames'
'RequestCookieNames'
'RequestHeaderNames' (obrigatório)
seletor Quando matchVariable é uma coleção, operador usado para especificar a quais elementos na coleção essa exclusão se aplica. string (obrigatório)
selectorMatchOperator Quando matchVariable for uma coleção, opere no seletor para especificar a quais elementos da coleção essa exclusão se aplica. «Contém»
'Acaba com'
'Iguais'
'EqualsAny'
'StartsWith' (obrigatório)

Configurações de política

Designação Descrição Valor
arquivoUploadLimitInMb Tamanho máximo de upload de arquivo em Mb para WAF. Int

Restrições:
Valor mínimo = 0
maxRequestBodySizeInKb Tamanho máximo do corpo da solicitação em Kb para WAF. Int

Restrições:
Valor mínimo = 8
Valor máximo = 128
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'
pedidoBodyCheck Se deve permitir que o WAF verifique o corpo da solicitação. Bool
Estado Descreve se a política está no estado habilitado ou desabilitado. 'Desativado'
'Habilitado'

Tags de Recursos

Designação Descrição Valor

WebApplicationFirewallCustomRule

Designação Descrição Valor
ação Tipo de Ações. 'Permitir'
'Bloqueio'
'Log' (obrigatório)
matchCondições Lista de condições de jogo. MatchCondition[] (obrigatório)
Designação 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)
ruleType Descreve o tipo de regra. 'Inválido'
'MatchRule' (obrigatório)

WebApplicationFirewallPolicyPropertiesFormat

Designação Descrição Valor
customRules Descreve regras personalizadas dentro da política. WebApplicationFirewallCustomRule[]
managedRegras Descreve a estrutura managedRules ManagedRulesDefinition (obrigatório)
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
Cluster AKS com um gateway NAT e um gateway de aplicativo

Implantar no Azure 		Este exemplo mostra como implantar um cluster AKS com o NAT Gateway para conexões de saída e um Application Gateway para conexões de entrada.
cluster AKS com o Application Gateway Ingress Controller

Implantar no Azure 		Este exemplo mostra como implantar um cluster AKS com o Application Gateway, o Application Gateway Ingress Controller, o Azure Container Registry, o Log Analytics e o Key Vault
Application Gateway com WAF e de política de firewall

Implantar no Azure 		Este modelo cria um Gateway de Aplicativo com WAF configurado junto com uma política de firewall
Criar um WAF do Azure v2 no Azure Application Gateway

Implantar no Azure 		Este modelo cria um Firewall de Aplicativo Web do Azure v2 no Gateway de Aplicativo do Azure com dois servidores Windows Server 2016 no pool de back-end
Porta da frente Standard/Premium com origem no Application Gateway

Implantar no Azure 		Este modelo cria uma instância do Front Door Standard/Premium e do Application Gateway e usa uma política NSG e WAF para validar que o tráfego passou pela origem do Front Door.
porta de entrada com instâncias de contêiner e do Application Gateway

Implantar no Azure 		Este modelo cria um Front Door Standard/Premium com um grupo de contêineres e Application Gateway.

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso ApplicationGatewayWebApplicationFirewallPolicies 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/ApplicationGatewayWebApplicationFirewallPolicies, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies@2019-08-01"
  name = "string"
  etag = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      customRules = [
        {
          action = "string"
          matchConditions = [
            {
              matchValues = [
                "string"
              ]
              matchVariables = [
                {
                  selector = "string"
                  variableName = "string"
                }
              ]
              negationConditon = bool
              operator = "string"
              transforms = [
                "string"
              ]
            }
          ]
          name = "string"
          priority = int
          ruleType = "string"
        }
      ]
      managedRules = {
        exclusions = [
          {
            matchVariable = "string"
            selector = "string"
            selectorMatchOperator = "string"
          }
        ]
        managedRuleSets = [
          {
            ruleGroupOverrides = [
              {
                ruleGroupName = "string"
                rules = [
                  {
                    ruleId = "string"
                    state = "string"
                  }
                ]
              }
            ]
            ruleSetType = "string"
            ruleSetVersion = "string"
          }
        ]
      }
      policySettings = {
        fileUploadLimitInMb = int
        maxRequestBodySizeInKb = int
        mode = "string"
        requestBodyCheck = bool
        state = "string"
      }
    }
  })
}

Valores de propriedade

ManagedRuleGroupOverride

Designação Descrição Valor
ruleGroupName Descreve o grupo de regras gerenciadas a ser substituído. string (obrigatório)
regras Lista de regras que serão desativadas. Se nenhum for especificado, todas as regras do grupo serão desativadas. ManagedRuleOverride[]

ManagedRuleOverride

Designação Descrição Valor
ruleId Identificador da regra gerenciada. string (obrigatório)
Estado Descreve o estado da regra gerenciada. O padrão é Desativado se não for especificado. 'Desativado'

ManagedRulesDefinition

Designação Descrição Valor
Exclusões Descreve as Exclusões aplicadas na política. OwaspCrsExclusionEntry[]
managedRuleSets Descreve os ruleSets associados à política. ManagedRuleSet[] (obrigatório)

ManagedRuleSet

Designação Descrição Valor
ruleGroupSubstitui Define as substituições do grupo de regras a serem aplicadas ao conjunto de regras. ManagedRuleGroupOverride[]
ruleSetType Define o tipo de conjunto de regras a ser usado. string (obrigatório)
ruleSetVersion Define a versão do conjunto de regras a ser usado. string (obrigatório)

Condição de correspondência

Designação Descrição Valor
matchValues Valor correspondente. string[] (obrigatório)
matchVariables Lista de variáveis de correspondência. MatchVariable[] (obrigatório)
negaçãoConditon Descreve se esta é condição negada ou não. Bool
Operador Descreve o operador a ser correspondido. 'Começa com'
«Contém»
'Acaba com'
'Igual'
'MaiorQue'
'MaiorThanOrEqual'
'IPMatch'
'Menosque'
'LessThanOrEqual'
«Regex» (obrigatório)
transforma Lista de transformações. Matriz de cadeia de caracteres contendo qualquer uma das:
'HtmlEntityDecode'
'Minúsculas'
'RemoveNulls'
'Guarnição'
'UrlDecode'
'UrlEncode'

MatchVariable

Designação Descrição Valor
seletor Descreve o campo da coleção matchVariable. string
nomevariável Variável de correspondência. 'PostArgs'
'QueryString'
'RemoteAddr'
'RequestBody'
'RequestCookies'
'RequestHeaders'
'RequestMethod'
'RequestUri' (obrigatório)

Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies

Designação Descrição Valor
etag 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 Tags de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies@2019-08-01"

OwaspCrsExclusionEntry

Designação Descrição Valor
matchVariable A variável a excluir. 'RequestArgNames'
'RequestCookieNames'
'RequestHeaderNames' (obrigatório)
seletor Quando matchVariable é uma coleção, operador usado para especificar a quais elementos na coleção essa exclusão se aplica. string (obrigatório)
selectorMatchOperator Quando matchVariable for uma coleção, opere no seletor para especificar a quais elementos da coleção essa exclusão se aplica. «Contém»
'Acaba com'
'Iguais'
'EqualsAny'
'StartsWith' (obrigatório)

Configurações de política

Designação Descrição Valor
arquivoUploadLimitInMb Tamanho máximo de upload de arquivo em Mb para WAF. Int

Restrições:
Valor mínimo = 0
maxRequestBodySizeInKb Tamanho máximo do corpo da solicitação em Kb para WAF. Int

Restrições:
Valor mínimo = 8
Valor máximo = 128
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'
pedidoBodyCheck Se deve permitir que o WAF verifique o corpo da solicitação. Bool
Estado Descreve se a política está no estado habilitado ou desabilitado. 'Desativado'
'Habilitado'

Tags de Recursos

Designação Descrição Valor

WebApplicationFirewallCustomRule

Designação Descrição Valor
ação Tipo de Ações. 'Permitir'
'Bloqueio'
'Log' (obrigatório)
matchCondições Lista de condições de jogo. MatchCondition[] (obrigatório)
Designação 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)
ruleType Descreve o tipo de regra. 'Inválido'
'MatchRule' (obrigatório)

WebApplicationFirewallPolicyPropertiesFormat

Designação Descrição Valor
customRules Descreve regras personalizadas dentro da política. WebApplicationFirewallCustomRule[]
managedRegras Descreve a estrutura managedRules ManagedRulesDefinition (obrigatório)
policySettings Descreve policySettings para política. PolicySettings