Rate Limiting: Bloqueando Ataques DDoS e Spam (Upstash Redis)
Índice do Manual
No mercado B2B, a segurança do sistema não é uma escolha, é a fundação. Um dos golpes mais silenciosos e custosos que um SaaS pode sofrer não é o roubo de dados, mas o abuso financeiro de APIs.
Seja um script malicioso (bot) tentando descobrir a senha do administrador via Força Bruta (brute-force) ou um concorrente rodando um loop infinito para esgotar as suas cotas pagas da API do ChatGPT (OpenAI), o estrago financeiro pode ser brutal se não houver um escudo.
O erro arquitetural clássico é validar esses limites dentro da própria Rota de API, acessando o banco de dados principal (Postgres). Quando o ataque chega no banco de dados, o dano na infraestrutura e o uso de CPU já ocorreram.
Aqui vou falar agora sobre a segurança na porta de entrada da aplicação. Neste manual, documento a implementação do Upstash Redis diretamente no Proxy (antigo Middleware) do Next.js para interceptar e abater requisições maliciosas antes mesmo que elas cheguem ao núcleo do sistema.
Middleware.ts depreciado: No Next.js 16, a convenção middleware.ts foi depreciada (ainda funciona, mas não é mais o caminho recomendado) e renomeada para proxy.ts, que exporta a função proxy(). O Proxy roda no runtime Node.js e não aceita a opção runtime (declarar export const runtime = 'edge' nele gera erro). Siga este manual utilizando as novas nomenclaturas descritas abaixo.
1. O Proxy e o Upstash Redis
O Proxy do Next.js executa antes de qualquer rota ser renderizada. No Next.js 16 ele roda no runtime Node.js, e é o ponto ideal para barrar uma requisição antes que ela chegue à rota de API e ao banco de dados.
O Vercel KV foi descontinuado em dezembro de 2024, e os bancos existentes migraram para o Upstash Redis, que hoje é instalado pelo Vercel Marketplace. É um banco de dados em memória (Redis) serverless, acessado por HTTP, com leituras e gravações muito rápidas. É a ferramenta perfeita para atuar como o "segurança da porta da frente".
Vou utilizar os pacotes oficiais @upstash/ratelimit e @upstash/redis. O Redis.fromEnv() lê tanto as variáveis do Upstash (UPSTASH_REDIS_REST_URL e UPSTASH_REDIS_REST_TOKEN) quanto as herdadas do antigo Vercel KV (KV_REST_API_URL e KV_REST_API_TOKEN).
npm install @upstash/redis @upstash/ratelimit
2. A Blindagem do Proxy (O Código)
Neste cenário de arquitetura, vou aplicar duas proteções críticas simultâneas:
- Rota de Login: Um IP não pode fazer mais de 5 tentativas de login em uma janela de 1 hora.
- Rota de Inteligência Artificial: Um usuário (ou IP) não pode gerar mais de 10 respostas de IA por minuto.
O código abaixo deve ser alocado na raiz do projeto Next.js (proxy.ts).
// proxy.ts
import { NextResponse } from 'next/server'
import type { NextFetchEvent, NextRequest } from 'next/server'
import { Ratelimit } from '@upstash/ratelimit'
import { Redis } from '@upstash/redis'
const redis = Redis.fromEnv()
// 1. Criamos os limites de velocidade com base em diferentes cenários
const loginRateLimit = new Ratelimit({
redis,
prefix: 'ratelimit:login',
// Limite de Login: 5 tentativas em uma janela de 1 hora
limiter: Ratelimit.slidingWindow(5, '1 h'),
})
const aiRateLimit = new Ratelimit({
redis,
prefix: 'ratelimit:ai',
// Limite de IA: 10 chamadas em uma janela de 1 minuto
limiter: Ratelimit.slidingWindow(10, '1 m'),
})
export async function proxy(request: NextRequest, event: NextFetchEvent) {
// request.ip não existe mais no Next.js 15+; na Vercel, o IP vem nos headers
const ip =
request.headers.get('x-real-ip') ??
request.headers.get('x-forwarded-for')?.split(',')[0]?.trim() ??
'127.0.0.1'
const path = request.nextUrl.pathname
// 2. Blindagem da Rota de Autenticação (Anti Força-Bruta)
if (path.startsWith('/api/auth/login')) {
const { success, pending } = await loginRateLimit.limit(ip)
// Garante que tarefas em segundo plano da lib terminem após a resposta
event.waitUntil(pending)
if (!success) {
return new NextResponse(
JSON.stringify({ error: 'Muitas tentativas de login. Tente novamente mais tarde.' }),
{ status: 429, headers: { 'Content-Type': 'application/json' } }
)
}
}
// 3. Blindagem de Rotas de Custo Elevado (APIs de Inteligência Artificial)
if (path.startsWith('/api/ai/')) {
const { success, limit, remaining, pending } = await aiRateLimit.limit(ip)
event.waitUntil(pending)
if (!success) {
return new NextResponse(
JSON.stringify({ error: 'Limite de geração de IA atingido (10/minuto).' }),
{ status: 429, headers: { 'Content-Type': 'application/json' } }
)
}
// Podemos também injetar os cabeçalhos para o frontend saber o limite restante
const response = NextResponse.next()
response.headers.set('X-RateLimit-Limit', limit.toString())
response.headers.set('X-RateLimit-Remaining', remaining.toString())
return response
}
return NextResponse.next()
}
// 4. Configuração para ignorar rotas estáticas e imagens,
// rodando o proxy apenas nas rotas necessárias
export const config = {
matcher: ['/api/auth/:path*', '/api/ai/:path*'],
}
3. O Veredito Arquitetural
Ao injetar o Ratelimit com Redis no Proxy, você impede que qualquer gota de processamento do seu backend, banco de dados ou integração externa seja desperdiçada com tráfego abusivo.
Se um ataque DDoS bater contra a rota de autenticação, o Proxy abate as requisições excedentes antes de elas chegarem às suas rotas (com retornos Http Status 429 Too Many Requests), devolvendo a segurança matemática que o seu caixa financeiro precisa para operar com lucro.
Qualquer rota de altíssimo impacto ou processamento desenhada a partir de agora nessa arquitetura nascerá protegida por essa barreira primária de defesa.
Precisa de apoio técnico para a sua empresa?
Se a sua operação busca especialistas para modernização de sistemas legados ou desenvolvimento de sistemas sob medida com arquitetura de alta performance (Next.js e Supabase), conheça meus serviços de tecnologia ou fale diretamente comigo pelo WhatsApp.