API sem autenticação: a tela pede login, a rota não

A tela de administração só aparece para quem é admin. A lista de clientes só abre depois do login. Tudo certo na tela. Só que a tela não guarda nada: ela pede os dados a uma rota, e quem quer os seus dados chama a rota direto.
Por que acontece
Num app moderno, cada tela é duas coisas: a página que você vê e as rotas de API que ela chama para buscar e gravar dados. Proteger a página é a parte visível, e é a que todo mundo testa. Proteger a rota é a parte invisível, e é a que fica para trás.
Três padrões aparecem o tempo todo em app feito com IA:
O middleware que não olha a API. No Next.js, o exemplo mais copiado de
middleware.ts usa um matcher que exclui /api. As páginas pedem
login; as rotas, não.
export const config = {
// tudo menos api, arquivos estáticos e imagens
matcher: ["/((?!api|_next/static|_next/image|favicon.ico).*)"],
}
A verificação que só existe no front. O componente confere
if (user.role === "admin") antes de mostrar o botão. A rota que o botão
chama não confere nada.
A rota que ninguém lembra que existe. /api/seed, /api/debug,
/api/test, a rota que exporta CSV e foi criada "só para testar".
Nenhuma tela leva até ela, e por isso ninguém pensou em proteger. Mas ela
responde.
Como achar as suas rotas
Você não precisa do código para listar as rotas. O próprio navegador mostra:
- Abra o app logado, F12, aba Network, filtro Fetch/XHR.
- Use o app de verdade: liste, abra, edite, exporte. Cada linha que aparece é uma rota.
- Procure também no JavaScript que o site entrega. F12 → Sources →
Ctrl+Shift+F →
"/api/. Rotas que nenhuma tela usa costumam aparecer ali.
Confira também se a documentação da sua API está aberta para o mundo:
curl -s -o /dev/null -w "%{http_code}\n" https://seuapp.com.br/api-docs
curl -s -o /dev/null -w "%{http_code}\n" https://seuapp.com.br/swagger.json
200 aí entrega a lista completa de rotas, com os parâmetros de cada uma.
O teste
Para cada rota da lista, chame sem estar logado:
curl -i https://seuapp.com.br/api/clientes
curl -i -X POST https://seuapp.com.br/api/clientes \
-H "Content-Type: application/json" -d '{}'
O esperado é 401 ou 403. Se vier 200 com dados, a rota não confere quem
está chamando.
Teste os dois métodos. É comum a leitura (GET) estar protegida e a gravação
(POST, PUT, DELETE) não, ou o contrário. Faça isso só no seu próprio app,
e com cuidado nas rotas que gravam ou apagam: use uma conta e dados de teste.
Se você usa Server Actions (Next.js), elas também são rotas: o navegador as
chama com um POST para a própria página. A documentação do Next diz para
tratar cada uma como um endpoint público. Uma action que lê ou grava dado
precisa conferir a sessão dentro dela, mesmo que a página já peça login.
Se você usa GraphQL, a rota é uma só (/graphql ou /api/graphql), mas
cada query e cada mutation precisa da sua própria verificação. Mutation
que cria usuário ou muda permissão sem pedir login é o caso grave.
O conserto: a verificação mora na rota
A regra é uma só: toda rota que lê ou grava dado confere a sessão no servidor, antes de fazer qualquer coisa. Não no componente, não só no middleware da página.
// app/api/clientes/route.ts
export async function GET() {
const session = await auth()
if (!session) return new Response(null, { status: 401 })
if (session.user.role !== "admin") return new Response(null, { status: 403 })
return Response.json(await db.cliente.findMany())
}
Para não depender de lembrar em cada arquivo, inverta o padrão: tudo
fechado, com exceções por nome. Um middleware que pega também /api e só
libera uma lista curta e explícita de rotas públicas (login, cadastro,
webhook) é mais difícil de esquecer do que uma verificação por arquivo.
Dois cuidados:
- Webhook é rota pública por natureza. Ele não tem sessão, então precisa de outra prova: um token no cabeçalho ou a assinatura do provedor, conferida antes de processar.
- Rota de teste não vai para produção.
/api/seede/api/debugsaem do deploy, não ganham senha.
E depois do login
Esta é a primeira metade. Uma rota que exige login ainda pode devolver dados de outra pessoa se não conferir de quem é o registro, e uma rota que confere o token pode estar conferindo errado. As duas metades seguintes estão em IDOR: o que é e JWT mal configurado.
O resumo
- A tela pede login; a rota precisa pedir de novo, no servidor.
- O
matchermais copiado do Next deixa/apide fora. Confira o seu. - Liste as rotas pelo F12 e pelo JavaScript do site, e chame cada uma sem
login, em
GETe emPOST. - Server Actions e mutations de GraphQL são rotas também.
- Tudo fechado por padrão, com uma lista curta de exceções. Webhook com token, rota de teste fora do deploy.
No ShieldScan, as rotas sem login estão no Scan Padrão (3 créditos). O acesso a registro de outra conta fica no Completo (5).
Rota sem login é um dos 5 pontos que mais falham em app feito com IA. Os outros, e como testar cada um, estão em App feito com IA é vulnerável? 5 pontos para testar.
