{"title":"Multi-tenancy e isolamento","slug":"multi-tenancy","category":"concepts","summary":"Come Synapse isola i dati tra utenti e menti — confini di sicurezza spiegati.","audience":["human","llm"],"tags":["concept","multi-tenancy","security","isolation"],"difficulty":"intermediate","updated":"2026-06-27","word_count":602,"read_minutes":3,"lang":"it","translated":true,"requested_lang":"it","content_markdown":"\n# Multi-tenancy e isolamento\n\nSynapse è multi-tenant: utenti multipli, ciascuno con menti multiple, completamente\nisolati tra loro. Questa pagina spiega il modello di isolamento.\n\n## Gerarchia dei tenant\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## Livelli di isolamento\n\n### Livello 1: isolamento utente\n\nOgni account utente è isolato. Alice non può:\n\n- Vedere le menti di Bob\n- Accedere alle memorie di Bob (nemmeno con il suo JWT)\n- Elencare le informazioni dell'account di Bob\n\nImposto da: colonna `user_id` su tutte le tabelle, il JWT contiene `user_id`,\ntutte le query filtrano per `user_id`.\n\n### Livello 2: isolamento mente\n\nAll'interno di un utente, ogni mente è isolata. La Mente A non può:\n\n- Vedere le memorie della Mente B\n- Accedere alle attività, chat, script della Mente B\n\nImposto da: colonna `mind_id` su tutte le tabelle dati, la Mind Key contiene\n`mind_id`, tutte le query filtrano per `mind_id`.\n\n> [!CRITICAL]\n> L'isolamento tramite Mind Key è il confine di sicurezza primario. Una Mind Key\n> leakata concede pieno accesso ai dati di quella mente — ma SOLO a quella mente.\n\n## Token di autenticazione\n\n| Token | Ambito | Cosa può accedere |\n|-------|-------|-------------------|\n| Mind Key | Singola mente | Solo i dati di quella mente |\n| JWT | Account utente | Gestione account (crea/elenca/elimina menti) |\n| Computer Token | Singolo computer | I comandi di quel computer |\n\n## Accesso tra menti\n\n### All'interno dello stesso utente\n\nL'utente può accedere a tutte le sue menti tramite JWT (es. `GET /minds` le\nelenca tutte). Ma per leggere/scrivere dati di memoria, ha bisogno della Mind\nKey specifica.\n\n### Tra utenti\n\nGli utenti non possono accedere ai dati l'uno dell'altro — A MENO CHE non\ncondividano esplicitamente una mente tramite la Sharing API:\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\nDopo la condivisione, Bob può accedere alla Mente A tramite il suo JWT (sola\nlettura se `role=read`).\n\n## Confini di sicurezza\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## Modelli multi-tenant comuni\n\n### Modello 1: utente singolo, mente singola\n\nPiù comune per utenti singoli di agenti LLM.\n\n- 1 account utente\n- 1 mente\n- 1 Mind Key\n- Tutte le memorie in un unico scope\n\n### Modello 2: utente singolo, menti multiple\n\nPer utenti con contesti multipli (lavoro, personale, progetti).\n\n- 1 account utente\n- N menti (es. \"work\", \"personal\", \"project-x\")\n- N Mind Key\n- Ogni sessione LLM usa una Mind Key\n\n### Modello 3: mente condivisa di team\n\nPer team che collaborano a un progetto.\n\n- 1 utente crea la mente (ottiene la Mind Key)\n- Il creatore condivide con i membri del team tramite JWT\n- Tutti i membri del team accedono tramite JWT (o Mind Key condivisa)\n\n> [!WARNING]\n> Condividere una Mind Key dà pieno accesso in lettura/scrittura. Per\n> collaborazione di team, preferisca la Sharing API (basata su JWT) rispetto\n> alla condivisione diretta di Mind Key.\n\n### Modello 4: provider SaaS\n\nPer app che integrano Synapse come loro layer di memoria.\n\n- Ogni cliente = 1 account utente\n- Ogni progetto cliente = 1 mente\n- L'app salva le Mind Key per cliente/progetto\n- Pieno isolamento tra clienti\n\n## Verifica dell'isolamento\n\n### Test: una Mind Key non può accedere ad altre menti\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### Test: il JWT non può leggere i dati di memoria direttamente\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## Best practice\n\n> [!TIP]\n> - **Usi una mente per progetto/contesto** — l'isolamento è suo amico\n> - **Non condivida mai le Mind Key** — usi la Sharing API invece\n> - **Roti le Mind Key** se compromesse (elimini la mente, ne crei una nuova)\n> - **Verifichi le menti condivise** — revisioni `GET /sharing` periodicamente\n> - **Usi JWT per UI umana** — non esponga mai le Mind Key agli utenti finali\n\n## Prossimi passi\n\n- [Autenticazione](/docs/getting-started/authentication)\n- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)\n- [Architettura](/docs/concepts/architecture)\n","content_html":"

Multi-tenancy e isolamento

\n

Synapse è multi-tenant: utenti multipli, ciascuno con menti multiple, completamente\nisolati tra loro. Questa pagina spiega il modello di isolamento.

\n

Gerarchia dei tenant

\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)

