# Organisation multi-tenant

> Propriétaire, application, réseau, client, utilisateur : comment Wakastart range les utilisateurs de vos applications et ce que chaque niveau isole.

Wakastart range les utilisateurs de vos applications dans un arbre à cinq niveaux. Chaque niveau a un rôle précis : posséder, distribuer, regrouper ou identifier. C'est ce qui permet à une même application de servir des dizaines d'organisations clientes sans qu'aucune ne voie les autres.

## Définition

L'organisation multi-tenant est la hiérarchie **Propriétaire → Application → Réseau → Client → Utilisateur**.

```mermaid
flowchart TD
  P["Propriétaire<br/>Éditeur Exemple"] --> A["Application<br/>Dossier Patient"]
  A --> N1["Réseau « Cliniques »<br/>realm Keycloak dédié"]
  A --> N2["Réseau « Hôpitaux publics »<br/>realm Keycloak dédié"]
  N1 --> C1["Client<br/>Clinique du Parc"]
  N1 --> C2["Client<br/>Clinique Saint-Louis"]
  N2 --> C3["Client<br/>CHU Exemple"]
  C1 --> U1["Utilisateurs, équipes"]
  C2 --> U2["Utilisateurs, équipes"]
  C3 --> U3["Utilisateurs, équipes, SSO"]
```

| Niveau | Ce que c'est | Ce qu'il porte | Dans Keycloak |
|---|---|---|---|
| **Propriétaire** | l'éditeur ou le partenaire qui possède des applications | ses applications, ses entités juridiques, ses contacts | — |
| **Application** | la wakapp | ses droits, ses profils modèles, ses fonctionnalités, ses langues, ses thèmes, son hébergement | un client OIDC, dont l'identifiant est le WID de l'application |
| **Réseau** | un canal de distribution de l'application | ses clients, les profils de l'application qu'il masque, sa langue et son thème par défaut, ses e-mails, son sous-domaine | un **realm**, créé sur les trois instances (dev, staging, prod) |
| **Client** | une organisation cliente | ses utilisateurs, ses équipes, ses fournisseurs d'identité, ses crédits | une **organisation** et un groupe dans le realm du réseau |
| **Utilisateur** | une personne, dans un environnement : une fiche par environnement | son niveau d'administration, son profil, ses équipes | un compte sur l'instance de son environnement |

Chaque objet porte un [WID](/v1.0/glossaire#wid), un identifiant court de six caractères (lettres et chiffres) : `EXAPP1` pour une application, `EXCLI1` pour un client. Les API et la console l'utilisent partout.

**Ce qu'un réseau n'est pas** : un client. Le réseau isole des espaces d'identité ; le client regroupe des personnes à l'intérieur d'un espace. Deux clients d'un même réseau partagent le même realm et la même page de connexion ; deux réseaux, jamais.

## Pourquoi ça existe

Un éditeur qui vend la même application à plusieurs organisations doit garantir trois choses : que chaque organisation ne voie que ses données, que chacune puisse avoir ses couleurs et ses règles, et qu'il puisse confier une partie de ses clients à un distributeur. Les trois niveaux intermédiaires répondent chacun à l'un de ces besoins :

- l'**application** porte ce qui est commun à tous : le catalogue des droits, les profils, le code ;
- le **réseau** porte ce qui est propre à un canal de distribution : son espace d'identité, ses comptes, son habillage ;
- le **client** porte ce qui est propre à une organisation : ses utilisateurs, ses équipes, son annuaire d'entreprise.

## Comment ça marche

### L'isolation suit le realm

Un utilisateur appartient à un client, donc à un réseau, donc à un realm. Sa connexion, son mot de passe et ses sessions vivent dans ce realm. Une même adresse e-mail peut exister dans deux réseaux : ce sont alors deux comptes distincts. Dans un même réseau, une adresse peut appartenir à plusieurs clients ; la page de connexion propose alors de choisir l'organisation.

### Les réglages descendent en cascade

| Réglage | Ordre de priorité |
|---|---|
| Thème et langue | préférence de l'utilisateur, puis client, puis réseau, puis application |
| Logos, fonds, favicon | client, puis réseau, puis application |
| Profils visibles par un client | profils de l'application, sauf ceux que son réseau masque |
| Fonctionnalité activable | active seulement si elle l'est **à la fois** pour l'application, pour le réseau et pour le client |

### Les administrateurs suivent l'arbre

Chaque niveau a son administrateur : Propriétaire, Administrateur d'applications, Administrateur réseau, Administrateur client. La page [Niveaux d'administration](/v1.0/concepts/niveaux-d-administration) décrit leur périmètre.

## Exemples

**Une agence qui héberge 10 clients.** L'agence est propriétaire d'une application de prise de rendez-vous. Elle crée un seul réseau et dix clients. Les dix organisations partagent la même page de connexion ; chacune a ses utilisateurs, ses équipes et son logo, posé au niveau du client.

**Un éditeur santé et son distributeur.** L'éditeur distribue son logiciel en direct et via un intégrateur régional. Il crée deux réseaux : « Direct » et « Intégrateur Sud ». Chaque réseau a son realm, ses couleurs et ses e-mails ; un administrateur réseau, chez l'intégrateur, gère ses propres clients sans voir ceux de l'éditeur.

**Un grand compte avec son annuaire.** Un CHU, client d'un réseau, branche son annuaire d'entreprise en SSO. Le fournisseur d'identité est déclaré **au niveau du client** : seuls les agents du CHU passent par lui, les autres clients du réseau gardent l'identifiant et le mot de passe.

## Réseau ou client ?

| Besoin | Créez |
|---|---|
| Une page de connexion et un espace d'identité séparés | un réseau |
| Un distributeur qui gère ses propres clients | un réseau, avec son administrateur réseau |
| Une nouvelle organisation qui utilise l'application | un client |
| Un annuaire d'entreprise propre à une organisation | un client, avec son fournisseur d'identité |
| Un logo ou une langue par défaut pour une organisation | un réglage du client |

## Pour aller plus loin

- [Organisations](/v1.0/organisations) : créer et gérer réseaux, clients et entités juridiques.
- [Applications](/v1.0/concepts/applications) : ce que porte l'application, au sommet de l'arbre.
- [Niveaux d'administration](/v1.0/concepts/niveaux-d-administration) : qui administre quel niveau.
- [Référence API : organisations](/v1.0/reference-api/organisations) : les endpoints de l'API publique.
