Aller au contenu

Affecter les rôles et l’élection

Un compte porte des rôles dans son tableau roles. Une requête ne les fusionne jamaisà : elle tourne sous exactement un rôle élu. Cette page montre comment un administrateur affecte et retire des rôles, et comment l’élection fonctionne à la connexion et au refresh.

  • Vous embauchez un membre et devez lui donner ses rôles de travail.
  • Vous déplacez un membre vers une autre équipe, avec d’autres droits.
  • Vous devez expliquer pourquoi un membre agit sous un rôle alors qu’il en porte trois.
  • La bonne page. Ouvrez Configurer → Accès → Affectations. Il vous faut le droit update sur iam.Account.
  • Le garde-fou. Le garde-fou d’autorité des rôles s’appliqueà : vous ne pouvez affecter que des rôles de votre niveau élu ou en dessous. Voir Rôles et lignes de permission.

Ouvrez Configurer → Accès → Affectations. L’éditeur a deux modesà :

Mode Ce qu’il affiche Ce qu’il écrit
Par rôle Choisissez un rôle, voyez ses membres. Le tableau roles de chaque compte que vous ajoutez ou retirez.
Par compte Choisissez un compte, voyez ses rôles. Le tableau roles de ce compte.

Les deux modes partagent un seul chemin d’écriture. L’URL de la page se prête aux liens profonds, par exemple /Configure/access/assignments?mode=account&account=<id> ; l’état survit à

un rechargement.

Dans le mode Par compte, cherchez le compte par courriel, puis ajoutez un ou plusieurs rôles. Chaque enregistrement émet une mise à jour du document compte, comme un PATCH manuelà :

Fenêtre de terminal
curl -k -X PATCH -H "Authorization: Bearer $FACET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"roles": ["iam.Roles.editor", "iam.Roles.comment_author"], "default_role": "iam.Roles.editor"}' \
"https://facet.localhost:3443/Api/iam/Account/01J8Z0A7G3Q5M2X9K4T6VBNR8D"

Remplacez les ids de rôles et l’id du compte par vos valeurs. La réponse est le document compte mis à jour.

Les règles que l’écriture imposeà :

  • Chaque rôle du tableau final doit exister et être vivant.
  • Chaque rôle doit se situer à votre niveau ou en dessous.
  • default_role, s’il est positionné, doit faire partie de roles.
  • Le hook dédoublonne le tableau et garde l’ordre de première apparition.

Sélectionnez Retirer sur la ligne du rôle, ou retirez-le du tableau. L’écriture suit les mêmes règles. Vous ne pouvez pas vous retirer d’un rôle au-dessus de votre niveau — la règle de protection de la cible bloque l’écriture.

Relisez le compteà :

Fenêtre de terminal
curl -k -H "Authorization: Bearer $FACET_API_KEY" \
"https://facet.localhost:3443/Api/iam/Account/01J8Z0A7G3Q5M2X9K4T6VBNR8D"

Le tableau roles montre les ids affectés. Le membre voit le nouveau rôle à

sa prochaine connexion ou au refresh de son token.

Les rôles ne fusionnent jamais. Un compte qui porte editor et viewer agit sous l’un d’eux par requête. L’ensemble effectif de permissions est exactement celui d’un rôle. Rapprocher des périmètres entre deux rôles n’a pas de réponse non surprenanteà ; Facet ne le tente pas. Voir Contextes d’authentification pour le modèle.

La requête de connexion peut porter l’élection dans son champ role, comme id qualifiéà :

Fenêtre de terminal
curl -k -X POST -H "Content-Type: application/json" \
-H "X-Requested-With: XMLHttpRequest" \
-d '{"email": "ana@example.tld", "password": "PASTE-THE-PASSWORD", "role": "iam.Roles.editor"}' \
"https://facet.localhost:3443/Api/iam/login"

L’ordre de résolution : l’élection explicite, puis default_role, puis le premier rôle affecté. Élire un rôle que le compte ne porte pas répond 403. Les réponses de connexion, de refresh et de me portent toutes la paireà :

  • active_role — l’id du rôle élu.

  • available_roles — les ids des rôles affectés, la liste entre laquelle un membre peut basculer.

    Un compte sans rôle tourne sous le rôle iam.Roles.anonymous créé par l’initialisation. La réponse montre available_roles: [] avec le rôle anonymous comme active_role ; l’espace de travail rend un écran sans rôle à partir de cette paire. Voir Rôles et lignes de permission pour ce que contrôle le rôle anonymous.

Un membre change de rôle sans se reconnecter. La route de refresh accepte la nouvelle élection :

Fenêtre de terminal
curl -k -X POST -H "Content-Type: application/json" \
-H "X-Requested-With: XMLHttpRequest" \
-d '{"role": "iam.Roles.viewer"}' \
"https://facet.localhost:3443/Api/iam/refresh"

La route répond 403 Role not assigned quand le compte ne porte pas le rôle, et 403 Role not found or disabled quand le document du rôle n’existe pas. La barre latérale de l’espace de travail expose le même basculement dans son menu Changer de rôle. Le manifeste de permissions du nouveau rôle voyage dans la réponse, et l’interface se resserre aussitôt.

Vérifiez le niveauà : vous ne pouvez affecter que des rôles de votre niveau élu ou en dessous, et vous ne pouvez pas modifier un compte dont le plafond de rôles dépasse le vôtre.

Le membre ne voit rien de nouveau après l’affectation

Section intitulée « Le membre ne voit rien de nouveau après l’affectation »

Les rôles s’appliquent à la prochaine connexion ou au prochain refresh. Demandez au membre de rafraîchir, ou de changer une fois de rôle.

L’élection nomme un rôle hors du tableau roles du compte. Affectez d’abord le rôle, ou connectez-vous sans le champ role.

Demandez-lui quel rôle il a élu. Un seul rôle s’applique par requêteà ; les droits peuvent venir d’un rôle plus large que vous ne le pensez. Le journal d’audit nomme le rôle agissant à chaque écriture — voir Auditer l’activité.