Concepts
Le modèle de Wakastart en un schéma : qui possède quoi, qui accède à quoi, et comment une application devient des ressources qui tournent.
Toute la plateforme tient dans deux arbres qui partent du même objet : l'application. Le premier dit qui utilise l'application : le partenaire qui la possède, les réseaux qui la distribuent, les clients et leurs utilisateurs. Le second dit où elle tourne : ses environnements et les ressources de chacun.
Le schéma central
Lecture du schéma :
- Un propriétaire, plusieurs applications. Le propriétaire est l'éditeur ou le partenaire. Chaque application lui appartient.
- Une application, plusieurs réseaux. Un réseau est un canal de distribution, avec son propre espace d'identité. Il regroupe des clients, et chaque client ses utilisateurs.
- Une application, plusieurs environnements. L'application décrit une seule fois son architecture : services, bases, buckets, URLs. Chaque environnement en reçoit ses propres instances.
- Les deux arbres se croisent dans Keycloak. Le realm d'un réseau existe sur l'instance Keycloak de chaque type d'environnement ; un utilisateur a donc un compte par environnement.
Les concepts, un par page
Le modèle de la plateforme
Propriétaire, application, réseau, client, utilisateur : qui contient qui, et ce que chaque niveau isole.
ApplicationsLa wakapp, ses deux faces : identité et hébergement.
EnvironnementsDev, staging, prod, et les trois instances Keycloak qui leur correspondent.
Définitions et instancesDéclarer une fois, provisionner partout : héritage des valeurs et surcharges.
Cycle de vie des ressourcesStatuts, réconciliation, délais : ce qui est asynchrone et combien de temps ça prend.
Identité et accès
Partenaire, applications, réseau, client : le périmètre de chaque administrateur.
Droits, profils et équipesCe qu'un utilisateur a le droit de faire, environnement par environnement.
DiscoveryComment votre application trouve son realm sans le connaître.
Jeton enrichi et /meJeton Keycloak, jeton enrichi, /api/me : qui porte quoi.
Les portes d'entrée
Parcours de lecture conseillés
| Vous êtes | Lisez dans cet ordre |
|---|---|
| Administrateur d'une organisation cliente | Organisation multi-tenant → Niveaux d'administration → Droits, profils et équipes → Console et API |
| Développeur qui intègre la connexion | Environnements → Discovery → Jeton enrichi et /me → Droits, profils et équipes |
| Développeur qui héberge son application | Applications → Environnements → Définitions et instances → Cycle de vie des ressources |
| Partenaire qui distribue une application | Organisation multi-tenant → Applications → Niveaux d'administration → Environnements |
Le vocabulaire en une ligne
| Terme | En une phrase |
|---|---|
| Propriétaire | l'éditeur ou le partenaire qui possède des applications ; « OwnerAdmin » dans la console |
| Application | la wakapp, identifiée par un identifiant court qui sert aussi de client Keycloak |
| Réseau | un canal de distribution de l'application, avec son realm Keycloak |
| Client | une organisation cliente dans un réseau, avec ses utilisateurs et ses équipes |
| Environnement | un lieu d'exécution de l'application : développement, staging ou production |
| Définition | ce que l'architecture déclare une fois pour toute l'application |
| Instance | la ressource réelle d'une définition dans un environnement |
| WID | l'identifiant court de six caractères de chaque objet, par exemple EXAPP1 |
Toutes les définitions détaillées sont dans le glossaire.