Découvrir le Hub › Parcours

Parcours · administrateur de la plateforme

Accueillir un nouveau client

Créer le tenant d'un client, compléter son identité, l'activer, puis lui ouvrir son premier compte avec les bons droits.

Rejouer tout le parcours dans le Hub

1. Créer le tenant

   Le tenant est la boîte qui rangera tout ce qui appartient au client : ses comptes, ses applications, ses données. Son slug l'identifie partout — dans le jeton de connexion, dans l'en-tête X-SSO-Tenant que reçoivent les applications, dans les journaux — et ne change plus jamais : choisissez-le avec soin (minuscules, chiffres, - et _).

   Ouvrez le formulaire, vérifiez le slug lumen-formation et le nom, puis cliquez sur Créer. Le plan n'est qu'une étiquette commerciale : il ne change pas les quotas.

   Action du Hub : iam_worker.create_tenant

   Faire cette étape dans le Hub → Pour aller plus loin : iam.tenants.creer.slug iam.tenants.creer.valider

2. Découvrir le tenant, en attente

   Le Hub a créé le tenant au statut pending, avec les quotas par défaut (50 utilisateurs, 10 applications, 100 Go) et une ligne d'audit qui garde qui l'a créé. Vous êtes sur sa fiche.

   pending veut dire « créé, pas encore activé ». C'est le moment de compléter son identité avant de l'ouvrir. Les quotas se règlent ici, dans Éditer.

   Faire cette étape dans le Hub → Pour aller plus loin : iam.tenant.statut iam.tenant.editer.max_apps

3. Compléter la fiche société

   La fiche société porte la raison sociale, le SIREN, l'adresse, le représentant, les couleurs et le logo. Les applications du client la lisent au Hub : personne ne ressaisit l'identité de la société dans chaque outil.

   L'écran montré ici est celui d'un autre client, acme : la fiche de Lumen Formation est la même page, encore vide. Remplissez-la, puis Enregistrer.

   ⚠ L'enregistrement remplace toute la fiche : un champ vidé est effacé. Un SIREN invalide ou déjà pris par un autre tenant est refusé.

   Action du Hub : iam_worker.upsert_tenant_fiche

   Faire cette étape dans le Hub → Pour aller plus loin : iam.fiche.ecran iam.fiche.siren iam.fiche.enregistrer

4. Activer le tenant

   La fiche est complète : on met le client en service. Le bouton Activer n'apparaît que sur un tenant en attente. Le statut passe à active, la version du tenant augmente de 1 et une ligne d'audit garde l'auteur.

   Action du Hub : iam_worker.activate_tenant

   Faire cette étape dans le Hub → Pour aller plus loin : iam.tenant.activer

5. Créer le compte de l'administrateur

   Le compte se crée dans IAM › Utilisateurs. Le champ Tenant ID reçoit le slug lumen-formation : il prime sur les règles de rattachement. Laissé vide, le Hub aurait cherché une règle d'après le domaine de l'adresse.

   Le mot de passe initial se transmet à la personne par un canal sûr ; le Hub n'en garde que l'empreinte. Le compte est actif dès sa création.

   ⚠ Les cases de rôles du formulaire sont ignorées à la création sur le Hub 3.77.0 : le compte naît sans rôle. Le rôle se donne à l'étape suivante.

   Action du Hub : iam_worker.create_user

   Faire cette étape dans le Hub → Pour aller plus loin : iam.users.creer.tenant_id iam.users.creer.roles iam.users.creer.valider

6. Lui donner son rôle

   Sur la fiche du compte, Assigner un rôle donne le rôle choisi ; ses scopes s'ajoutent aussitôt aux droits effectifs. L'opération est sans risque à répéter : un rôle déjà détenu ne change rien.

   L'écran montré ici est la fiche d'un autre compte : celle de Karim Haddad est identique. Le même écran sert aussi à créer une clé API au nom du compte, et à lui ouvrir un tenant supplémentaire.

   Action du Hub : iam_worker.assign_role

   Faire cette étape dans le Hub → Pour aller plus loin : iam.user.roles.choix iam.user.roles.assigner

Pièges

• Le slug est définitif. Une faute de frappe impose de recréer le tenant.
• Les rôles cochés à la création sont perdus : assignez-les depuis la fiche du compte.
• Le champ « ID utilisateur » de l'octroi d'accès attend le numéro du compte (ex. 7), pas un UUID.