Aller au contenu

Attribuer les rôles HDS

Donnez à chaque utilisateur les rôles HDS de sa fonction, depuis la console ou par l'API publique.

GuideDéveloppeurAdministrateur
Accès requis
Administrateur client, droit « Modifier un utilisateur », et possession des rôles attribués
Durée
5 min
Voir en Markdown

Un utilisateur n'accède au module HDS qu'avec au moins un rôle HDS. Attribuez les rôles depuis la fiche de l'utilisateur dans la console, ou par l'API si votre application gère elle-même ses comptes.

Avant de commencer

  • Le module HDS est actif pour l'application. Voir Activer le module.
  • Vous êtes administrateur client avec le droit Modifier un utilisateur.
  • Vous possédez vous-même chacun des rôles HDS que vous attribuez. Le premier administrateur HDS d'un client est désigné avec l'aide de Wakastart.
  • Vous avez choisi les rôles d'après la matrice des rôles.

Attribuer les rôles

  1. Ouvrez la fiche de l'utilisateur. Voir Utilisateurs et équipes.
  2. Dans le panneau de l'utilisateur, ouvrez l'onglet HDS.
  3. Sous Rôles HDS, cochez les rôles voulus : ADMIN, PATIENT, HEALTHCARE, STORAGE, DELETE, MEDICAL. Survolez un rôle pour afficher sa description.
  4. Cliquez sur Enregistrer les rôles HDS.

Résultat : les rôles cochés apparaissent en couleur dans l'onglet.

PUT /api/config/users/{wid} remplace la liste des rôles HDS de l'utilisateur par celle envoyée.

Bash
curl -X PUT "https://api.wakastart.app/api/config/users/USR001" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "hdsRoles": ["HDS_HEALTHCARE", "HDS_MEDICAL"] }'
TypeScript
await fetch("https://api.wakastart.app/api/config/users/USR001", {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${process.env.ADMIN_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ hdsRoles: ["HDS_HEALTHCARE", "HDS_MEDICAL"] }),
});

La réponse renvoie l'utilisateur mis à jour, avec hdsRoles. Pour retirer tous les rôles, envoyez "hdsRoles": [].

Note

Les rôles sont lus dans le jeton de l'utilisateur. Un utilisateur déjà connecté voit ses nouveaux rôles pris en compte à l'émission de son prochain jeton.

Vérifier le résultat

  1. Connectez-vous avec le compte de l'utilisateur, puis lisez /me : le champ hdsRoles contient les rôles attribués.
  2. Appelez GET /api/hds/vaults avec son jeton : la réponse est 200, et non plus 403.

Dépannage

  • 403 Cannot assign hdsRole HDS_ADMIN: caller does not possess this role : vous tentez d'attribuer un rôle que vous n'avez pas.
  • L'onglet HDS n'apparaît pas : aucune application HDS n'est rattachée au client de l'utilisateur.

Voir aussi