Todos os produtos
Search
Central de documentação

Web Application Firewall:Match conditions

Última atualização: Oct 12, 2026

Ao configurar regras de lista de permissões, regras personalizadas ou regras de gerenciamento de bots, defina condições de correspondência para especificar as características das requisições a serem avaliadas. Este tópico descreve os campos compatíveis com as condições de correspondência de regras e suas respectivas interpretações.

O que são condições de correspondência

Condições de correspondência referem-se às características da requisição que o Web Application Firewall precisa inspecionar. Ao configurar whitelist rules, Custom rules ou Bot management, defina a Match Condition para especificar quais atributos da requisição devem ser analisados. Se uma requisição atender às condições de correspondência configuradas em uma regra, ela acionará a regra correspondente. O WAF aplica então a ação definida na regra para processar a requisição adequadamente, como permitir, bloquear ou verificar a requisição.Match conditions

A Match Condition é composta por Match Field, Logical Operator e Match Content. A tabela a seguir apresenta um exemplo de configuração:

Match Field

Logical Operator

Match Content

Descrição

URI Path

Contains

/login.php

A requisição corresponde a esta regra se o caminho da requisição contiver /login.php.

IP

Belongs to

192.1.XX.XX

A requisição corresponde a esta regra se o IP do cliente for 192.1.XX.XX.

Campos de correspondência compatíveis

A tabela a seguir lista os campos compatíveis com as condições de correspondência e suas regras associadas.

  1. Definição e faturamento de regras avançadas

    • Definição: Uma regra é considerada avançada se atender a qualquer uma das seguintes condições:

      • Utiliza um dos seguintes campos de correspondência: Cookie, Content-Type, Content-Length, X-Forwarded-For, Body, Http-Method, File Extension, Filename, Server-Port, Header, Cookie Name ou Body Parameter.

      • Inclui uma condição de correspondência ou não correspondência de expressão regular.

    • WAF com pagamento conforme o uso: Regras avançadas e regras básicas possuem padrões de faturamento diferentes. Para preços específicos, consulte Pay-as-you-go billing.

    • WAF por assinatura: Apenas a edição Enterprise ou superior oferece suporte a regras avançadas. Para diferenças de recursos entre edições, consulte WAF editions and features.

  2. Mecanismo de correspondência

    • Sensibilidade a maiúsculas e minúsculas: Salvo indicação em contrário, o conteúdo de correspondência para todos os campos não diferencia maiúsculas de minúsculas.

    • Tratamento de codificação: Para conteúdo de requisição que contenha codificações comuns, como codificação URL, HTML ou Unicode, o sistema decodifica automaticamente o conteúdo antes de realizar a correspondência.

Campo de correspondência

Descrição

Operadores lógicos compatíveis

URI

O Uniform Resource Identifier (URI) de uma requisição, que indica o caminho do recurso solicitado. Geralmente, URI = URI Path + Query String.

O conteúdo de correspondência associado começa com / e não contém nome de domínio. Por exemplo, /login.php.

  • Equals, Does not equal, Equals one of, Does not equal any of

  • Contains, Does not contain, Contains one of, Does not contain any of

  • Length equals, Length is greater than, Length is less than

  • Starts with, Ends with

  • Regular Expression Match, Regular Expression Mismatch

IP

O endereço IP de source da requisição, ou seja, o endereço IP do cliente que inicia a requisição.

O conteúdo de correspondência deve atender aos seguintes requisitos:

  • Endereços IPv4 (por exemplo, 1.XX.XX.1) e endereços IPv6 (por exemplo, 2001:db8:ffff:ffff:ffff:ffff:ffff:ffff) são compatíveis.

  • Faixas de endereços IP (por exemplo, 1.XX.XX.1/16) são compatíveis.

  • Pressione Enter após inserir cada endereço IP para confirmar.

  • Até 100 endereços IP são compatíveis.

Belongs To, Does Not Belong To

Nota

Uma única regra de proteção aceita até 100 endereços IP ou faixas de endereços IP. Por exemplo, se uma regra de proteção contiver duas condições de correspondência com IP como campo de correspondência, o número total de endereços IP ou faixas de endereços IP nas duas condições não pode exceder 100. Separe múltiplos endereços IP ou faixas de endereços IP com vírgulas (,).

Referer

A URL de source da requisição, ou seja, a página de onde a requisição foi redirecionada.

  • Equals, Does not equal, Equals one of, Does not equal any of

  • Contains, Does not contain, Contains one of, Does not contain any of

  • Exists, Does not exist

  • Is empty

  • Length equals, Length is greater than, Length is less than

  • Starts with, Ends with

  • Regular Expression Match, Regular Expression Mismatch

User-Agent

