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:

  1. Abra o app logado, F12, aba Network, filtro Fetch/XHR.
  2. Use o app de verdade: liste, abra, edite, exporte. Cada linha que aparece é uma rota.
  3. 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/seed e /api/debug saem 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 matcher mais copiado do Next deixa /api de fora. Confira o seu.
  • Liste as rotas pelo F12 e pelo JavaScript do site, e chame cada uma sem login, em GET e em POST.
  • 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.

← Todos os posts