Saltar para o conteúdo

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.

5 min de leitura

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 sitereq/s razoável
Blog estático, landing pages10-20
Site institucional com formulários10-30
E-commerce (com browsing intenso)20-50
API pública para integrações50-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:

CamadaDefende contraGranularidade
Limite de pedidosAbuso de um único IP — força bruta, scrapingPor IP, ritmo sustentado
Gestão de botsAutomação maliciosa em geral, mesmo se de IPs diferentesPor pedido, baseado em sinais
Proteção DDoSVolume massivo (Gbps) de muitos IPsPor 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

← Toda a documentação