Saltar para o conteúdo

A linguagem de regras do WAF

A sintaxe para escrever regras próprias de firewall: campos, operadores e ações. Com os enganos mais comuns e como evitá-los.

Avançado9 min de leitura

Quando vale a pena

Uma regra própria serve o que as prontas não sabem: o que é específico do teu site.

  • Bloquear /admin a tudo o que não venha do IP do escritório.
  • Deixar passar sempre um integrador conhecido.
  • Registar tudo o que traz um cabeçalho suspeito, para decidir depois.

Não vale a pena escrever uma regra para o que o nível de proteção já apanha. Ver Nível de proteção.

A forma de uma regra

http.request.uri.path contains "/admin" and ip.src ne "203.0.113.7"

Combinas campos com operadores, juntas condições com and, or e not, e agrupas com parênteses. A ação escolhe-se à parte.

Precedência

not liga mais do que and, que liga mais do que or. Como em quase todas as linguagens — e como em quase todas, põe parênteses quando misturas and e or:

# Não é o que parece: o `and` liga primeiro.
a or b and c

# Isto é inequívoco.
(a or b) and c

Esta é a origem da maioria das regras que «não fazem o que eu quero».

Campos

CampoO que é
http.request.methodGET, POST, …
http.request.uri.patho caminho, sem query string
http.request.uri.querya query string em cru
http.hosto cabeçalho Host, em minúsculas
http.user_agento User-Agent, tal como veio
ip.srco IP do cliente, já resolvido através dos proxies de confiança
http.request.bodyo corpo, quando disponível

Duas notas que evitam regras que nunca combinam:

  • uri.path não traz a query string. Uma regra sobre ?admin=1 tem de olhar para uri.query.
  • http.request.body está vazio em muitas fases. Só está disponível onde o corpo já foi lido; uma regra sobre o corpo que nunca combina costuma ser isto.

Operadores

OperadorO que faz
eq / neigual / diferente
containscontém, como texto — sem padrões
matchesexpressão regular
in / not inpertence a um conjunto

Conjuntos

Para vários valores, um conjunto é mais legível — e mais rápido — do que uma cadeia de or:

ip.src in {"203.0.113.7", "203.0.113.8", "198.51.100.4"}

Expressões regulares

matches usa RE2. Não tem retrocesso, o que significa que não há expressões que rebentem em tempo exponencial — a garantia que torna seguro aceitar padrões escritos por quem quer que seja.

O que RE2 não tem: retrovisões ((?<=…)) e referências para trás (\1). Se a tua expressão as usa, tem de ser reescrita.

Âncora o que deve ser âncora. matches "admin" combina com /nao-e-admin-nenhum/ola. Se querias o início, escreve matches "^/admin".

Ações

AçãoO que acontece
logregistamos e continuamos a avaliar. Não bloqueia.
block403, e o pedido acaba ali.
challengepor agora igual a block; reservado para desafio ao visitante.
allowsalta o resto da firewall para este pedido.
ban_ipbloqueia e propaga um bloqueio do IP a toda a frota.

allow é a mais perigosa das cinco

Um allow salta a firewall toda — o motor de anomalias e as outras regras. Uma expressão de allow mais larga do que se pensava é um buraco aberto de propósito.

Uma regra de allow deve ser tão específica quanto conseguires: um IP concreto, um caminho concreto. Nunca só um User-Agent, que qualquer pessoa pode escrever no pedido.

ban_ip é fleet-wide e persistente

Bloqueia aquele IP em todos os nossos servidores, não só naquele. Serve para abuso confirmado, e não para uma suspeita — um IP de CGNAT ou de proxy empresarial pode ter centenas de pessoas legítimas atrás.

O caminho seguro para pôr uma regra em produção

  1. Escreve-a com log.
  2. Deixa correr o tempo suficiente para passar tráfego real — um dia útil, no mínimo.
  3. Vê o que ela apanhou em Site → Atividade → Ameaças.
  4. Se só apanhou o que devia, passa a block. Se apanhou um cliente, a expressão está larga.

Este ciclo custa um dia e evita a chamada de um cliente bloqueado.

Ordem

As regras são avaliadas na ordem que definires, e a primeira que decide manda. Consequência: uma regra de allow no topo tapa tudo o que estiver abaixo dela para os pedidos que ela apanhar.

Ver também

← Toda a documentação