Segurança no Next.js: a Server Action é a API do seu app

O /painel pede login. O middleware.ts confere a sessão e manda quem não tem para o /login. Você testou: deslogado, não entra. Só que a lista de clientes do painel vem de uma Server Action, listarClientes(), e a Server Action não mora no painel. Ela mora no app inteiro. Um POST para o /login, que é público, com o id dela no cabeçalho, devolve a lista.

A Server Action é uma rota

Quando você escreve "use server", o Next transforma a função numa rota: o navegador chama com um POST, mandando o id da action no cabeçalho Next-Action. Esse id vai no JavaScript que o site entrega, junto com o nome da função. Quem abre o F12 vê os dois.

E o id não fica preso à página que usa a action. Ele vale em qualquer endereço do app. Por isso o middleware que protege o /painel não protege a action do painel: basta chamar por uma página que o middleware deixa passar.

A própria documentação do Next diz isso com outras palavras: trate cada Server Action como um endpoint público e confira a autorização dentro dela.

Três jeitos de errar que se repetem

A action que confia na página. O gerador de código escreve a action assim, porque a página já pediu login:

"use server"
export async function listarClientes() {
  return db.cliente.findMany()
}

Nada ali confere quem está chamando.

O middleware como única porta. Em março de 2025, a CVE-2025-29927 mostrou que um cabeçalho (x-middleware-subrequest) fazia o Next pular o middleware inteiro em versões de 11.1.4 a 15.2.2. Quem tinha a verificação só no middleware ficou sem nenhuma. Foi corrigido (12.3.5, 13.5.9, 14.2.25 e 15.2.3), mas a lição vale para qualquer versão: o middleware é um filtro de navegação, não a tranca do dado. No Next 16 o arquivo passou a se chamar proxy.ts, e o conselho é o mesmo.

A action que devolve o registro inteiro. Tudo o que a action retorna vai para o navegador. return db.usuario.findUnique(...) manda o hash da senha, o token de recuperação e o que mais estiver na tabela, mesmo que a tela só mostre o nome.

O conserto: a verificação mora no acesso ao dado

Coloque a checagem de sessão numa função só e chame essa função antes de qualquer leitura ou gravação. É o que a documentação do Next chama de camada de acesso a dados.

// lib/dal.ts
import "server-only"
import { auth } from "@/auth"

export async function exigirSessao() {
  const session = await auth()
  if (!session) throw new Error("não autenticado")
  return session
}
// app/painel/actions.ts
"use server"
import { exigirSessao } from "@/lib/dal"

export async function listarClientes() {
  const session = await exigirSessao()
  return db.cliente.findMany({
    where: { empresaId: session.user.empresaId },
    select: { id: true, nome: true, email: true },
  })
}

Três coisas mudaram:

  • a sessão é conferida dentro da action, e não importa de qual página veio o POST;
  • o where filtra pelo dono, para uma conta não ler os clientes de outra (isso é IDOR);
  • o select escolhe os campos, e só eles saem do servidor.

O import "server-only" faz o build quebrar se alguém importar esse arquivo num componente de cliente. É barato e evita levar código de servidor para o navegador sem querer.

Os outros pontos do Next que pedem a mesma regra:

  • Route Handlers (app/api/.../route.ts): o matcher mais copiado deixa /api de fora. Está explicado em API sem autenticação.
  • NEXT_PUBLIC_: tudo o que tem esse prefixo vai escrito no JavaScript do site. Chave secreta não pode ter o prefixo. Detalhes em chave de API exposta no front.
  • Origem do pedido: o Next recusa Server Action vinda de outro domínio comparando o Origin com o Host. Se você abriu exceções em serverActions.allowedOrigins, confira se cada uma é sua mesmo.

Como testar o seu app

Faça isso só no seu app, com uma conta e dados de teste.

  1. Abra o app logado, F12, aba Network. Use a tela que chama a action e procure um POST com o cabeçalho Next-Action. Copie o valor.
  2. Deslogue (ou abra uma janela anônima) e chame a mesma action por uma página pública:
curl -i -X POST https://seuapp.com.br/login \
  -H "Next-Action: <id-copiado>" \
  -H "Content-Type: text/plain;charset=UTF-8" \
  -d '[]'

Se a resposta trouxer os dados, a action não confere a sessão. O esperado é um erro ou um redirect para o login, sem dado nenhum.

  1. Veja a versão do Next: no console do navegador, next.version. Se ela estiver numa faixa com correção de segurança publicada, atualize antes de qualquer outra coisa.

Teste só actions de leitura dessa forma. Uma action que apaga, envia ou cobra executa de verdade.

O resumo

  • Toda função com "use server" é uma rota pública, e o id dela vale no app inteiro.
  • O middleware protege a navegação, não o dado. Confira a sessão dentro de cada action, numa função só.
  • Filtre pelo dono e escolha os campos: o que a action retorna vai para o navegador.
  • Route Handlers, NEXT_PUBLIC_ e allowedOrigins seguem a mesma regra.
  • Teste deslogado, chamando a action por uma página pública.

O Scan Padrão do ShieldScan (3 créditos) faz esse teste de fora: encontra as Server Actions no JavaScript e nos formulários do site, chama sem cookie só as de leitura (as que gravam ou apagam nunca são chamadas) e aponta dado devolvido sem login, erro que vaza stack ou credencial e versão do Next com falha conhecida. A lista dos outros pontos que mais falham está em App feito com IA é vulnerável? 5 pontos para testar.

← Todos os posts