Livelli di isolamento

\n

Livello 1: isolamento utente

\n

Ogni account utente è isolato. Alice non può:

\n\n

Imposto da: colonna user_id su tutte le tabelle, il JWT contiene user_id,\ntutte le query filtrano per user_id.

\n

Livello 2: isolamento mente

\n

All'interno di un utente, ogni mente è isolata. La Mente A non può:

\n\n

Imposto da: colonna mind_id su tutte le tabelle dati, la Mind Key contiene\nmind_id, tutte le query filtrano per mind_id.

\n
L'isolamento tramite Mind Key è il confine di sicurezza primario. Una Mind Key\nleakata concede pieno accesso ai dati di quella mente — ma SOLO a quella mente.

Token di autenticazione

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
TokenAmbitoCosa può accedere
Mind KeySingola menteSolo i dati di quella mente
JWTAccount utenteGestione account (crea/elenca/elimina menti)
Computer TokenSingolo computerI comandi di quel computer
\n

Accesso tra menti

\n

All'interno dello stesso utente

\n

L'utente può accedere a tutte le sue menti tramite JWT (es. GET /minds le\nelenca tutte). Ma per leggere/scrivere dati di memoria, ha bisogno della Mind\nKey specifica.

\n

Tra utenti

\n

Gli utenti non possono accedere ai dati l'uno dell'altro — A MENO CHE non\ncondividano esplicitamente una mente tramite la Sharing API:

\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"}'

Dopo la condivisione, Bob può accedere alla Mente A tramite il suo JWT (sola\nlettura se role=read).

\n

Confini di sicurezza

\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└─────────────────────────────────────────────────┘

Modelli multi-tenant comuni

\n

Modello 1: utente singolo, mente singola

\n

Più comune per utenti singoli di agenti LLM.

\n\n

Modello 2: utente singolo, menti multiple

\n

Per utenti con contesti multipli (lavoro, personale, progetti).

\n\n

Modello 3: mente condivisa di team

\n

Per team che collaborano a un progetto.

\n\n
Condividere una Mind Key dà pieno accesso in lettura/scrittura. Per\ncollaborazione di team, preferisca la Sharing API (basata su JWT) rispetto\nalla condivisione diretta di Mind Key.

Modello 4: provider SaaS

\n

Per app che integrano Synapse come loro layer di memoria.

\n\n

Verifica dell'isolamento

\n

Test: una Mind Key non può accedere ad altre menti

\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)

Test: il JWT non può leggere i dati di memoria direttamente

\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

Best practice

\n

Prossimi passi

\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"]}