postgresrlsseguranca

RLS no Postgres: o modelo mental para quem vem do backend tradicional

Quem vem de "autorização é lógica de aplicação" estranha Row Level Security no início. O modelo mental muda: a permissão vira parte da query, não do código que a chama.

Conhecer VPS
Por NullNinja6 min de leitura
Voltar pro blog
RLS no Postgres: o modelo mental para quem vem do backend tradicional

A mudança de lugar da autorização

Em backend tradicional, autorização é código: um middleware confere se request.user.id === resource.owner_id antes de deixar a query rodar. O banco não sabe nada sobre permissão — ele confia cegamente em quem manda a query.

Row Level Security (RLS) no Postgres inverte esse modelo: a permissão vira parte do próprio banco, aplicada linha a linha, independente de quem ou o quê está fazendo a query. Isso é poderoso e também é onde quem vem do modelo tradicional mais erra no início.

O modelo mental correto

Pense em RLS não como "mais uma validação", mas como um filtro WHERE implícito, injetado pelo Postgres em toda query contra a tabela, com base em uma policy que você define. Uma policy como

CREATE POLICY "usuarios_veem_so_seus_dados"
ON pedidos FOR SELECT
USING (auth.uid() = usuario_id);

significa: mesmo que a aplicação rode SELECT * FROM pedidos, o banco devolve só as linhas onde usuario_id bate com o usuário autenticado na sessão. A aplicação não precisa (e não deve) confiar em filtrar isso no código.

As armadilhas mais comuns

  • Esquecer de habilitar RLS na tabela. CREATE POLICY sem ALTER TABLE ... ENABLE ROW LEVEL SECURITY não faz nada — a tabela continua aberta.
  • Policy demais silenciosa. Sem nenhuma policy que dê USING (true) explícito, uma tabela com RLS habilitado nega tudo por padrão — inclusive para o dono dos dados, se a policy estiver mal escrita. O sintoma comum é "sumiu tudo" depois de habilitar RLS.
  • Confundir USING com WITH CHECK. USING filtra o que pode ser lido/afetado; WITH CHECK valida o que pode ser escrito. Uma policy de UPDATE sem WITH CHECK deixa alguém trocar o usuario_id de uma linha para outro usuário.
  • Rodar queries administrativas com a role errada. Um console de banco ou job interno que precisa ver tudo deve rodar com uma role que faz bypass de RLS (BYPASSRLS) de forma explícita e auditável — nunca desabilitando RLS na tabela para todo mundo.

Quando vale usar

RLS compensa quando o isolamento entre usuários/workspaces é a regra central do produto (multi-tenant, SaaS com dados sensíveis) e quando mais de um cliente de banco acessa a mesma tabela — API, jobs, console administrativo. Nesses casos, colocar a regra no banco garante que nenhum caminho de acesso esqueça de aplicá-la. Em sistemas com um único ponto de entrada e equipe pequena, autorização em código de aplicação continua sendo mais simples de debugar — a escolha depende de quantos lugares diferentes tocam o mesmo dado.