Acesso avaliado para cada linha
A RLS (Row-Level Security) é um mecanismo que restringe quais linhas de uma tabela podem ser consultadas ou modificadas. No PostgreSQL, você habilita esse controle na tabela e define políticas com expressões que retornam verdadeiro ou falso. Uma linha só fica disponível para o comando quando satisfaz as políticas aplicáveis ao papel conectado.
As permissões gerais da tabela continuam necessárias. Conceder SELECT permite tentar a consulta, mas a RLS determina quais linhas ela pode retornar. A documentação do PostgreSQL também distingue a expressão USING, que filtra as linhas existentes, da expressão WITH CHECK, que verifica os novos valores de uma inserção ou atualização.
Um chamado com identificador conhecido
Neste exemplo didático, cada empresa usa um papel próprio do banco. A tabela chamados tem a coluna empresa, cujo valor corresponde ao nome desse papel. Uma política de leitura compara empresa = current_user. Conectada como empresa_a, a aplicação tenta buscar pelo identificador um chamado associado a empresa_b.
A consulta não retorna esse chamado porque a comparação da política é falsa para essa linha, mesmo que a aplicação conheça o identificador. Você deve repetir o teste com o papel usado pela aplicação, pois uma consulta feita pelo proprietário da tabela pode ignorar o filtro.
Esse exemplo pressupõe que a identidade da empresa já foi associada corretamente ao papel conectado. Uma aplicação que compartilha um único papel entre empresas precisa estabelecer outra forma confiável de identificar a empresa para a política. A RLS não deduz essa identidade a partir da tela aberta no navegador.
Exceções de acesso
Superusuários e papéis com BYPASSRLS ignoram as políticas. O proprietário da tabela normalmente também as ignora, salvo com FORCE ROW LEVEL SECURITY. Por isso, credenciais administrativas produzem resultados diferentes dos acessos comuns.
A RLS controla linhas, com políticas que podem variar conforme o comando. Ações sobre a tabela inteira, como TRUNCATE, ficam fora desse controle. As permissões concedidas ao papel precisam considerar essa exceção para evitar que ele possa esvaziar a tabela inteira.
Dúvidas frequentes
Perguntas frequentes sobre RLS
- Habilitar a RLS concede acesso às linhas?
- No PostgreSQL, a RLS habilitada sem política aplicável recusa o acesso normal às linhas. Uma política também não substitui as permissões concedidas na tabela. O papel conectado precisa atender às duas camadas de acesso.
- Uma política de consulta permite inserir registros?
- Uma política definida para SELECT permite somente a leitura prevista por ela. A inserção exige a permissão de INSERT e uma política aplicável ao comando. A expressão WITH CHECK pode verificar os valores da linha que será inserida.
- O administrador está sujeito à mesma política?
- Superusuários e papéis com BYPASSRLS ignoram a RLS. O proprietário da tabela normalmente também a ignora, mas pode ficar sujeito às políticas com FORCE ROW LEVEL SECURITY. Essa configuração não retira a exceção de superusuários e papéis com BYPASSRLS.
Para continuar
Recursos relacionados
Site de referência
Desenvolvimento Colaborativo da Dev Side Studio
Orientação técnica ao vivo para revisar as políticas de RLS e testar consultas com o papel usado pela aplicação.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A RLS permite implementar restrições de acesso aos registros de aplicações com cadastros e organizações diferentes.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.