
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 POLICYsemALTER TABLE ... ENABLE ROW LEVEL SECURITYnã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
USINGcomWITH CHECK.USINGfiltra o que pode ser lido/afetado;WITH CHECKvalida o que pode ser escrito. Uma policy deUPDATEsemWITH CHECKdeixa alguém trocar ousuario_idde 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.