Skip to content

Organisation multi-tenant

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

ConceptAdministratorPartnerDeveloper

This page has not been translated yet and is shown in French.

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.

Loading diagram…
NiveauCe que c'estCe qu'il porteDans Keycloak
Propriétairel'éditeur ou le partenaire qui possède des applicationsses applications, ses entités juridiques, ses contacts—
Applicationla wakappses droits, ses profils modèles, ses fonctionnalités, ses langues, ses thèmes, son hébergementun client OIDC, dont l'identifiant est le WID de l'application
Réseauun canal de distribution de l'applicationses clients, les profils de l'application qu'il masque, sa langue et son thème par défaut, ses e-mails, son sous-domaineun realm, créé sur les trois instances (dev, staging, prod)
Clientune organisation clienteses utilisateurs, ses équipes, ses fournisseurs d'identité, ses créditsune organisation et un groupe dans le realm du réseau
Utilisateurune personne, dans un environnement : une fiche par environnementson niveau d'administration, son profil, ses équipesun 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églageOrdre de priorité
Thème et languepréférence de l'utilisateur, puis client, puis réseau, puis application
Logos, fonds, faviconclient, puis réseau, puis application
Profils visibles par un clientprofils de l'application, sauf ceux que son réseau masque
Fonctionnalité activableactive 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 ?

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

Pour aller plus loin