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.
This page has not been translated yet and is shown in French.
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.