Limite de pedidos
Limita quantos pedidos um mesmo IP pode fazer por segundo. Trava força bruta, scraping agressivo e pequenos ataques sem afetar o uso normal. Diferente da proteção DDoS, que opera em volumes muito maiores.
Porque existe
Sem rate limit, qualquer um pode:
- Tentar 100 mil passwords no teu login.
- Copiar todo o teu catálogo de produtos em 30 segundos.
- Inundar o teu servidor com pedidos legítimos a um endpoint pesado.
- Fazer um DDoS pequeno (Layer 7) de um único IP — não precisa de botnet.
O rate limit é a defesa simples e eficaz contra estes cenários. Mesmo que o pedido pareça legítimo (não dispara o WAF, não cai na gestão de bots), o volume por si só é suspeito e pode esgotar recursos do teu servidor.
Como funciona — o algoritmo "token bucket"
Imagina um balde com fichas. Cada pedido precisa de uma ficha para passar. O balde:
- Tem capacidade máxima = ritmo configurado + margem de burst.
- Recarrega ao ritmo definido (ex.: 10 fichas por segundo).
Resultado:
- Se o utilizador faz menos pedidos do que o ritmo (ex.: 5 req/s com limite de 10), o balde está sempre cheio — passa tudo.
- Se faz exatamente o ritmo (10 req/s), funciona em estado estacionário.
- Se faz picos curtos (ex.: 30 pedidos em 1 segundo, depois pausa), os primeiros consomem o burst e passam; os seguintes dependem do recharge.
- Se faz sustained spam (ex.: 50 req/s constante), só os primeiros 10 passam por segundo; o resto é rejeitado.
Os parâmetros
Pedidos por segundo
O ritmo aceite por cada IP. Recomendações:
| Tipo de site | req/s razoável |
|---|---|
| Blog estático, landing pages | 10-20 |
| Site institucional com formulários | 10-30 |
| E-commerce (com browsing intenso) | 20-50 |
| API pública para integrações | 50-200 (consoante uso esperado) |
| Site interno (poucos utilizadores totais) | 5-10 |
Margem para picos curtos (burst)
Quantos pedidos extra acima do ritmo são tolerados em rajadas. Recomendação: 2× o ritmo.
Exemplo: ritmo 10 + burst 20 = utilizador pode fazer 30 pedidos numa rajada inicial sem ser bloqueado; daí em diante o limite efetivo é 10 req/s.
Como tratar a margem extra
- Sem atrasos (recomendado): rejeita imediatamente o excesso. Resposta rápida ao cliente, sem segurar conexões.
- Atrasar: enfileira pedidos acima do ritmo até serem rejeitados ou processados. Resulta em respostas lentas em vez de erros — pior UX e mais consumo do edge.
Default e recomendação: Sem atrasos. Erro 429 é claro para o cliente, que pode implementar retry com backoff.
Resposta enviada
Que código HTTP devolve a pedidos rejeitados:
- 429 Too Many Requests (recomendado, semântico).
- 503 Service Unavailable (legado, ainda usado por alguns sistemas — mensagem é "estamos sobrecarregados" em vez de "tu estás a abusar").
A maior parte dos clientes (browsers, libraries HTTP, integrações) reconhecem 429 e o cabeçalho Retry-After.
Rate limit vs gestão de bots vs DDoS
São camadas diferentes para problemas diferentes:
| Camada | Defende contra | Granularidade |
|---|---|---|
| Limite de pedidos | Abuso de um único IP — força bruta, scraping | Por IP, ritmo sustentado |
| Gestão de bots | Automação maliciosa em geral, mesmo se de IPs diferentes | Por pedido, baseado em sinais |
| Proteção DDoS | Volume massivo (Gbps) de muitos IPs | Por agregado, ritmo extremo |
Usa as três em paralelo — atacam ângulos diferentes do problema.
Casos comuns onde o rate limit ajuda
Brute-force em /login: alguém tenta 10 000 passwords no teu endpoint de login. Com rate limit de 10 req/s, o atacante leva 17 minutos para tentar (em vez de segundos), o que dá tempo para outras defesas (lockout, alerta) entrarem em ação.
Scraping de catálogo: scraper tenta puxar 100 mil URLs em 10 minutos. Com rate limit, fica preso a 10 req/s — leva quase 3 horas, com 429 constante a sinalizar.
Spam num formulário: spambot tenta submeter 200 vezes/segundo. 429 desde o segundo 2.
Casos onde o rate limit cria fricção
Páginas que carregam muitos recursos sem cache: site novo, sem otimização, primeira visita carrega 200 ficheiros — pode estourar burst e gerar erros visuais. Solução: ativa cache para os assets (vai imediatamente a 200 cache-hits sem afetar o limite) ou sobe o ritmo/burst.
Crawler legítimo do Google: o Googlebot pode visitar páginas em ritmo alto. Solução: adiciona-o à whitelist de bots de confiança, que ignoram o rate limit (e a pontuação de bot).
Integrações de parceiros: API consumidores legítimos podem precisar de mais ritmo. Solução: ou sobe o limite global, ou adiciona os IPs deles à lista de IPs sempre permitidos (passam à frente do rate limit também).
Onde mexer
Proteção → IPs e limites → Limite de pedidos por visitante.
Em mais detalhe técnico
Algoritmo: nginx-module-limit-req (token bucket variant). Zona partilhada por site, 10 MB por zona — comporta ~160 000 IPs únicos na janela ativa.
Granularidade: por $binary_remote_addr (IP do cliente). Não distingue por path ou método. Se quiseres rate-limit diferente para /login vs /api/produtos, será um futuro melhoramento (rate limits por path).
Headers de resposta a 429:
Retry-After: <segundos>— quanto esperar antes de tentar de novo.X-RateLimit-Limit,X-RateLimit-Remaining— informativos, alguns clientes consomem-nos.
Distribuição entre edges: cada edge mantém o seu próprio bucket (não há coordenação cross-edge). Significa que um atacante que distribui pedidos por vários edges pode efetivamente multiplicar o limite. Em prática, o DNS encaminha um cliente para o edge mais próximo, então 1 IP = 1 edge na esmagadora maioria dos casos. Para coordenação cross-edge usa-se a proteção DDoS, que opera em camada diferente.
Interação com IPv6: por defeito conta cada IP individualmente. Em IPv6, atacantes podem usar /64 inteiros (18 quintilhões de endereços por usuário). Uma extensão futura agrupará IPv6 em prefixos /64 ou /48 para evitar esta evasão.
Próximos passos
- Proteção DDoS — para volumes muito maiores.
- Gestão de bots — para automação maliciosa que não atinge volumes altos.