Créer un rôle
Objectif
Créer un rôle dans votre locataire pour pouvoir l’attribuer à des utilisateurs — et savoir où aller ensuite pour lui donner un accès réel.
Prérequis
- Vous êtes connecté au Centre de contrôle d’administration en tant qu’administrateur de la plateforme.
Étapes
- Ouvrez la page Rôles depuis la navigation de gauche.
- Sélectionnez Nouveau. Un panneau latéral s’ouvre.
- Saisissez un nom d’affichage — ce que les gens liront — et un nom logique, qui constitue l’identité du rôle. Ajoutez une description de ce à quoi sert le rôle.
- Sélectionnez Enregistrer.
- Donnez un accès au rôle : ouvrez Solutions, ouvrez la solution qui contient l’application, et utilisez sa page Rôles (voir Accorder à un rôle l’accès aux enregistrements). Un rôle qui vient d’être créé n’autorise absolument rien.
Un rôle a deux noms
C’est un piège dans lequel on tombe une fois et plus jamais ensuite ; cela vaut donc la peine de s’y arrêter un instant.
| Ce que c’est | Peut-on le modifier ? | |
|---|---|---|
| Nom d’affichage | Les mots que les gens lisent — « Ventes et avant-vente » | Oui |
| Nom logique | L’identité du rôle — sales | Non |
Le nom logique n’est pas un libellé. C’est la revendication (claim) que porte le jeton d’un utilisateur connecté, et c’est la clé sous laquelle chaque environnement stocke les autorisations du rôle. Le modifier laisserait chacune de ces attributions pointer vers un rôle qui n’existe plus — sans bruit, car « un rôle sans attributions » est un état parfaitement valide qui n’autorise simplement rien. Personne ne s’en apercevrait avant que quelqu’un ne puisse plus ouvrir un enregistrement. Il fonctionne exactement comme le nom logique d’une table, et il est figé exactement pour la même raison.
Le nom d’affichage n’est jamais lu que par des personnes : le modifier ne casse donc rien. Si vous voulez que le rôle s’appelle autrement, c’est lui qu’il faut changer.
Les rôles que vous créez ici sont des rôles système : leur nom logique ne porte aucun préfixe
d’éditeur, car un rôle inventé par votre organisation vous appartient, et non à l’application de
quelqu’un. Un rôle dont le nom est préfixé, comme par_sales, a été créé à l’intérieur d’une
solution, ou est arrivé avec l’une d’elles.
Modifier un rôle
Cliquez sur la ligne d’un rôle — ou cochez-la et sélectionnez Modifier — pour rouvrir le panneau latéral. Le nom d’affichage et la description sont modifiables ; le nom logique est affiché, verrouillé, pour que vous puissiez toujours lire l’identité à laquelle un package ou un message d’erreur fait référence.
Si vous avez réellement besoin d’un autre nom logique — ce sera rarement le cas —, c’est un travail délibéré plutôt qu’une simple modification :
- Créez le nouveau rôle.
- Accordez-lui le même accès, dans chaque solution. Copier le rôle, sur la page Rôles de la solution, le fait en une seule étape (voir Accorder à un rôle l’accès aux enregistrements).
- Transférez-y ses utilisateurs (voir Attribuer un rôle à un utilisateur).
- Supprimez l’ancien rôle.
Un rôle n’accorde rien à lui seul
Créer un rôle lui donne un nom, et rien d’autre. Ce qu’il a le droit de faire se décide à l’intérieur d’une solution — et ce n’est pas un hasard lié à l’emplacement de l’écran. Une autorisation nomme une table, les tables appartiennent à un environnement, et une attribution qui doit atteindre Test et Prod doit voyager dans un package. Se placer dans une solution fixe ces deux éléments d’un coup, et c’est pourquoi cet écran n’a jamais besoin de vous demander de quel environnement il s’agit.
| Le rôle | Ses autorisations | |
|---|---|---|
| Portée | Tout le locataire | Une solution, dans un environnement |
| Contient | Le nom et la description | Ce qu’il peut créer, lire, mettre à jour ou supprimer, et sur quels enregistrements |
| Où | Cette page | Solutions → votre solution → Rôles |
| Attribué à | Des utilisateurs, sur la page Utilisateurs | Rien — elles sont les attributions du rôle |
Ce qui se passe en coulisses
Le rôle est créé dans votre locataire, sans aucune autorisation. Lorsqu’un utilisateur qui le détient se connecte, le rôle voyage dans son jeton sous forme de revendication ; chaque environnement recherche alors ce qui a été accordé à ce nom sur place.
Dépannage
- « Un rôle nommé … existe déjà. » — un rôle portant ce nom existe déjà. Choisissez un autre nom.
- La zone du nom logique est grisée. — vous consultez un rôle existant, et ce nom est figé. Si vous vouliez changer la façon dont le rôle s’appelle, modifiez le nom d’affichage juste au-dessus ; celui-là est modifiable et rien ne casse.
- Vous ne pouvez pas supprimer un rôle — un rôle encore attribué à un ou plusieurs utilisateurs ne peut pas être supprimé. Retirez-le d’abord à ces utilisateurs (voir Attribuer un rôle à un utilisateur), puis supprimez-le.
- Modifier est grisé. — cette commande agit sur exactement un rôle. Cochez une seule ligne, ou cliquez simplement sur la ligne voulue.
- J’ai créé un rôle et l’utilisateur ne peut toujours rien faire. — c’est normal. Accordez-lui un accès sur la page Rôles d’une solution, dans chaque environnement où il doit atteindre quelque chose.