Como uma organização não enxerga os dados de outra
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:
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());USINGdecide o que a transação enxerga, altera e apaga.WITH CHECKdecide 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.
| Teste | O que prova |
|---|---|
| O papel da aplicação não é superusuário nem ignora RLS | As políticas valem para a aplicação |
| Todas as tabelas com dados de cliente têm RLS ligado e forçado | Tabela nova sem RLS quebra a suíte |
| Sem contexto, a consulta não devolve nada | O estado sem configuração é o fechado |
| A organização A lê as tabelas sem filtro e só recebe linhas de A | Leitura cruzada negada |
| A não insere em B, nem move uma linha própria para B | Escrita cruzada negada pelo banco |
| Alterar ou apagar dados de B afeta zero linhas | As linhas de B são invisíveis para A |
| O contexto não vaza entre transações na mesma conexão | O 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.


