Créer des rôles

Découvrez comment créer un rôle à l’aide de l’Auth0 Dashboard ou de la Management API.

Vous pouvez créer des rôles à l’aide du Dashboard d’Auth0 ou de la Management API. Les rôles fonctionnent avec l’ensemble de fonctionnalités Authorization Core pour les API.

Vous pouvez créer deux types de rôles dans Auth0 :

• Rôles de tenant : s’appliquent à l’ensemble de votre tenant et peuvent être attribués à n’importe quel utilisateur.
• Rôles d’organisation : limités à une organisation précise. Les utilisateurs peuvent avoir des rôles d’organisation différents dans chaque organisation à laquelle ils appartiennent. Pour en savoir plus, consultez Rôles d’organisation.

​

Prérequis

• Pour que le contrôle d’accès basé sur les rôles (RBAC) fonctionne correctement, vous devez l’activer pour votre API à l’aide du Dashboard ou de la Management API. La fonctionnalité Authorization Core est différente de l’Authorization Extension. Pour comparer les deux, consultez Authorization Core vs. Authorization Extension.
• Configurer une API dans l’Auth0 Dashboard.
• Les permissions proviennent de valeurs prédéfinies. Si votre liste de permissions est vide, vous devez ajouter des permissions à votre API.

​

Créer un rôle de tenant

Les rôles de tenant s’appliquent à l’ensemble du tenant et peuvent être attribués à n’importe quel utilisateur, qu’il appartienne ou non à une organisation.

Auth0 Dashboard

1. Accédez à Dashboard > User Management > Roles et sélectionnez Create Role.
2. Donnez un nom au rôle et ajoutez une description, puis sélectionnez Create.

Management API

Effectuez un appel POST au point de terminaison Create Role. Veillez à remplacer les valeurs de remplacement MGMT_API_ACCESS_TOKEN, ROLE_NAME et ROLE_DESC par votre jeton d’accès de l’API de gestion, le nom du rôle et la description du rôle, respectivement.

Valeur	Description
MGMT_API_ACCESS_TOKEN	Jeton d’accès pour la Management API avec le scope create:roles.
ROLE_NAME	Nom du rôle à créer.
ROLE_DESC	Description conviviale du rôle.

​

Créer un rôle d’organisation

Vous pouvez créer des rôles d’organisation à partir de la vue de gestion de l’organisation. Les administrateurs de tenant peuvent créer jusqu’à 350 rôles d’organisation par organisation.

Auth0 Dashboard

1. Accédez à Dashboard > Organizations et sélectionnez l’organisation.
2. Sélectionnez l’onglet Roles, puis Create Role.
3. Saisissez un nom et une description pour le rôle, puis sélectionnez Create.

Management API

Effectuez une requête POST vers le endpoint Create Role. Définissez type à "organization" et owner_id à l’ID de l’organisation. Veillez à remplacer les valeurs de l’espace réservé MGMT_API_ACCESS_TOKEN, ROLE_NAME, ROLE_DESC et ORG_ID par votre jeton d’accès pour la Management API, le nom du rôle, la description du rôle et l’ID de l’organisation, respectivement.

cURL

curl --request POST \
  --url 'https://{yourDomain}/api/v2/roles' \
  --header 'authorization: Bearer MGMT_API_ACCESS_TOKEN' \
  --header 'cache-control: no-cache' \
  --header 'content-type: application/json' \
  --data '{ "name": "ROLE_NAME", "description": "ROLE_DESC", "type": "organization", "owner_id": "ORG_ID" }'

Valeur	Description
MGMT_API_ACCESS_TOKEN	Jeton d’accès pour la Management API avec la portée create:roles.
ROLE_NAME	Nom du rôle d’organisation à créer. Il doit être unique au sein de l’organisation.
ROLE_DESC	Description conviviale du rôle.
ORG_ID	ID de l’organisation dans laquelle créer le rôle.

La réponse comprend type: "organization" et owner_id, ce qui confirme que le rôle est associé à l’organisation.

​

En savoir plus

• Ajouter des permissions aux rôles
• Supprimer des permissions des rôles
• Assigner des rôles aux utilisateurs
• Supprimer des rôles