As informações do navegador do cliente que inicia a requisição, incluindo identificador do navegador, identificador do mecanismo de renderização e informações de versão.

  • Equals, Does not equal, Equals one of, Does not equal any of

  • Contains, Does not contain, Contains one of, Does not contain any of

  • Exists, Does not exist

  • Is empty

  • Length equals, Length is greater than, Length is less than

  • Starts with, Ends with

  • Regular Expression Match, Regular Expression Mismatch

Query String

A string de consulta na requisição, especificamente a parte após o ponto de interrogação (?) na URL.

  • Equals, Does not equal, Equals one of, Does not equal any of

  • Contains, Does not contain, Contains one of, Does not contain any of

  • Exists, Does not exist

  • Length equals, Length is greater than, Length is less than

  • Starts with, Ends with

  • Regular Expression Match, Regular Expression Mismatch

Cookie

As informações de cookie na requisição.

  • Equals, Does not equal, Equals one of, Does not equal any of

  • Contains, Does not contain, Contains one of, Does not contain any of

  • Exists, Does not exist

  • Length equals, Length is greater than, Length is less than

  • Regular Expression Match, Regular Expression Mismatch

Content-Type

O tipo de conteúdo HTTP especificado na requisição, ou seja, as informações de tipo Multipurpose Internet Mail Extensions (MIME).

  • Equals, Does not equal, Equals one of, Does not equal any of

  • Contains, Does not contain, Contains one of, Does not contain any of

  • Length equals, Length is greater than, Length is less than

  • Regular Expression Match, Regular Expression Mismatch

Content-Length

O número de bytes contidos no conteúdo da requisição. Valores válidos: 0 a 2147483648.

  • Equals, Is greater than, Is less than

X-Forwarded-For

O endereço IP real do cliente na requisição. O campo de cabeçalho X-Forwarded-For (XFF) identifica o endereço IP original do cliente para requisições encaminhadas por proxies HTTP ou balanceadores de carga. Este campo está incluído apenas em requisições encaminhadas por proxies HTTP ou balanceadores de carga.

  • Equals, Does not equal, Equals one of, Does not equal any of

  • Contains, Does Not Contain

  • Does Not Exist

  • Length equals, Length is greater than, Length is less than

Body

As informações de conteúdo da requisição.

  • Equals

  • Contains

  • Does Not Exist

  • Starts with, Ends with

  • Regular Expression Match

Http-Method

O método da requisição, incluindo GET, POST, DELETE, PUT, OPTIONS, CONNECT, HEAD, TRACE e PATCH.

  • Equals, Does not equal, Equals one of, Does not equal any of

Header

As informações de cabeçalho da requisição. Campos de cabeçalho personalizados são compatíveis.

  • Equals, Does not equal, Equals one of, Does not equal any of

  • Contains, Does not contain, Contains one of, Does not contain any of

  • Exists, Does not exist

  • Length equals, Length is greater than, Length is less than

  • Regular Expression Match, Regular Expression Mismatch

URI Path

O caminho URI da requisição.

  • Equals, Does not equal, Equals one of, Does not equal any of

  • Contains, Does not contain, Contains one of, Does not contain any of

  • Length equals, Length is greater than, Length is less than

  • Starts with, Ends with

  • Regular Expression Match, Regular Expression Mismatch

Query String Parameter

O nome do parâmetro da requisição. O parâmetro da requisição refere-se à parte após o ponto de interrogação (?) na URL da requisição. Por exemplo, em www.aliyundoc.com/request_path?param1=a&param2=b, tanto param1 quanto param2 são parâmetros da requisição.

Nota

O Parameter personalizado de Query String Parameter diferencia maiúsculas de minúsculas.

  • Equals, Does not equal, Equals one of, Does not equal any of

  • Contains, Does not contain, Contains one of, Does not contain any of

  • Exists, Does not exist

  • Is empty

  • Length equals, Length is greater than, Length is less than

  • Starts with, Ends with

Server-Port

A porta do servidor.

  • Equals, Does not equal, Equals one of, Does not equal any of

File Extension

A extensão do arquivo solicitado, por exemplo, .png e .php.

  • Equals, Does not equal, Equals one of, Does not equal any of

  • Contains, Does not contain, Contains one of, Does not contain any of

  • Exists, Does not exist

  • Is empty

  • Length equals, Length is greater than, Length is less than

  • Starts with, Ends with

  • Regular Expression Match, Regular Expression Mismatch

Filename

O nome do arquivo no final do caminho da requisição. Por exemplo, em /abc/index.php, index.php indica o nome do arquivo.

  • Equals, Does not equal, Equals one of, Does not equal any of

  • Contains, Does not contain, Contains one of, Does not contain any of

  • Exists, Does not exist

  • Is empty

  • Length equals, Length is greater than, Length is less than

  • Starts with, Ends with

  • Regular Expression Match, Regular Expression Mismatch

Host

