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.
Quand l’utiliser
Section intitulée « Quand l’utiliser »- 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.
Avant de commencer
Section intitulée « Avant de commencer »- La bonne page. Ouvrez Configurer → Accès → Affectations. Il vous
faut le droit
updatesuriam.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.
1. Ouvrir l’éditeur d’affectations
Section intitulée « 1. Ouvrir l’éditeur d’affectations »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.
2. Affecter un rôle
Section intitulée « 2. Affecter un rôle »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à :
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 deroles.- Le hook dédoublonne le tableau et garde l’ordre de première apparition.
3. Retirer un rôle
Section intitulée « 3. Retirer un rôle »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.
4. Vérifier le résultat
Section intitulée « 4. Vérifier le résultat »Relisez le compteà :
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.
Comment fonctionne l’élection
Section intitulée « Comment fonctionne l’élection »Un rôle par requête
Section intitulée « Un rôle par requête »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.
L’élection à la connexion
Section intitulée « L’élection à la connexion »La requête de connexion peut porter l’élection dans son champ role, comme
id qualifiéà :
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.anonymouscréé par l’initialisation. La réponse montreavailable_roles: []avec le rôle anonymous commeactive_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.
Changer de rôle pendant une session
Section intitulée « Changer de rôle pendant une session »Un membre change de rôle sans se reconnecter. La route de refresh accepte la nouvelle élection :
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.
Dépannage
Section intitulée « Dépannage »L’écriture d’affectation répond 403
Section intitulée « L’écriture d’affectation répond 403 »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.
La connexion répond 403 Role not assigned
Section intitulée « La connexion répond 403 Role not assigned »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.
Un membre agit avec des droits inattendus
Section intitulée « Un membre agit avec des droits inattendus »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é.
Voir aussi
Section intitulée « Voir aussi »-
Rôles et lignes de permission — ce que porte un rôle.
-
Gérer les comptes — créez d’abord le compte.
-
Contextes d’authentification — le modèle un-rôle-par-requête.
-
Auditer l’activité — le
acting_roleàchaque écriture.
-
Se connecter, MFA, réinitialiser votre mot de passe — les étapes de connexion du membre.
-
Internes sur GitHubà : rbac.md, access-assignments.md.