{"title":"Multi-tenancy e isolamento","slug":"multi-tenancy","category":"concepts","summary":"Como o Synapse isola dados entre usuários e minds — fronteiras de segurança explicadas.","audience":["human","llm"],"tags":["concept","multi-tenancy","security","isolation"],"difficulty":"intermediate","updated":"2026-06-27","word_count":590,"read_minutes":3,"lang":"pt","translated":true,"requested_lang":"pt","content_markdown":"\n# Multi-tenancy e isolamento\n\nO Synapse é multi-tenant: múltiplos usuários, cada um com múltiplos minds,\ntotalmente isolados entre si. Esta página explica o modelo de isolamento.\n\n## Hierarquia de tenants\n\n```\nSynapse Instance\n │\n ├── User Account 1 (email: alice@example.com)\n │ ├── Mind A (Mind Key mk_aaa...)\n │ │ ├── Memories (only accessible via mk_aaa...)\n │ │ ├── Tasks\n │ │ └── Chat\n │ └── Mind B (Mind Key mk_bbb...)\n │ └── ... (isolated from Mind A)\n │\n ├── User Account 2 (email: bob@example.com)\n │ └── Mind C (Mind Key mk_ccc...)\n │ └── ... (isolated from Alice's minds)\n │\n └── ... (more users)\n```\n\n## Níveis de isolamento\n\n### Nível 1: isolamento de usuário\n\nCada conta de usuário é isolada. Alice não pode:\n\n- Ver os minds do Bob\n- Acessar as memórias do Bob (mesmo com o JWT dela)\n- Listar informações da conta do Bob\n\nAplicado por: coluna `user_id` em todas as tabelas, JWT contém `user_id`,\ntodas as consultas filtram por `user_id`.\n\n### Nível 2: isolamento de mind\n\nDentro de um usuário, cada mind é isolado. Mind A não pode:\n\n- Ver as memórias do Mind B\n- Acessar tarefas, chat, scripts do Mind B\n\nAplicado por: coluna `mind_id` em todas as tabelas de dados, Mind Key contém\n`mind_id`, todas as consultas filtram por `mind_id`.\n\n> [!CRITICAL]\n> O isolamento por Mind Key é a fronteira de segurança primária. Uma Mind Key\n> vazada concede acesso total aos dados daquele mind — mas SOMENTE àquele mind.\n\n## Tokens de autenticação\n\n| Token | Escopo | O que pode acessar |\n|-------|--------|---------------------|\n| Mind Key | Mind único | Apenas dados daquele mind |\n| JWT | Conta de usuário | Gerenciamento de conta (criar/listar/excluir minds) |\n| Computer Token | Computador único | Comandos daquele computador |\n\n## Acesso cross-mind\n\n### Dentro do mesmo usuário\n\nO usuário pode acessar todos os seus minds via JWT (ex.: `GET /minds` lista\ntodos). Mas para ler/escrever dados de memória, ele precisa da Mind Key\nespecífica.\n\n### Entre usuários\n\nUsuários não podem acessar dados um do outro — A MENOS que compartilhem\nexplicitamente um mind via API de Compartilhamento:\n\n```bash\n# Alice shares Mind A with Bob\ncurl -X POST https://synapse.schaefer.zone/sharing \\\n -H \"Authorization: Bearer ALICE_JWT\" \\\n -d '{\"mind_id\": \"m_aaa\", \"email\": \"bob@example.com\", \"role\": \"read\"}'\n```\n\nApós compartilhar, Bob pode acessar o Mind A via seu JWT (somente leitura se\n`role=read`).\n\n## Fronteiras de segurança\n\n```\n┌─────────────────────────────────────────────────┐\n│ Synapse Instance │\n│ ┌─────────────────────────────────────────┐ │\n│ │ User Account Boundary │ │\n│ │ ┌──────────────┐ ┌──────────────┐ │ │\n│ │ │ Mind Bound. │ │ Mind Bound. │ │ │\n│ │ │ (Mind Key) │ │ (Mind Key) │ │ │\n│ │ │ │ │ │ │ │\n│ │ │ Memories │ │ Memories │ │ │\n│ │ │ Tasks │ │ Tasks │ │ │\n│ │ │ Chat │ │ Chat │ │ │\n│ │ │ Scripts │ │ Scripts │ │ │\n│ │ └──────────────┘ └──────────────┘ │ │\n│ └─────────────────────────────────────────┘ │\n└─────────────────────────────────────────────────┘\n```\n\n## Padrões comuns de multi-tenancy\n\n### Padrão 1: usuário único, mind único\n\nMais comum para usuários individuais de agentes LLM.\n\n- 1 conta de usuário\n- 1 mind\n- 1 Mind Key\n- Todas as memórias em um escopo\n\n### Padrão 2: usuário único, múltiplos minds\n\nPara usuários com múltiplos contextos (trabalho, pessoal, projetos).\n\n- 1 conta de usuário\n- N minds (ex.: \"work\", \"personal\", \"project-x\")\n- N Mind Keys\n- Cada sessão LLM usa uma Mind Key\n\n### Padrão 3: mind compartilhado em equipe\n\nPara equipes colaborando em um projeto.\n\n- 1 usuário cria o mind (recebe a Mind Key)\n- O criador compartilha com membros da equipe via JWT\n- Todos os membros acessam via JWT (ou Mind Key compartilhada)\n\n> [!WARNING]\n> Compartilhar uma Mind Key concede acesso total de leitura/escrita. Para\n> colaboração em equipe, prefira a API de Compartilhamento (baseada em JWT)\n> em vez de compartilhar Mind Keys diretamente.\n\n### Padrão 4: provedor SaaS\n\nPara apps que incorporam o Synapse como sua camada de memória.\n\n- Cada cliente = 1 conta de usuário\n- Cada projeto do cliente = 1 mind\n- O app armazena Mind Keys por cliente/projeto\n- Isolamento total entre clientes\n\n## Verificação de isolamento\n\n### Teste: Mind Key não pode acessar outros minds\n\n```bash\n# Mind A's key cannot read Mind B's memories\ncurl -H \"Authorization: Bearer mk_aaa...\" \\\n \"https://synapse.schaefer.zone/memory/search?q=test\"\n# Returns only Mind A's memories\n\ncurl -H \"Authorization: Bearer mk_bbb...\" \\\n \"https://synapse.schaefer.zone/memory/search?q=test\"\n# Returns only Mind B's memories (different results)\n```\n\n### Teste: JWT não pode ler dados de memória diretamente\n\n```bash\n# JWT can list minds\ncurl -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/minds\n# Returns: list of minds\n\n# JWT CANNOT read memories (need Mind Key)\ncurl -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/memory/recall\n# Returns: 401 Unauthorized\n```\n\n## Melhores práticas\n\n> [!TIP]\n> - **Use um mind por projeto/contexto** — isolamento é seu amigo\n> - **Nunca compartilhe Mind Keys** — use a API de Compartilhamento\n> - **Faça rotação de Mind Keys** se comprometidas (exclua o mind, crie um novo)\n> - **Audite minds compartilhados** — revise `GET /sharing` periodicamente\n> - **Use JWT para interface humana** — nunca exponha Mind Keys a usuários finais\n\n## Próximos passos\n\n- [Autenticação](/docs/getting-started/authentication)\n- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)\n- [Arquitetura](/docs/concepts/architecture)\n","content_html":"

Multi-tenancy e isolamento

\n

O Synapse é multi-tenant: múltiplos usuários, cada um com múltiplos minds,\ntotalmente isolados entre si. Esta página explica o modelo de isolamento.

\n

Hierarquia de tenants

\n
Synapse Instance\n  │\n  ├── User Account 1 (email: alice@example.com)\n  │   ├── Mind A (Mind Key mk_aaa...)\n  │   │   ├── Memories (only accessible via mk_aaa...)\n  │   │   ├── Tasks\n  │   │   └── Chat\n  │   └── Mind B (Mind Key mk_bbb...)\n  │       └── ... (isolated from Mind A)\n  │\n  ├── User Account 2 (email: bob@example.com)\n  │   └── Mind C (Mind Key mk_ccc...)\n  │       └── ... (isolated from Alice's minds)\n  │\n  └── ... (more users)

Níveis de isolamento

\n

Nível 1: isolamento de usuário

\n

Cada conta de usuário é isolada. Alice não pode:

\n\n

Aplicado por: coluna user_id em todas as tabelas, JWT contém user_id,\ntodas as consultas filtram por user_id.

\n

Nível 2: isolamento de mind

\n

Dentro de um usuário, cada mind é isolado. Mind A não pode:

\n\n

Aplicado por: coluna mind_id em todas as tabelas de dados, Mind Key contém\nmind_id, todas as consultas filtram por mind_id.

\n
O isolamento por Mind Key é a fronteira de segurança primária. Uma Mind Key\nvazada concede acesso total aos dados daquele mind — mas SOMENTE àquele mind.

Tokens de autenticação

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
TokenEscopoO que pode acessar
Mind KeyMind únicoApenas dados daquele mind
JWTConta de usuárioGerenciamento de conta (criar/listar/excluir minds)
Computer TokenComputador únicoComandos daquele computador
\n

Acesso cross-mind

\n

Dentro do mesmo usuário

\n

O usuário pode acessar todos os seus minds via JWT (ex.: GET /minds lista\ntodos). Mas para ler/escrever dados de memória, ele precisa da Mind Key\nespecífica.

\n

Entre usuários

\n

Usuários não podem acessar dados um do outro — A MENOS que compartilhem\nexplicitamente um mind via API de Compartilhamento:

\n
# Alice shares Mind A with Bob\ncurl -X POST https://synapse.schaefer.zone/sharing \\\n  -H "Authorization: Bearer ALICE_JWT" \\\n  -d '{"mind_id": "m_aaa", "email": "bob@example.com", "role": "read"}'

Após compartilhar, Bob pode acessar o Mind A via seu JWT (somente leitura se\nrole=read).

\n

Fronteiras de segurança

\n
┌─────────────────────────────────────────────────┐\n│              Synapse Instance                    │\n│  ┌─────────────────────────────────────────┐    │\n│  │         User Account Boundary           │    │\n│  │  ┌──────────────┐  ┌──────────────┐    │    │\n│  │  │  Mind Bound. │  │  Mind Bound. │    │    │\n│  │  │  (Mind Key)  │  │  (Mind Key)  │    │    │\n│  │  │              │  │              │    │    │\n│  │  │  Memories    │  │  Memories    │    │    │\n│  │  │  Tasks       │  │  Tasks       │    │    │\n│  │  │  Chat        │  │  Chat        │    │    │\n│  │  │  Scripts     │  │  Scripts     │    │    │\n│  │  └──────────────┘  └──────────────┘    │    │\n│  └─────────────────────────────────────────┘    │\n└─────────────────────────────────────────────────┘

Padrões comuns de multi-tenancy

\n

Padrão 1: usuário único, mind único

\n

Mais comum para usuários individuais de agentes LLM.

\n\n

Padrão 2: usuário único, múltiplos minds

\n

Para usuários com múltiplos contextos (trabalho, pessoal, projetos).

\n\n

Padrão 3: mind compartilhado em equipe

\n

Para equipes colaborando em um projeto.

\n\n
Compartilhar uma Mind Key concede acesso total de leitura/escrita. Para\ncolaboração em equipe, prefira a API de Compartilhamento (baseada em JWT)\nem vez de compartilhar Mind Keys diretamente.

Padrão 4: provedor SaaS

\n

Para apps que incorporam o Synapse como sua camada de memória.

\n\n

Verificação de isolamento

\n

Teste: Mind Key não pode acessar outros minds

\n
# Mind A's key cannot read Mind B's memories\ncurl -H "Authorization: Bearer mk_aaa..." \\\n     "https://synapse.schaefer.zone/memory/search?q=test"\n# Returns only Mind A's memories\n\ncurl -H "Authorization: Bearer mk_bbb..." \\\n     "https://synapse.schaefer.zone/memory/search?q=test"\n# Returns only Mind B's memories (different results)

Teste: JWT não pode ler dados de memória diretamente

\n
# JWT can list minds\ncurl -H "Authorization: Bearer YOUR_JWT" \\\n     https://synapse.schaefer.zone/minds\n# Returns: list of minds\n\n# JWT CANNOT read memories (need Mind Key)\ncurl -H "Authorization: Bearer YOUR_JWT" \\\n     https://synapse.schaefer.zone/memory/recall\n# Returns: 401 Unauthorized

Melhores práticas

\n

Próximos passos

\n\n","urls":{"html":"/docs/concepts/multi-tenancy","text":"/docs/concepts/multi-tenancy?format=text","json":"/docs/concepts/multi-tenancy?format=json","llm":"/docs/concepts/multi-tenancy?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}