Multitenant — Quick Reference
Servir plusieurs clients (tenants) sur la même base de code avec isolation stricte et un coût d'infra contrôlé.
Trois tiers d'isolation
| Tier |
Isolation |
Coût |
Cas d'usage |
| Tier 1 — Shared schema |
colonne tenant_id partout, filtres SQL automatiques |
Faible |
Startups, free / petits clients |
| Tier 2 — Dedicated schema |
un schéma PostgreSQL par tenant |
Moyen |
SMB, clients exigeants |
| Tier 3 — Dedicated DB |
une base entière par tenant |
Élevé |
Enterprise, compliance stricte (HDS, FedRAMP) |
Règle de migration : commencer Tier 1, migrer un client en Tier 2/3 quand il représente > 20 % du revenu OU exige un SLA spécifique.
Cinq invariants non-négociables
tenant_id propagé à chaque requête (AsyncLocalStorage / SecurityContext / middleware).
- PostgreSQL Row-Level Security (RLS) activé sur TOUTES les tables. Filet de sécurité contre un oubli applicatif.
- Tests d'isolation obligatoires. Tenant A ne doit jamais lire/écrire les données de B — y compris via tri, requête nuée, agrégat.
- Audit trail isolé par tenant. Pas de log multi-tenant cross-référencé sans permission explicite.
- Field-level encryption sur PII / secrets sensibles (Halite PHP, Eloquent Casts, libsodium).
Pattern minimal — Shared schema + RLS
ALTER TABLE invoices ADD COLUMN tenant_id UUID NOT NULL;
ALTER TABLE invoices ENABLE ROW LEVEL SECURITY;
CREATE POLICY tenant_isolation ON invoices
USING (tenant_id = current_setting('app.tenant_id')::uuid);
// Symfony — middleware qui set la variable session pour RLS
$conn->executeStatement(
'SET LOCAL app.tenant_id = :tid',
['tid' => $tenantId]
);
Anti-patterns critiques
- ❌ Oublier le filtre
tenant_id dans une requête raw → fuite cross-tenant.
- ❌ Cache Redis sans préfixe tenant → données de A retournées à B.
- ❌ Job worker async qui perd le
tenant_id → impossible de retrouver le contexte.
- ❌ Signed URLs / tokens sans
tenant_id dans le payload → utilisable cross-tenant.
- ❌ Field encryption avec une clé unique partagée → compromission = exposition totale (préférer keys per tenant).
RBAC / ABAC
- RBAC : rôles globaux (
admin, member, viewer) suffisent pour 80 % des cas.
- ABAC : passer à des policies (Casbin, Cerbos, OPA) quand les règles dépendent d'attributs (région, montant, statut).
Pour aller plus loin
Patterns détaillés par tier, migration tier 1 → tier 2 sans downtime, tests d'isolation (Pest + tenant fixtures), RBAC/ABAC, exemples Laravel + Symfony, checklists par phase : voir @.claude/skills/multitenant/REFERENCE.md.
1---2name: multitenant-33description: Multitenant — Quick Reference4---56# Multitenant — Quick Reference78Servir plusieurs clients (tenants) sur la même base de code avec **isolation stricte** et un coût d'infra contrôlé.910## Trois tiers d'isolation1112| Tier | Isolation | Coût | Cas d'usage |13|------|-----------|------|-------------|14| **Tier 1 — Shared schema** | colonne `tenant_id` partout, filtres SQL automatiques | Faible | Startups, free / petits clients |15| **Tier 2 — Dedicated schema** | un schéma PostgreSQL par tenant | Moyen | SMB, clients exigeants |16| **Tier 3 — Dedicated DB** | une base entière par tenant | Élevé | Enterprise, compliance stricte (HDS, FedRAMP) |1718**Règle de migration** : commencer Tier 1, migrer un client en Tier 2/3 quand il représente > 20 % du revenu OU exige un SLA spécifique.1920## Cinq invariants non-négociables21221. **`tenant_id` propagé à chaque requête** (AsyncLocalStorage / SecurityContext / middleware).232. **PostgreSQL Row-Level Security (RLS) activé sur TOUTES les tables.** Filet de sécurité contre un oubli applicatif.243. **Tests d'isolation obligatoires.** Tenant A ne doit jamais lire/écrire les données de B — y compris via tri, requête nuée, agrégat.254. **Audit trail isolé par tenant.** Pas de log multi-tenant cross-référencé sans permission explicite.265. **Field-level encryption** sur PII / secrets sensibles (Halite PHP, Eloquent Casts, libsodium).2728## Pattern minimal — Shared schema + RLS2930```sql31ALTER TABLE invoices ADD COLUMN tenant_id UUID NOT NULL;32ALTER TABLE invoices ENABLE ROW LEVEL SECURITY;33CREATE POLICY tenant_isolation ON invoices34 USING (tenant_id = current_setting('app.tenant_id')::uuid);35```3637```php38// Symfony — middleware qui set la variable session pour RLS39$conn->executeStatement(40 'SET LOCAL app.tenant_id = :tid',41 ['tid' => $tenantId]42);43```4445## Anti-patterns critiques4647- ❌ Oublier le filtre `tenant_id` dans une requête raw → fuite cross-tenant.48- ❌ Cache Redis sans préfixe tenant → données de A retournées à B.49- ❌ Job worker async qui perd le `tenant_id` → impossible de retrouver le contexte.50- ❌ Signed URLs / tokens sans `tenant_id` dans le payload → utilisable cross-tenant.51- ❌ Field encryption avec une clé unique partagée → compromission = exposition totale (préférer keys per tenant).5253## RBAC / ABAC5455- **RBAC** : rôles globaux (`admin`, `member`, `viewer`) suffisent pour 80 % des cas.56- **ABAC** : passer à des policies (Casbin, Cerbos, OPA) quand les règles dépendent d'attributs (région, montant, statut).5758## Pour aller plus loin5960> Patterns détaillés par tier, migration tier 1 → tier 2 sans downtime, tests d'isolation (Pest + tenant fixtures), RBAC/ABAC, exemples Laravel + Symfony, checklists par phase : voir `@.claude/skills/multitenant/REFERENCE.md`.