Pular para o conteúdo

Como uma organização não enxerga os dados de outra

Equipe AIUBYEngenharia de plataforma

PostgreSQL + segurança por linha + testes

A documentação da AIUBY diz, numa frase, que cada organização e cada workspace são isolados no banco, com segurança por linha. Este texto abre essa frase: qual é o mecanismo, por que ele não depende de cada consulta lembrar de filtrar, e quais testes impedem que uma mudança o desfaça sem ninguém notar.

#Onde mora o isolamento

O jeito comum de separar clientes é na aplicação: toda consulta leva um filtro pela organização. Funciona até a consulta que esquece o filtro. Uma listagem nova, um relatório feito com pressa, e o dado de um cliente aparece para outro.

Preferimos que o esquecimento falhe para o lado seguro. Na plataforma, quem aplica a separação é o PostgreSQL, com segurança em nível de linha (RLS). Cada tabela de cliente tem uma política que compara a organização da linha com a organização da transação em curso. Uma consulta sem filtro nenhum devolve só as linhas da organização corrente. Sem organização definida, não devolve nada.

#Segurança por linha, forçada

Ligar o RLS numa tabela não basta. No PostgreSQL, o dono da tabela passa por cima das políticas, a não ser que a tabela esteja marcada para forçá-las. Por isso cada tabela de cliente recebe os dois comandos, e a política vem com duas metades. Em forma simplificada, com nomes genéricos:

sql
ALTER TABLE documento ENABLE ROW LEVEL SECURITY;
ALTER TABLE documento FORCE ROW LEVEL SECURITY;

CREATE POLICY por_organizacao ON documento
  USING (organization_id = organizacao_corrente())
  WITH CHECK (organization_id = organizacao_corrente());
  • USING decide o que a transação enxerga, altera e apaga.
  • WITH CHECK decide o que ela pode gravar. É o que impede uma organização de inserir uma linha em outra, ou de mover uma linha própria para outra.

A função que devolve a organização corrente devolve nulo quando não há contexto. Comparação com nulo não casa com nenhuma linha, então o estado sem configuração é o fechado.

#Um papel que não pode ignorar a regra

Política nenhuma segura um superusuário. Então a aplicação acessa os dados de cliente com um papel de banco próprio, criado sem privilégio de superusuário e sem o atributo que permite ignorar RLS. A migração que cria o papel reafirma esses atributos mesmo se ele já existir, para o caso de alguém tê-lo criado antes com outra configuração.

Esse papel também recebe só as permissões de que precisa, tabela por tabela. Dois exemplos: ele não consegue apagar um workspace, o que levaria as chaves de API em cascata, e na trilha de auditoria só acrescenta.

#O contexto vale por transação

A organização corrente é uma configuração da transação. Todo acesso a dados de cliente passa por um único módulo da aplicação, que abre a transação, fixa a organização e só então executa a consulta. O valor é local à transação: quando ela termina, a conexão volta limpa ao pool. Isso importa porque conexões são reaproveitadas entre requisições de clientes diferentes, e um contexto que sobrevivesse à transação seria exatamente o vazamento que queremos evitar.

A organização fixada não vem do que o cliente pede. Ela é resolvida a partir da sessão ou da chave de API autenticada: um usuário que pede uma organização da qual não é membro é recusado antes de qualquer consulta.

#Workspace: o segundo nível

Dentro da organização, o workspace separa áreas e projetos. Para os dados que pertencem ao workspace, como os documentos do Knowledge e as conversas, a transação fixa também o workspace e quem está agindo (uma pessoa, uma chave ou um processo do sistema), e a política exige os dois: organização e workspace. É por isso que uma chave de API, que vale para um único workspace, não enxerga os outros da mesma organização.

#O que precisa atravessar

Algumas operações não cabem na permissão do papel da aplicação: debitar o saldo quando uma chamada fecha, ajustar um orçamento, gravar certos eventos de auditoria. Para elas existem funções do banco que rodam com o privilégio de quem as definiu. É uma porta estreita, com regras:

  • Cada função faz uma coisa só e confere as próprias condições. A que ajusta o orçamento, por exemplo, verifica o papel de quem pede e o teto antes de gravar.
  • As que atendem o cliente leem a organização do contexto da transação, não de um parâmetro que o chamador escolhe.
  • O caminho de busca de nomes é fixado na definição, para a função não resolver um objeto plantado em outro esquema.
  • A execução é retirada de todos e concedida só ao papel que precisa dela.

O trade-off é real: cada função dessas é código que roda acima das políticas. Um erro nela não é barrado pelo RLS, então a conferência de papel e de organização tem de estar dentro da própria função.

#Os testes que provam

Um mecanismo desses se perde com uma migração descuidada: uma tabela nova sem política, um privilégio a mais. A suíte de isolamento roda num PostgreSQL descartável, com as migrações aplicadas e conectada com o papel da aplicação, não com um administrador. Ela roda na integração contínua, antes do build.

TesteO que prova
O papel da aplicação não é superusuário nem ignora RLSAs políticas valem para a aplicação
Todas as tabelas com dados de cliente têm RLS ligado e forçadoTabela nova sem RLS quebra a suíte
Sem contexto, a consulta não devolve nadaO estado sem configuração é o fechado
A organização A lê as tabelas sem filtro e só recebe linhas de ALeitura cruzada negada
A não insere em B, nem move uma linha própria para BEscrita cruzada negada pelo banco
Alterar ou apagar dados de B afeta zero linhasAs linhas de B são invisíveis para A
O contexto não vaza entre transações na mesma conexãoO pool de conexões é seguro

O teste das tabelas consulta o catálogo do próprio banco, então não depende de alguém lembrar de registrar a tabela nova. As únicas exceções são as tabelas do catálogo compartilhado (produtos, provedores e modelos), que não têm dado de cliente e são só de leitura para a aplicação.

Um detalhe de desenho: sem as variáveis do banco de teste, a suíte falha de propósito. Pular em silêncio esconderia a falta da única prova de isolamento.

#Limites

Limite

O isolamento é lógico: as organizações dividem o mesmo banco, separadas por política. Não há hoje um banco dedicado por cliente. A plataforma também não tem certificação formal de segurança.

  • Teste prova o que testa. A suíte cobre o mecanismo e os casos que conhecemos; não é uma prova formal de ausência de falha.
  • O isolamento vale dentro da plataforma. As chamadas de modelo são enviadas aos provedores e executadas nos servidores deles, fora do Brasil, depois de aplicada a política de dados sensíveis do workspace.
  • A equipe AIUBY opera a plataforma por funções próprias de administração, separadas do caminho do cliente. As mudanças de cobrança feitas por ela ficam na auditoria da organização.

O resumo para quem avalia a plataforma está em Segurança e dados. Sobre o acesso à conta, veja o texto sobre login com senha e verificação em duas etapas.