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.
| 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, 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 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 : créer et gérer réseaux, clients et entités juridiques.
- Applications : ce que porte l'application, au sommet de l'arbre.
- Niveaux d'administration : qui administre quel niveau.
- Référence API : organisations : les endpoints de l'API publique.