Todos os produtos
Search
Central de documentação

Web Application Firewall:Configure advanced custom rules for bot management

Última atualização: Oct 12, 2026

O módulo de regras personalizadas avançadas no Bot Management oferece campos de correspondência mais abrangentes (como Client ID, fingerprints JA3/JA4 e dados coletados pelo Web SDK e App SDK) e dimensões estatísticas (como UMID e Session) em comparação com as regras personalizadas do Web Core Protection. Suporta contagem com deduplicação e ações de cabeçalho personalizado de origem para atender às necessidades de gerenciamento granular de tráfego de bots e defesa em cenários complexos.

Procedimento

Nota

Antes de começar, certifique-se de que os seguintes pré-requisitos sejam atendidos:

  1. Existência de objetos protegidos: sua aplicação web deve estar conectada ao WAF. Caso contrário, consulte Connect your business to WAF.

  2. Bot Management ativado: usuários com assinatura devem ativar o Bot Management (a Subscription Basic Edition não oferece suporte a esse recurso). Para obter mais informações, consulte Activate bot management.

Acesse o console do Web Application Firewall 3.0. Na barra de navegação superior, selecione o grupo de recursos e a região da sua instância do WAF (Chinese Mainland ou Outside Chinese Mainland). No painel de navegação à esquerda, escolha Protection Config > Bot Management > Advanced Custom Rules.

Etapa 1: Configure o nome do modelo e os objetos protegidos

Clique em Create Template. No painel New Template - Advanced Custom Rules, configure os seguintes parâmetros.

  • Template Name: defina um nome de fácil identificação para o modelo de proteção.

  • Rule Configuration: clique em Create Rule para adicionar uma regra de proteção ao modelo atual.

  • Apply To: selecione os objetos protegidos e grupos de objetos protegidos aos quais este modelo será aplicado. Você pode ajustar manualmente o status de ativação de objetos protegidos ou grupos de objetos durante e após a criação do modelo.

Etapa 2: Adicione regras de proteção ao modelo

