O WAF do miniProxy usa o OWASP Coraza com as regras do OWASP Core Rule Set (CRS) para inspecionar cada requisição em busca de ataques como SQL injection, XSS e path traversal. Ele é ligado domínio a domínio, em modo Deteccao (só registra) ou Bloqueio (responde 403), e a tela Seguranca > WAF concentra a política, as exclusões e os eventos.
Instalar a infraestrutura
Enquanto o WAF não estiver instalado, a tela mostra a etiqueta infra nao instalada e o aviso para rodar o setup-waf.sh.
- Acesse o servidor do proxy por SSH como root.
- Na pasta do miniProxy, rode:
./setup-waf.sh
O script pode ser executado mais de uma vez sem problema. Ele:
- instala o Go (se faltar) e compila o serviço
coraza-spoa; - cria o serviço do systemd, o usuário e o
/etc/coraza-spoa/config.yaml; - baixa o OWASP CRS para
/etc/coraza-spoa/coreruleset/(se o download falhar, usa o CRS embutido no binário); - cria o
/etc/haproxy/coraza.cfge liga o WAF ao HAProxy (filter spoeno frontend HTTPS ebackend coraza-spoa); - configura a rotação dos logs do Coraza;
- valida a config com
haproxy -ce recarrega o HAProxy.
Ao final, o topo da tela WAF passa a mostrar daemon ativo.
Atenção: o script altera o
haproxy.cfge faz uma cópia antes (haproxy.cfg.waf-bak.<data>). Se a validação falhar, ele para e mostra o erro sem recarregar.
Ligar o WAF num domínio
O modo é escolhido na tela do domínio:
- Abra o domínio na lista de Dominios.
- No quadro Seguranca, localize WAF (OWASP).
- Escolha o modo e clique no botão de confirmar (✓):
| Opção | Efeito no tráfego |
|---|---|
| Desligado | As requisições do domínio não passam pelo WAF. |
| Deteccao (so registra) | O WAF analisa e registra os eventos, mas não bloqueia nada. |
| Bloqueio | Requisições que ultrapassam o limite de anomalia recebem 403. |
O domínio passa a exibir a etiqueta WAF det ou WAF bloq na lista. Se o serviço estiver parado, aparece daemon inativo ao lado do seletor.
Dica: comece sempre em Deteccao (so registra). Deixe rodar alguns dias com tráfego real, trate os falsos-positivos na aba Triagem e só então mude para Bloqueio.
IPs da Whitelist não são enviados ao WAF. Se o serviço coraza-spoa não responder, as requisições seguem sem inspeção (o site não cai por causa do WAF).
Abas da tela WAF
O topo mostra o estado do serviço, quantos domínios têm WAF, o total de exclusões por path e quantos bloqueios recentes houve.
Triagem
A aba Triagem agrupa os eventos recentes por domínio + regra + path e sugere um veredito:
| Etiqueta | Quando aparece |
|---|---|
| provavel falso-positivo | Vários IPs diferentes, muitas ocorrências ou endpoint de aplicação/API (/rest, /api, /graphql, /media, /static, /admin...). |
| revisar | Sinais mistos. |
| provavel ataque | Um único IP e/ou severidade crítica. |
Cada cartão mostra a regra, a mensagem, o domínio, o path, o número de hits e de IPs, e os motivos do veredito. Para decidir:
- Escolha o escopo da exclusão:
- So neste dominio+path: desliga a regra apenas para URLs do domínio que começam com o prefixo do campo de path (você pode editar o prefixo);
- Dominio inteiro: desliga a regra em todo o domínio;
- Global: desliga a regra em todos os domínios.
- Clique em um dos botões:
- Falso-positivo: cria a exclusão no escopo escolhido e recarrega o Coraza;
- ícone de inseto (Marcar como ataque): só registra a decisão, sem mudar regras;
- ícone de olho cortado (Ignorar): tira o item da lista.
O item decidido some da triagem. Para trazer de volta todos os itens decididos, use Limpar decisoes.
Atenção: as regras de pontuação do CRS (IDs 949xxx e 980xxx) não aparecem na triagem. Desligá-las desativaria todo o bloqueio do WAF.
Politica
OWASP Core Rule Set mostra de onde vem o CRS (disco, atualizável, ou embutido no binario) e a versão instalada.
- Verificar atualizacoes consulta a última versão publicada. Se houver uma mais nova, aparece o botão Atualizar, que baixa, valida e aplica o novo CRS e recarrega o Coraza. Se algo falhar, o CRS anterior continua valendo.
- Auto-update semanal do CRS (systemd timer) instala a versão mais recente toda semana, automaticamente.
Politica global do OWASP CRS:
| Campo | O que informar |
|---|---|
| Paranoia level | PL1 (padrão) a PL4 (máximo). Nível maior detecta mais ataques, mas gera mais falsos-positivos. |
| Threshold de anomalia (entrada) | Pontuação a partir da qual a requisição é considerada ataque. Menor = mais rígido (padrão 5). |
| Threshold de anomalia (saida) | O mesmo, para as respostas. |
| Inspecionar corpo da requisicao (POST/JSON) | Liga a análise do corpo de formulários e APIs. |
| Regras desligadas globalmente (IDs) | IDs de regra separados por espaço ou vírgula, desligados em todos os domínios. |
| Diretivas SecLang customizadas (avancado) | Regras próprias do Coraza, inseridas antes do CRS. Use IDs entre 1000 e 9999999. |
Clique em Salvar e aplicar. O Coraza é recarregado sem derrubar conexões.
Exclusoes por dominio
- Exclusoes globais por path: desligam uma regra para um prefixo de URL em todos os domínios, atuais e futuros (útil para a API REST de uma plataforma usada em várias lojas). Informe ID da regra e Prefixo do path (ex.:
/rest/V1) e clique em Adicionar. - Exclusoes por dominio: tabela com o modo do WAF de cada domínio, as regras excluídas no domínio inteiro e as exclusões por path (criadas pela triagem). O botão X remove uma exclusão por path; o lápis abre Exclusoes do dominio, onde você digita os IDs de regra a desligar neste dominio e clica em Salvar e aplicar (deixar vazio remove todas).
A regra excluída continua ativa nos demais domínios e paths.
Eventos
Mostra Regras mais acionadas e a lista Eventos recentes (Hora, Regra, Mensagem, URI, Cliente). Use Só bloqueados e o campo de filtro para refinar. O botão Excluir (ou excluir na linha) abre Excluir regra, onde você escolhe Global (todos os dominios) ou um domínio e confirma em Excluir e aplicar.
Atenção: desligar uma regra reduz a proteção. Prefira sempre o escopo mais estreito: domínio + path, depois domínio inteiro, e global só em último caso.
Logs
Mostra o log bruto do coraza-spoa, lido do Arquivo ou do Servico (journal), com filtro por texto, nível (Todos, Warn+Erro, Só erros), quantidade de linhas, opção JSON, Tempo real e botão para baixar o log.