O nome de domínio solicitado.

  • Equals, Does not equal, Equals one of, Does not equal any of

  • Contains, Does not contain, Contains one of, Does not contain any of

  • Exists, Does not exist

  • Is empty

  • Length equals, Length is greater than, Length is less than

  • Starts with, Ends with

  • Regular Expression Match, Regular Expression Mismatch

Cookie Name

O nome da chave do cookie. Por exemplo, no cookie acw_tc:111, acw_tc é o nome da chave do cookie.

Nota

O Cookie-Exact personalizado de Cookie Name diferencia maiúsculas de minúsculas.

  • Equals, Does not equal, Equals one of, Does not equal any of

  • Contains, Does not contain, Contains one of, Does not contain any of

  • Exists, Does not exist

  • Is empty

  • Length equals, Length is greater than, Length is less than

  • Starts with, Ends with

  • Regular Expression Match

Body Parameter

  • Regras básicas

    • Este campo especifica o nome do parâmetro no corpo da requisição. A correspondência diferencia maiúsculas de minúsculas.

    • O comprimento do conteúdo de correspondência deve ser superior a 4 caracteres. Caso contrário, o sistema não consegue detectar o tráfego correspondente.

  • Especificação de formato

    • Parâmetros regulares: Insira o nome da chave do parâmetro diretamente. Por exemplo, se o corpo da requisição for a=1&b=2, insira a ou b.

    • JSON aninhado: Use o formato hierárquico separado por pontos de ParentKey.ChildKey. Por exemplo, se você precisar corresponder ao valor em {"userInfo": {"userId": "12345"}}, insira userInfo.userId.

  • Equals, Does not equal, Equals one of, Does not equal any of

  • Contains, Does not contain, Contains one of, Does not contain any of

  • Exists, Does not exist

  • Is empty

  • Length equals, Length is greater than, Length is less than

  • Starts with, Ends with

  • Regular Expression Match

Client-ID

O identificador do cliente (como um navegador ou aplicativo), que identifica o cliente de onde se origina uma requisição HTTP com base em características como informações de User Agent e impressões digitais de tráfego.

Nota

Compatível apenas com o módulo Bot Management > Advanced Custom Rules.

  • Contains, Does Not Contain

  • Equals, Does Not Equal

  • Equals One of Multiple Values

JA3 Fingerprint

Uma string gerada pela aplicação de hash MD5 em parâmetros-chave durante o handshake TLS, incluindo versão TLS, conjunto de cifras, algoritmo de compressão e extensões TLS. Esta string representa a configuração TLS do cliente e é chamada de impressão digital JA3.

A impressão digital JA3 pode ser usada para identificar e distinguir diferentes tipos de clientes TLS, como navegadores web, aplicativos móveis e malware.

Nota

Compatível apenas com o módulo Bot Management > Advanced Custom Rules.

  • Equals, Does Not Equal

  • Equals One of Multiple Values

JA4 Fingerprint

A impressão digital JA4 introduz mais informações contextuais e algoritmos, como versão do navegador e sistema operacional, para reduzir possíveis problemas de duplicação causados pela impressão digital JA3.

A impressão digital JA4 identifica com mais precisão usuários reais versus impostores, reduzindo a taxa de falsos positivos.

Nota

Compatível apenas com o módulo Bot Management > Advanced Custom Rules.

  • Equals, Does Not Equal

  • Equals One of Multiple Values

HTTP/2 Fingerprint

Uma impressão digital HTTP 2.0 gerada pelo processamento da impressão digital original do cliente HTTP/2 usando o algoritmo MD5. É usada para analisar e identificar diferentes clientes visando uma comunicação mais segura e eficiente.

Nota

Compatível apenas com o módulo Bot Management > Advanced Custom Rules.

  • Equals, Does Not Equal

  • Equals One of Multiple Values

IDC

Identifica a origem do tráfego com base em dados de atribuição de IP de source. Servidores cloud têm custos menores e são facilmente explorados por agentes maliciosos para ataques.

Nota

Compatível apenas com o módulo Bot Management > Advanced Custom Rules.

Equals One of Multiple Values, Does Not Equal Any Value

Web SDK

Identifica tráfego anormal com base em informações de sonda coletadas pelo Web SDK, como o UMID web e o número de pressionamentos de teclado/mouse/tela sensível ao toque.

Nota

Compatível apenas com o módulo Bot Management > Advanced Custom Rules.

  • Equals

  • Value Greater Than, Value Less Than

App SDK

Permite controle granular com base em informações de sonda coletadas pelo App SDK.

Nota

Compatível apenas com o módulo Bot Management > Advanced Custom Rules.

  • Contains, Does Not Contain

  • Equals, Does Not Equal

  • Length Less Than, Length Equal To, Length Greater Than

  • Equals One of Multiple Values, Does Not Equal Any Value

  • Contains One of Multiple Values, Does Not Contain Any Value

  • Regular Expression Match, Regular Expression Mismatch

  • Prefix Match, Suffix Match

  • Exists, Does Not Exist

  • Content Is Empty