Na seção Rule Configuration, clique em Create Rule e configure os seguintes parâmetros.

  • Rule Name: defina um nome de fácil identificação para a regra de proteção.

  • Match Condition: defina as características da requisição para correspondência. Clique em Add Condition para adicionar uma condição. Cada condição consiste em um Match Field, um Logical Operator e um Match Content. A tabela a seguir mostra exemplos de configuração:

    Nota

    Se uma regra contiver várias condições, a requisição deverá atender a todas as condições (AND lógico) para acionar a regra. Para obter descrições detalhadas dos campos de correspondência e operadores lógicos, consulte Campos de correspondência e operadores lógicos.

    Match Field

    Logical Operator

    Match Content

    Descrição

    URI Path

    Contains

    /login.php

    A requisição aciona esta regra quando seu caminho contém /login.php.

    IP

    Belongs to

    192.1.XX.XX

    A requisição aciona esta regra quando o IP do cliente é 192.1.XX.XX.

  • Protection Rule Type: suporta Access Control e Rate Limiting.

    • Access Control: ideal para cenários que exigem controle preciso sobre tipos específicos de requisições.

    • Rate Limiting: recomendado para cenários baseados na frequência de acesso (como proteção contra força bruta e scraping).

      Access Control

      Configure regras de controle de acesso para executar ações especificadas em requisições individuais que atendam às condições.

      Frequency Control

      Configure regras de controle de frequência para limitar o acesso excessivo de clientes.

      • Condição de detecção de frequência: quando um único Statistical Object excede o Threshold (Times) configurado dentro do Statistical Interval (Seconds) especificado, a ação da lista de bloqueios é acionada.

        Item de configuração

        Descrição

        Statistical Object

        Selecione o objeto cuja frequência de requisições será rastreada. Opções disponíveis:

        • IP: rastreie a frequência de requisições do mesmo endereço IP.

        • Custom Header: agrupe requisições pelo valor de um cabeçalho de requisição personalizado (como Referer) e rastreie a frequência de requisições com o mesmo valor de cabeçalho dentro do período especificado.

        • Custom Parameter: rastreie a frequência de requisições que contêm um parâmetro de URL especificado. Por exemplo, se o parâmetro for user_id, o WAF rastreia a frequência de requisições com o mesmo valor de user_id.

        • Session: o WAF estabelece um identificador de sessão definindo um cookie chamado acw_tc na resposta e rastreia a frequência de requisições do cliente com base no valor desse cookie.

        • Account: rastreie a frequência de requisições da mesma conta. Configure a User Identification na página Protected Objects antes de configurar esta opção. Para obter mais informações, consulte Configuração de extração de conta.

        • Body: rastreie a frequência de requisições que contêm um parâmetro de corpo especificado.

        • App UMID: rastreie a frequência de requisições do mesmo cliente de aplicativo.

        • Web UMID: rastreie a frequência de requisições do mesmo cliente web.

        Statistical Interval (Seconds)

        A janela de tempo para a contagem de frequência. Unidade: segundos.

        Threshold (Times)

        Defina o número máximo de vezes que o Statistical Object pode acionar a Match Condition dentro do Statistical Interval (Seconds). Se esse limite for excedido, o sistema adiciona o objeto à lista de bloqueios.

      • Condição de detecção de código de resposta: quando ativada, apenas as respostas que correspondem às seguintes características são contabilizadas na frequência. Essa condição deve ser atendida em conjunto com a condição de detecção de frequência.

        Item de configuração

        Descrição

        Status Code

        Defina o código de resposta a ser rastreado.

        Quantity

        Defina o número máximo de vezes que o Status Code especificado pode aparecer dentro do intervalo estatístico.

        Percentage (%)

        Defina a porcentagem máxima do Status Code especificado dentro do intervalo estatístico.

      • Deduplication Statistics: quando ativada, o sistema deduplica o conteúdo da requisição e contabiliza apenas as características de requisição não repetidas. Se o resultado deduplicado acionar a regra, o sistema executa a ação da lista de bloqueios. Clique em Add Condition para adicionar uma condição. Cada condição consiste em um Match Field, um Logical Operator e uma Quantity. A tabela a seguir mostra um exemplo de configuração:

        Nota

        Se uma regra contiver várias condições, a requisição deverá atender a todas as condições (AND lógico) para acionar a regra.

        Quando você define o Match Field como URI, o Logical Operator como Equals e a Quantity como 5, o sistema deduplica as URIs das requisições. A regra é acionada quando a frequência de acessos a URIs não duplicadas atinge 5.

      • Condição de ação da lista de bloqueios: adicione objetos estatísticos que atingem as condições de detecção acima à lista de bloqueios. Durante o Timeout Period, execute a ação definida em Actions nas requisições dentro do Apply To desse objeto.

        Item de configuração

        Descrição

        Apply To

        Defina o escopo onde a ação da lista de bloqueios entra em vigor. Valores disponíveis:

        • Current Match Condition: processa apenas requisições que atendem à Match Condition da regra atual.

        • Protected Object: executa a ação em todas as requisições do objeto estatístico (como IP) que acessam o objeto protegido atual.

        Timeout Period

        Defina a duração da ação da lista de bloqueios. Unidade: segundos. Valores válidos: 60 a 86400.

  • Actions: selecione a ação aplicada quando uma requisição acionar esta regra.

    Ação

    Descrição

    JavaScript Validation

    O WAF retorna um código de validação JavaScript para o cliente. Um navegador padrão executa esse código automaticamente. Se o cliente passar na validação, o WAF permite todas as requisições subsequentes desse cliente por um período definido (padrão: 30 minutos). Caso contrário, o WAF bloqueia as requisições.

    Block

    O WAF bloqueia as requisições que correspondem à regra e retorna uma página de bloqueio para o cliente.

    Nota

    O WAF usa uma página de bloqueio padrão. Também é possível criar uma página de resposta personalizada usando o recurso Custom Response.

    Log

    Esta ação não bloqueia requisições que correspondem à regra, apenas registra os logs dessas requisições. Ao testar uma regra, use primeiro o modo Log para analisar o log do WAF e confirme que não ocorrem falsos positivos antes de mudar para uma ação diferente.

    CAPTCHA

    O WAF retorna uma página de verificação por slider para o cliente. Se o cliente concluir o desafio de slider com sucesso, o WAF permite todas as requisições desse cliente por um período definido (padrão: 30 minutos). Caso contrário, o WAF bloqueia as requisições.

    Nota

    O WAF usa uma página de CAPTCHA de slider padrão. Você também pode personalizar a página de CAPTCHA de slider usando o recurso Custom Response.

    Strict CAPTCHA

    O WAF retorna uma página de verificação por slider para o cliente. Se o cliente concluir o desafio de slider com sucesso, o WAF permite a requisição atual. Caso contrário, bloqueia a requisição. Neste modo, o cliente deve concluir um desafio de slider para cada requisição que corresponder à regra.

    Origin Custom Header

    O WAF adiciona um cabeçalho personalizado à requisição e a encaminha para o servidor de origem. Isso permite integrar as informações de correspondência do WAF ao seu próprio sistema de controle de risco de backend para processamento adicional.

    Nota
    • A validação JavaScript Validation ou CAPTCHA aplica-se apenas a requisições síncronas. Para requisições assíncronas, como XMLHttpRequest ou Fetch, injete o Web SDK; caso contrário, a validação não funcionará corretamente.

  • Rule Type: defina o tipo de tráfego de bot. Os tipos disponíveis são Suspected Bot e Malicious Bot. O WAF classifica o tráfego que aciona a regra na categoria correspondente e o exibe no gráfico de tendências na página Traffic Analytics.

  • Advanced Settings: configure a proporção de liberação canário e a estratégia de tempo de vigência para a regra.

    Item de configuração

    Descrição

    Canary Rule

    Configure a proporção de vigência da regra para objetos em diferentes dimensões.

    Ative a liberação canário e defina a Dimension e a Canary Release Proportion. As opções disponíveis de Dimension incluem: IP, Custom Header, Custom Parameter, Custom Cookie, Session, App UMID e Web UMID.

    Nota

    Uma regra canário entra em vigor com base na Dimension configurada, em vez de aplicá-la aleatoriamente a uma porcentagem de todas as requisições. Por exemplo, ao definir a Dimension como IP e a Canary Release Proportion como 10%, o WAF selecionará aproximadamente 10% de todos os endereços IP. O WAF então aplica a regra a todas as requisições provenientes dos endereços IP selecionados, e não a 10% aleatórios de todas as requisições.

    Effective Mode

    • Permanently Effective (Padrão): a regra permanece sempre ativa quando o modelo de proteção está ativado.

    • Fixed Schedule: a regra de proteção permanece ativa apenas durante um período especificado.

    • Recurring Schedule: a regra de proteção permanece ativa apenas durante uma programação recorrente especificada.

