Segurança e RBAC
Segurança em nível de linha nativa Postgres, funções predefinidas, RBAC multilocatário, logs de auditoria. Suas regras residem no banco de dados — testáveis, versionadas e impossíveis de serem contornadas no lado do cliente.
A segurança mora na base#
Aurabase usa a segurança em nível de linha nativa de PostgreSQL(RLS). Isso significa que suas regras de acesso são escritas em SQL, armazenadas no banco de dados e aplicadas a cada solicitação — incluindo aquelas feitas pelo SDK, PostgREST ou psql direto.
Em um projeto MongoDB, não há RLS. O isolamento é garantido por um campo reservado _owner_id: qualquer leitura de uma função não privilegiada é filtrada no sub do JWT, e qualquer escrita carimba este campo. Três consequências a serem observadas antes de depurar uma lista vazia: um documento criado com uma chave service_role tem não _owner_id e, portanto, torna-se invisível para todos os usuários autenticados (resposta [] em HTTP 200, sem erros); um chamador anon sem JWT recebe um 403 em uma coleção não pública; e _owner_id, reservado, nunca pode ser modificado pelo cliente. Uma coleção é aberta para leitura para todos pelo opt-in explícito public_read.
Contornar uma política é impossível do lado do cliente. O gateway valida cada JWT antes de abrir uma conexão Postgres com a função apropriada. As declarações (auth.uid(), auth.role(), auth.tenant()) são injetadas via request.jwt.claims — não podem ser modificadas a partir de uma consulta SQL.
Tabelas criadas por meio de Aurabase (Studio, API de tabela, migrações ou /raw) obtêm ENABLE e FORCE ROW LEVEL SECURITY automaticamente por padrão (a menos que explicitamente desabilitadas em DDL). Sempre verifique RLS em tabelas criadas por meio de uma conexão direta psql com alter table ... enable row level security antes de adicionar políticas.
JWT → reivindicações → política → linha#
Cada consulta segue o mesmo caminho. O gateway decodifica o JWT, verifica sua assinatura (ES256 com o segredo derivado do projeto por padrão; RS256 com um JWKS somente quando uma chave RSA é configurada), extrai as declarações, abre uma conexão Postgres com SET LOCAL role + SET LOCAL request.jwt.claims. Todas as políticas que fazem referência a auth.*() usam essas declarações.
Client → Gateway verify JWT (ES256 via JWKS, project key)
↓ extract { sub, role, tenant, exp }
Postgres SET LOCAL role = authenticated
SET LOCAL request.jwt.claims = {...}
↓
SELECT ... FROM posts WHERE ...
↓ (RLS injecte la policy USING)
SELECT ... FROM posts WHERE author_id = auth.uid()
Três funções Postgres, hierarquia clara#
| Função | Reivindicações | Descrição |
|---|---|---|
anon | Não user_id | Solicitações feitas com a chave anon e sem usuário assinado JWT |
authenticated | auth.uid() é o usuário | Um usuário conectado com um JWT válido, de qualquer sessão Aurabase |
service_role | Ignora RLS | Chave de back-end que passa todas as políticas. Apenas servidor. |
Cinco padrões essenciais#
As políticas são anexadas a uma tabela + uma operação (SELECT/INSERT/UPDATE/DELETE) + uma função. Várias políticas no mesmo par são combinadas em OR. Use using para filtrar linhas existentes, with check para validar novos valores.
alter table posts enable row level security;
-- Leitura: somente autor
create policy "posts_own_read"
on posts for select
to aura_authenticated
using (auth.uid() = author_id);
Teste suas políticas com pg_prove. Um arquivo rls_posts.sql por tabela, executado em CI em cada migração. Consulte o guia RLS.
Além do anon/autenticado#
As funções do aplicativo (administrador, editor, visualizador, faturamento, etc.) residem na matriz roles do app_metadata do usuário, que somente o servidor pode gravar (a API admin PUT /admin/users/{id} com uma chave service_role ou o gancho do token de acesso). Cada usuário pode ter N funções. Eles viajam no token em app_metadata.roles e auth.has_role('admin') os lê em suas políticas. user_metadata nunca concede uma função: os próprios usuários podem editá-la. Não os confunda com a declaração role do token (anon ou authenticated: a camada Postgres, lida por auth.role()) nem com o campo role do usuário (um rótulo gratuito mostrado no Studio, como user ou editor): nenhum deles concede uma função de aplicativo.
-- O administrador vê tudo
create policy "posts_admin_read"
on posts for select
to aura_authenticated
using (auth.has_role('admin'));
-- O faturamento vê colunas confidenciais em visualização dedicada
create view posts_billing as
select id, author_id, revenue_cents from posts
where auth.has_role('billing');
Rastreamento completo, exportação SIEM#
Cada evento de segurança é registrado em project_{uuid}_auth.auth_audit_log: signin, signout, password_change, mfa_enroll, role_granted, service_role_access, failed_auth. Retenção de 30 dias no Pro, 2 anos no Enterprise.
Exportação automática para seu SIEM (Splunk, Datadog, Elastic) via webhook ou stream Kafka. Consulte /docs/compliance para esquemas de eventos detalhados.