Skip to content

Administrer votre organisation

Premiers pas d'un administrateur client : se connecter, lire la console, inviter un utilisateur avec son profil, consulter le journal d'audit.

QuickstartAdministrator
Required access
Niveau Administrateur client
Duration
10 min

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

Ce démarrage rapide s'adresse à l'administrateur d'une organisation cliente. En dix minutes, vous prenez vos repères dans la console, vérifiez ce que votre compte vous permet, ajoutez un collègue avec le bon profil et retrouvez la trace de vos actions.

Ce que vous allez faire

  1. Vous connecter à la console Wakastart.
  2. Lire votre tableau de bord et repérer vos applications.
  3. Vérifier votre niveau d'administration et vos droits.
  4. Inviter un utilisateur dans votre organisation, avec son profil.
  5. Consulter le journal d'audit.

Avant de commencer

  • Un compte sur la console, avec le niveau Administrateur client. Wakastart crée le premier administrateur de chaque organisation.
  • Pour l'étape 4 : un profil qui porte le droit invitations.create dans l'application, et un terminal avec curl.
  • Pour l'étape 5 : le profil Auditeur.

Se connecter à la console

  1. Ouvrez https://app.wakastart.app.
  2. Sur l'écran Bienvenue, saisissez votre Adresse email, puis cliquez sur Continuer.
  3. Sur la page de connexion qui s'ouvre, saisissez votre mot de passe.

Résultat : la console s'ouvre sur le Tableau de bord, avec une salutation suivie de votre prénom, par exemple « Bonjour, Claire ». Lors de votre première connexion, une fenêtre « Bienvenue sur Wakastart ! » vous accueille ; vous pouvez la fermer.

Repérer vos applications

Le Tableau de bord d'un administrateur client contient deux cartes :

  • Accès rapide (« Vos applications ») : une tuile par application de votre organisation. Cliquez sur une tuile pour l'ouvrir.
  • Dernière activité : les derniers builds de vos applications, toutes confondues.

Dans le menu latéral, chaque application forme un groupe à son nom. Il contient Paramétrage, accessible aux profils Développeur et Infra, puis, pour ces mêmes profils, Architecture, Builds, Environnements et Backups.

Résultat : vous savez quelles applications votre organisation utilise. Si la carte affiche « Aucune application ne vous est encore assignée », contactez Wakastart : aucune application n'est encore rattachée à votre organisation.

Vérifier votre niveau d'accès

  1. En bas du menu latéral, cliquez sur votre nom, puis sur Mon profil.
  2. Lisez la carte Niveaux d'accès :
    • Niveau d'administration : « Administrateur Client » ;
    • Droits applicatifs (AppRights) : les codes de droits que vous détenez, par exemple audit.read ;
    • Profils assignés : vos profils, par exemple Infra ou Auditeur.

Résultat : vous savez ce que la console vous montrera. Le tableau de la visite de la console indique quel profil ouvre quel menu.

Inviter un utilisateur avec son profil

L'invitation passe par l'API publique, avec un jeton que Keycloak vous a délivré en vous connectant à votre application (voir Connecter vos utilisateurs). Le profil est attribué dans la même requête : l'invité le reçoit dès qu'il accepte.

Bash
curl -s https://api.wakastart.app/api/invitations \
  -H "Authorization: Bearer $JETON" \
  -H 'Content-Type: application/json' \
  -d '{
    "customerId": "EXCLI1",
    "invitedEmail": "paul.durand@exemple.fr",
    "invitedFirstName": "Paul",
    "invitedLastName": "Durand",
    "profileWid": "EXPRF1",
    "language": "fr"
  }'
TypeScript
const response = await fetch("https://api.wakastart.app/api/invitations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.JETON}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    customerId: "EXCLI1", // WID de votre organisation
    invitedEmail: "paul.durand@exemple.fr",
    invitedFirstName: "Paul",
    invitedLastName: "Durand",
    profileWid: "EXPRF1", // identifiant du profil à attribuer
    language: "fr",
  }),
});
console.log(response.status, await response.json());

Réponse attendue, 201 (extrait) :

JSON
{
  "id": "6f1c2b9e-3d47-4a8e-9c1f-2b7d5e8a4c10",
  "invitedEmail": "paul.durand@exemple.fr",
  "invitedFirstName": "Paul",
  "invitedLastName": "Durand",
  "status": "PENDING",
  "envType": "prod",
  "language": "fr",
  "expiresAt": "2026-11-02T09:30:00.000Z",
  "customer": { "wid": "EXCLI1", "name": "Clinique Exemple" },
  "profile": { "wid": "EXPRF1", "name": "Soignant" }
}

customerId reçoit le WID de votre organisation, que GET /api/me renvoie dans customer.wid : un administrateur client ne peut inviter que dans la sienne. L'invitation vise toujours l'environnement de votre jeton, ici la production : n'envoyez pas envType, il est refusé en 400. Pour inviter la même personne en staging, utilisez un jeton obtenu en vous connectant à l'application de staging.

Résultat : Paul reçoit un e-mail d'invitation. Le lien ouvre la page d'acceptation de votre application, ou à défaut la page Rejoindre la plateforme de Wakastart, où il saisit son Prénom, son Nom et son Mot de passe (8 à 128 caractères), coche J'accepte les Conditions d'utilisation, puis clique sur Créer mon compte. Le lien reste valable 10 jours, sauf réglage différent de l'application.

Consulter le journal d'audit

  1. Dans le menu latéral, ouvrez Sécurité, puis Audit Logs.
  2. Cliquez sur Filtres pour restreindre la période, la sévérité ou l'action.
  3. Ouvrez une entrée pour lire son détail, puis cliquez sur Vérifier l'intégrité pour contrôler qu'elle n'a pas été modifiée.

Résultat : vous voyez les actions enregistrées sous votre compte, horodatées et vérifiables. Exporter produit un fichier JSON ou CSV chiffré, après saisie d'une raison d'export.

Vérifier le résultat

  • Mon profil affiche votre niveau et vos profils.
  • L'invitation renvoyée par l'API a le statut PENDING. Elle passe à ACCEPTED quand Paul a créé son compte ; il se connecte ensuite à votre application avec le profil choisi.
  • Le journal d'audit liste vos actions des derniers jours.

Note

Si l'API répond 403 avec le message « Droit applicatif requis : invitations.create », votre profil ne porte pas ce droit dans l'application. Demandez à l'éditeur de l'application de l'ajouter à votre profil. Une réponse 409 signale qu'une invitation est déjà en cours pour cette adresse.

Étapes suivantes