Operações diárias

Gerencie modelos de proteção

Os modelos de proteção recém-criados vêm ativados por padrão. Você pode executar as seguintes operações na lista de modelos:

  • Visualize o número de Protected Object/Group associados ao modelo.

  • Ative ou desative o modelo usando a opção Status.

  • Crie uma regra para o modelo através do botão Create Rule.

  • Edite, exclua ou copie o modelo de proteção usando as opções Edit, Delete ou Copy.

  • Clique em Expand icon à esquerda do nome do modelo e visualize as regras contidas nele.

Gerencie regras de proteção

As regras recém-criadas vêm ativadas por padrão. Você pode executar as seguintes operações na lista de regras:

  • Visualize o Rule ID, a Rule Condition e outras informações.

  • Ative ou desative a regra usando a opção Status.

  • Edite ou exclua a regra usando as opções Edit ou Delete.

Cotas e limites

  • Uma única regra de proteção aceita no máximo 10 Match Condition.

  • Uma regra de Deduplication Statistics aceita no máximo 5 condições.

FAQ

Regras personalizadas avançadas do Bot Management vs. regras personalizadas do Core Web Protection: quais são as diferenças?

Item de comparação

Core Web Protection > Custom Rule

Bot Management > Advanced Custom Rules

Requisitos de versão e custos

  • A Subscription Basic Edition não oferece suporte a esse recurso. Incluído em todas as outras edições de assinatura.

  • Disponível na edição de pagamento conforme o uso por um custo menor que o Bot Management > Advanced Custom Rules.

  • A Subscription Basic Edition não oferece suporte a esse recurso. Requer a ativação adicional do Bot Management para outras edições de assinatura.

  • Disponível na edição de pagamento conforme o uso mediante taxa adicional.

Recursos com suporte

Disponibiliza regras que atendem às necessidades diárias de proteção.

Além da funcionalidade de Custom Rule, também suporta os seguintes recursos:

  • Suporta campos de correspondência adicionais, como Client ID, fingerprints JA3/JA4 e dados do Web/App SDK.

  • As regras de Rate Limiting suportam o UMID como objeto estatístico e podem ser usadas em conjunto com Deduplication Statistics.

  • Suporta a ação Origin Custom Header.