{"title":"Multi-tenancy & isolation","slug":"multi-tenancy","category":"concepts","summary":"Comment Synapse isole les données entre utilisateurs et minds — frontières de sécurité expliquées.","audience":["human","llm"],"tags":["concept","multi-tenancy","security","isolation"],"difficulty":"intermediate","updated":"2026-06-27","word_count":634,"read_minutes":3,"lang":"fr","translated":true,"requested_lang":"fr","content_markdown":"\n# Multi-tenancy & isolation\n\nSynapse est multi-tenant : plusieurs utilisateurs, chacun avec plusieurs minds,\nentièrement isolés les uns des autres. Cette page explique le modèle d'isolation.\n\n## Hiérarchie des tenants\n\n```\nInstance Synapse\n │\n ├── Compte utilisateur 1 (email : alice@example.com)\n │ ├── Mind A (Mind Key mk_aaa...)\n │ │ ├── Memories (accessibles uniquement via mk_aaa...)\n │ │ ├── Tasks\n │ │ └── Chat\n │ └── Mind B (Mind Key mk_bbb...)\n │ └── ... (isolé du Mind A)\n │\n ├── Compte utilisateur 2 (email : bob@example.com)\n │ └── Mind C (Mind Key mk_ccc...)\n │ └── ... (isolé des minds d'Alice)\n │\n └── ... (plus d'utilisateurs)\n```\n\n## Niveaux d'isolation\n\n### Niveau 1 : isolation utilisateur\n\nChaque compte utilisateur est isolé. Alice ne peut pas :\n\n- Voir les minds de Bob\n- Accéder aux mémoires de Bob (même avec son JWT)\n- Lister les infos de compte de Bob\n\nAppliqué par : colonne `user_id` sur toutes les tables, le JWT contient `user_id`,\ntoutes les requêtes filtrent par `user_id`.\n\n### Niveau 2 : isolation de mind\n\nAu sein d'un utilisateur, chaque mind est isolé. Le Mind A ne peut pas :\n\n- Voir les mémoires du Mind B\n- Accéder aux tâches, chat, scripts du Mind B\n\nAppliqué par : colonne `mind_id` sur toutes les tables de données, la Mind Key\ncontient `mind_id`, toutes les requêtes filtrent par `mind_id`.\n\n> [!CRITICAL]\n> L'isolation par Mind Key est la frontière de sécurité principale. Une Mind Key\n> fuite accordant un accès complet aux données de ce mind — mais UNIQUEMENT ce mind.\n\n## Jetons d'authentification\n\n| Jeton | Portée | Ce à quoi il peut accéder |\n|-------|-------|-------------------|\n| Mind Key | Un seul mind | Données de ce mind uniquement |\n| JWT | Compte utilisateur | Gestion de compte (créer/lister/supprimer des minds) |\n| Computer Token | Un seul ordinateur | Commandes de cet ordinateur |\n\n## Accès inter-minds\n\n### Au sein du même utilisateur\n\nL'utilisateur peut accéder à tous ses minds via JWT (ex. `GET /minds` les liste tous).\nMais pour lire/écrire des données mémoire, il a besoin de la Mind Key spécifique.\n\n### Entre utilisateurs\n\nLes utilisateurs ne peuvent pas accéder aux données des autres — SAUF s'ils partagent\nexplicitement un mind via l'API Sharing :\n\n```bash\n# Alice partage le Mind A avec 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\nAprès le partage, Bob peut accéder au Mind A via son JWT (en lecture seule si\n`role=read`).\n\n## Frontières de sécurité\n\n```\n┌─────────────────────────────────────────────────┐\n│ Instance Synapse │\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## Schémas multi-tenant courants\n\n### Schéma 1 : utilisateur unique, mind unique\n\nLe plus courant pour les utilisateurs individuels d'agents LLM.\n\n- 1 compte utilisateur\n- 1 mind\n- 1 Mind Key\n- Toutes les mémoires dans un seul scope\n\n### Schéma 2 : utilisateur unique, plusieurs minds\n\nPour les utilisateurs avec plusieurs contextes (travail, personnel, projets).\n\n- 1 compte utilisateur\n- N minds (ex. « work », « personal », « project-x »)\n- N Mind Keys\n- Chaque session LLM utilise une Mind Key\n\n### Schéma 3 : mind partagé en équipe\n\nPour les équipes collaborant sur un projet.\n\n- 1 utilisateur crée le mind (obtient la Mind Key)\n- Le créateur partage avec les membres de l'équipe via JWT\n- Tous les membres y accèdent via JWT (ou Mind Key partagée)\n\n> [!WARNING]\n> Partager une Mind Key donne un accès complet en lecture/écriture. Pour la\n> collaboration en équipe, préférez l'API Sharing (basée JWT) au partage direct de\n> Mind Keys.\n\n### Schéma 4 : fournisseur SaaS\n\nPour les applications qui intègrent Synapse comme couche mémoire.\n\n- Chaque client = 1 compte utilisateur\n- Chaque projet client = 1 mind\n- L'application stocke les Mind Keys par client/projet\n- Isolation complète entre clients\n\n## Vérification de l'isolation\n\n### Test : une Mind Key ne peut pas accéder à d'autres minds\n\n```bash\n# La clé du Mind A ne peut pas lire les mémoires du Mind B\ncurl -H \"Authorization: Bearer mk_aaa...\" \\\n \"https://synapse.schaefer.zone/memory/search?q=test\"\n# Renvoie uniquement les mémoires du Mind A\n\ncurl -H \"Authorization: Bearer mk_bbb...\" \\\n \"https://synapse.schaefer.zone/memory/search?q=test\"\n# Renvoie uniquement les mémoires du Mind B (résultats différents)\n```\n\n### Test : un JWT ne peut pas lire directement les données de mémoire\n\n```bash\n# Le JWT peut lister les minds\ncurl -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/minds\n# Renvoie : liste des minds\n\n# Le JWT NE PEUT PAS lire les mémoires (besoin d'une Mind Key)\ncurl -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/memory/recall\n# Renvoie : 401 Unauthorized\n```\n\n## Bonnes pratiques\n\n> [!TIP]\n> - **Utilisez un mind par projet/contexte** — l'isolation est votre amie\n> - **Ne partagez jamais de Mind Keys** — utilisez l'API Sharing à la place\n> - **Pivotez les Mind Keys** si compromises (supprimer le mind, en créer un nouveau)\n> - **Auditez les minds partagés** — passez en revue `GET /sharing` périodiquement\n> - **Utilisez le JWT pour l'interface humaine** — n'exposez jamais les Mind Keys aux utilisateurs finaux\n\n## Prochaines étapes\n\n- [Authentification](/docs/getting-started/authentication)\n- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)\n- [Architecture](/docs/concepts/architecture)\n","content_html":"

Multi-tenancy & isolation

\n

Synapse est multi-tenant : plusieurs utilisateurs, chacun avec plusieurs minds,\nentièrement isolés les uns des autres. Cette page explique le modèle d'isolation.

\n

Hiérarchie des tenants

\n
Instance Synapse\n  │\n  ├── Compte utilisateur 1 (email : alice@example.com)\n  │   ├── Mind A (Mind Key mk_aaa...)\n  │   │   ├── Memories (accessibles uniquement via mk_aaa...)\n  │   │   ├── Tasks\n  │   │   └── Chat\n  │   └── Mind B (Mind Key mk_bbb...)\n  │       └── ... (isolé du Mind A)\n  │\n  ├── Compte utilisateur 2 (email : bob@example.com)\n  │   └── Mind C (Mind Key mk_ccc...)\n  │       └── ... (isolé des minds d'Alice)\n  │\n  └── ... (plus d'utilisateurs)

Niveaux d'isolation

\n

Niveau 1 : isolation utilisateur

\n

Chaque compte utilisateur est isolé. Alice ne peut pas :

\n\n

Appliqué par : colonne user_id sur toutes les tables, le JWT contient user_id,\ntoutes les requêtes filtrent par user_id.

\n

Niveau 2 : isolation de mind

\n

Au sein d'un utilisateur, chaque mind est isolé. Le Mind A ne peut pas :

\n\n

Appliqué par : colonne mind_id sur toutes les tables de données, la Mind Key\ncontient mind_id, toutes les requêtes filtrent par mind_id.

\n
L'isolation par Mind Key est la frontière de sécurité principale. Une Mind Key\nfuite accordant un accès complet aux données de ce mind — mais UNIQUEMENT ce mind.

Jetons d'authentification

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
JetonPortéeCe à quoi il peut accéder
Mind KeyUn seul mindDonnées de ce mind uniquement
JWTCompte utilisateurGestion de compte (créer/lister/supprimer des minds)
Computer TokenUn seul ordinateurCommandes de cet ordinateur
\n

Accès inter-minds

\n

Au sein du même utilisateur

\n

L'utilisateur peut accéder à tous ses minds via JWT (ex. GET /minds les liste tous).\nMais pour lire/écrire des données mémoire, il a besoin de la Mind Key spécifique.

\n

Entre utilisateurs

\n

Les utilisateurs ne peuvent pas accéder aux données des autres — SAUF s'ils partagent\nexplicitement un mind via l'API Sharing :

\n
# Alice partage le Mind A avec 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"}'

Après le partage, Bob peut accéder au Mind A via son JWT (en lecture seule si\nrole=read).

\n

Frontières de sécurité

\n
┌─────────────────────────────────────────────────┐\n│              Instance Synapse                    │\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└─────────────────────────────────────────────────┘

Schémas multi-tenant courants

\n

Schéma 1 : utilisateur unique, mind unique

\n

Le plus courant pour les utilisateurs individuels d'agents LLM.

\n\n

Schéma 2 : utilisateur unique, plusieurs minds

\n

Pour les utilisateurs avec plusieurs contextes (travail, personnel, projets).

\n\n

Schéma 3 : mind partagé en équipe

\n

Pour les équipes collaborant sur un projet.

\n\n
Partager une Mind Key donne un accès complet en lecture/écriture. Pour la\ncollaboration en équipe, préférez l'API Sharing (basée JWT) au partage direct de\nMind Keys.

Schéma 4 : fournisseur SaaS

\n

Pour les applications qui intègrent Synapse comme couche mémoire.

\n\n

Vérification de l'isolation

\n

Test : une Mind Key ne peut pas accéder à d'autres minds

\n
# La clé du Mind A ne peut pas lire les mémoires du Mind B\ncurl -H "Authorization: Bearer mk_aaa..." \\\n     "https://synapse.schaefer.zone/memory/search?q=test"\n# Renvoie uniquement les mémoires du Mind A\n\ncurl -H "Authorization: Bearer mk_bbb..." \\\n     "https://synapse.schaefer.zone/memory/search?q=test"\n# Renvoie uniquement les mémoires du Mind B (résultats différents)

Test : un JWT ne peut pas lire directement les données de mémoire

\n
# Le JWT peut lister les minds\ncurl -H "Authorization: Bearer YOUR_JWT" \\\n     https://synapse.schaefer.zone/minds\n# Renvoie : liste des minds\n\n# Le JWT NE PEUT PAS lire les mémoires (besoin d'une Mind Key)\ncurl -H "Authorization: Bearer YOUR_JWT" \\\n     https://synapse.schaefer.zone/memory/recall\n# Renvoie : 401 Unauthorized

Bonnes pratiques

\n

Prochaines étapes

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