Applications
La wakapp au centre de la plateforme, avec sa face identité, réglée dans Paramétrage, et sa face hébergement, décrite dans Architecture.
This page has not been translated yet and is shown in French.
Une application, ou wakapp, est le logiciel que vous publiez sur Wakastart. C'est l'objet central de la plateforme : les organisations qui l'utilisent sont rangées sous elle, et les ressources qui la font tourner lui appartiennent.
Définition
Une application appartient à un seul propriétaire. Elle a deux faces, réglées à deux endroits de la console :
| Attribut | Rôle |
|---|---|
| WID | identifiant court de six caractères ; c'est aussi l'identifiant du client Keycloak de l'application, que l'on retrouve dans la keycloakUrl et dans le jeton (azp) |
| Nom court | identifiant lisible, en minuscules, fixé à la création ; il apparaît dans les noms des ressources et dans les URLs sur domaine plateforme |
| Type | APP, MOD ou SRV, affiché en badge dans l'en-tête de l'application |
| URL du front | l'adresse du front de l'application ; Discovery s'en sert pour la connexion par e-mail |
Votre application est créée par Wakastart ; contactez-nous pour en ouvrir une. Wakastart la rattache à votre organisation : elle apparaît alors dans votre menu, sous son nom.
Pourquoi ça existe
Une application concentre ce qui est commun à tous ses utilisateurs, quel que soit leur client : le catalogue des droits, les profils modèles, les fonctionnalités, le code et sa façon de tourner. Les réseaux et les clients n'ajoutent que ce qui leur est propre. Vous décrivez donc une seule fois votre logiciel, et vous le servez à autant d'organisations que nécessaire.
Comment ça marche
La face identité
Elle se règle dans Paramétrage, en onglets :
- Features : les fonctionnalités activables. Une fonctionnalité est active pour un client seulement si elle l'est pour l'application, pour son réseau et pour lui. Elle peut être marquée payante (« Premium »).
- Droits, Profils, Matrice : le catalogue des droits de l'application et les profils modèles qui les regroupent, environnement par environnement (voir Droits, profils et équipes).
- Invitations : l'activation des invitations, l'adresse de la page d'acceptation et le compte d'envoi des e-mails.
- Langues, Thèmes, Crédits, et Légal pour une application commerciale.
À la connexion, Keycloak délivre un jeton dont l'émetteur autorisé (azp) est le WID de l'application. L'API publique vérifie ce point : un jeton émis pour une autre application est refusé.
La face hébergement
Elle se décrit dans Architecture : les dépôts Git, les services, les bases et buckets déclarés, les URLs. À la création de l'application, Wakastart lui prépare un registre d'images (un projet Harbor) et un coffre de secrets. Chaque environnement reçoit ensuite les instances de ce que l'architecture déclare (voir Définitions et instances).
Une application peut n'utiliser qu'une face : une wakapp hébergée ailleurs peut confier seulement l'identité à Wakastart.
Exemples
Une application métier complète. Un éditeur publie « Dossier Patient » : il définit vingt droits et quatre profils modèles, active les invitations, et décrit dans l'architecture un front, une API et une base PostgreSQL. Trois environnements la font tourner : développement, recette, production.
Une application hébergée ailleurs. Une startup garde son hébergement mais délègue la connexion et les droits à Wakastart. Elle n'utilise que Paramétrage et l'API publique ; le menu Architecture reste vide.
Ce qui se règle où
| Vous voulez | Niveau |
|---|---|
| Ajouter un droit à votre catalogue | application |
| Proposer un profil à tous les clients | application (profil modèle) |
| Masquer un profil modèle pour un canal | réseau |
| Donner ses couleurs à une organisation | client |
| Ajouter un service ou une base | application (architecture), puis chaque environnement |
Pour aller plus loin
- Applications et environnements : régler et exploiter l'application.
- Environnements : où l'application tourne et s'authentifie.
- Organisation multi-tenant : ce que l'application contient.
- Référence API : contenus de l'application : thèmes, langues et configuration lus par votre front.