As listas evitam repetir o mesmo conteúdo em várias regras: uma Lista de UA agrupa User-Agents para usar como condição, e uma Lista de dominio agrupa domínios para usar como alvo. A Whitelist libera IPs confiáveis de todo bloqueio, limite e inspeção. As três ficam em Seguranca > Regras.
Listas de UA
Uma lista de UA é um conjunto nomeado de trechos de User-Agent. Numa regra, a condição Lista de UA casa quando o User-Agent do visitante contém qualquer item da lista.
Criar ou editar uma lista
- Vá em Seguranca > Regras e abra a aba Listas de UA.
- Preencha:
| Campo | O que informar |
|---|---|
| Nome da lista | Letras minúsculas, números, - e _, até 40 caracteres. Ex.: bots-ruins. |
| User-Agents (1 por linha) | Um trecho por linha (vírgulas também separam). A comparação ignora maiúsculas: ahrefsbot pega AhrefsBot/7.0. |
- Clique em Salvar lista.
Para editar, clique no lápis (editar) da lista: o formulário é preenchido com o conteúdo atual. Salvar com um nome que já existe substitui a lista inteira. As regras que usam a lista passam a valer com o novo conteúdo na hora.
Usar numa regra
Na aba Condicoes, adicione uma condição do tipo Lista de UA e digite o nome da lista (o campo sugere os nomes existentes). Veja Regras e condições.
Apagar
Clique no X da lista. Se alguma regra ainda usa a lista, o painel recusa e informa em quais alvos ela está em uso. Remova essas regras primeiro.
Listas de domínio
Uma lista de domínio permite que uma única regra valha para vários domínios ao mesmo tempo, por exemplo todas as lojas de uma mesma plataforma.
Criar ou editar uma lista
- Abra a aba Listas de dominio.
- Em Nome da lista, informe o nome (ex.:
lojas-magento), com as mesmas regras de nome das listas de UA. - Em Dominios (selecione), marque os domínios. Use o campo filtrar dominios... para achar rápido e os atalhos todos / nenhum para marcar ou desmarcar os visíveis.
- Clique em Salvar lista.
Só aparecem domínios que já estão configurados no HAProxy. Salvar com um nome existente substitui a lista. O lápis (editar) carrega a lista no formulário com os domínios marcados.
Usar numa regra
No campo Dominio da nova regra, a lista aparece no grupo Listas de dominio como Lista: nome (quantidade). As regras dessa lista aparecem num quadro próprio, "Lista: nome".
Dica: ao incluir um domínio novo na lista, todas as regras da lista passam a valer para ele imediatamente, sem precisar recriar nada.
Apagar
Clique no X. Se a lista for alvo de alguma regra, o painel recusa a exclusão até você remover essas regras.
Whitelist
IPs e faixas da Whitelist são liberados de tudo: Blocklist global (inclusive a recusa na conexão TCP), Listas de ameaças, Paths isca, bloqueio temporário de IP, Limite por domínio, regras condicionais e WAF. Vale para todos os domínios.
Use para:
- o IP fixo do seu escritório ou da sua VPN;
- webhooks de gateways de pagamento e de ERPs;
- serviços de monitoramento;
- crawlers ou integrações que estejam sendo barrados indevidamente.
Editar a Whitelist
- Abra a aba Whitelist.
- No campo de texto, informe um IP ou faixa CIDR por linha (vírgula ou espaço também separam). Ex.:
203.0.113.10ou198.51.100.0/24. - Clique em Salvar whitelist.
O HAProxy é recarregado e a mensagem Lista de confianca salva (n entrada(s)) confirma a gravação.
Atenção: um IP na Whitelist não passa por nenhuma proteção, nem pelo WAF. Inclua só endereços que você controla ou de parceiros confiáveis, e prefira IPs individuais a faixas grandes.
Dica: se o domínio está atrás da Cloudflare, cadastre o IP real do visitante (o painel avalia a Whitelist depois de recuperar o IP real), nunca uma faixa da Cloudflare.