Ir para o conteúdo
Aura Logo
aurabase

RBAC multilocatário

Modele funções de aplicativo (administrador, editor, visualizador, faturamento) sobre Aurabase Auth. Padrões para organizações simples e hierárquicas e permissões por recurso.

Guia prático10 min lidoNível avançadoRevisado em 15 de abr. de 2026

Esta página foi traduzida automaticamente. A versão em inglês é oficial.

Tabelas: membros, funções, permissões#

migrations/rbac.sqlsql
create table orgs (id uuid primary key default gen_random_uuid(), name text not null);

create table org_members (
  org_id   uuid references orgs(id) on delete cascade,
  user_id  uuid references auth.users(id) on delete cascade,
  roles    text[] not null default '{}',
  primary key (org_id, user_id)
);

Injete as funções no JWT#

Uma Edge Function conectada como Auth Hook enriquece o JWT com tenant (org_id ativo) + roles (matriz). Eles são mesclados no app_metadata do token, onde auth.tenant() e auth.has_role() os leem em suas políticas.

functions/jwt-enrich.tstypescript
Deno.serve(async (req) => {
  // Solicitação: {evento, project_id, user_id, email, role}, assinado com X-Hook-Signature.
  const { user_id } = await req.json()
  const { data: m } = await aura
    .from('org_members')
    .select('org_id, roles')
    .eq('user_id', user_id).single()

  // Resposta: {reivindicações: {… } }. Suas chaves são mescladas em app_metadata. Um gancho que falha,
  // responde com qualquer outra coisa ou define uma reivindicação protegida (sub, função, aud…) recusa o login.
  return Response.json({
    claims: { tenant: m?.org_id, roles: m?.roles || [] },
  })
})
Informações

O gancho é executado no login e em cada atualização. A modificação das funções de um usuário torna-se ativa na próxima atualização do token (máximo de 15 minutos).

Combine inquilino + funções#

migrations/orgs_rls.sqlsql
-- Qualquer membro da organização vê os projetos
create policy "projects_read" on projects
  for select to aura_authenticated
  using (org_id = auth.tenant());

-- Somente o administrador pode criar/excluir
create policy "projects_admin" on projects
  for all to aura_authenticated
  using (org_id = auth.tenant() and auth.has_role('admin'))
  with check (org_id = auth.tenant());

Provisionamento automático via SCIM#

No plano Enterprise, habilite SCIM 2.0 do Okta, Azure AD, Google Workspace. Usuários + funções são sincronizados automaticamente: adição/remoção imediata, desprovisionamento instantâneo quando um funcionário sai.

Para ir mais longe#