Attribuer des rôles aux groupes d’entreprise

Découvrez comment attribuer et supprimer des rôles aux groupes d’entreprise à l’aide de l’Auth0 Dashboard ou de la Management API.

Auth0 vous permet d’attribuer et de supprimer des rôles aux groupes d’entreprise provisionnés par SCIM à l’aide de l’Auth0 Dashboard ou de la Management API. Lorsque des rôles sont attribués à un groupe, tous les membres héritent de ces rôles à la connexion. Vous pouvez gérer les rôles des groupes dans deux portées :

• Groupes d’organisation — Groupes d’entreprise au sein d’une organisation. Nécessite que Auto-Membership soit activé sur la connexion d’entreprise pour que l’héritage des rôles prenne effet.
• Groupes d’entreprise — Groupes d’entreprise relevant de votre tenant Auth0.

​

Assigner des rôles

​

Groupes d’organisation

Attribuez des rôles aux groupes d’entreprise provisionnés par SCIM au sein d’une organisation. Les groupes d’entreprise sont synchronisés à partir d’un fournisseur d’identité d’entreprise (comme Okta ou Microsoft Entra ID) au moyen de SCIM. Lorsqu’un membre de l’organisation se connecte, il hérite de tous les rôles attribués aux groupes d’entreprise auxquels il appartient.

La connexion d’entreprise de l’organisation doit avoir Auto-Membership activé pour que l’héritage des rôles de groupe prenne effet. Pour en savoir plus sur la façon dont les groupes d’entreprise sont provisionnés, consultez Configurer Inbound SCIM.

Vous pouvez attribuer des rôles de locataire et des rôles d’organisation aux groupes d’entreprise au sein d’une organisation. Pour en savoir plus sur les rôles d’organisation, consultez Rôles d’organisation.

Dashboard

1. Accédez à Dashboard > Organizations et sélectionnez l’organisation.
2. Sélectionnez l’onglet Groups.
3. Sélectionnez le groupe auquel vous voulez attribuer des rôles.
4. Sélectionnez Assign Roles.
5. Recherchez et sélectionnez les rôles que vous voulez attribuer, puis sélectionnez Assign.

Les rôles attribués s’affichent dans les détails du groupe. Les rôles de locataire et les rôles d’organisation limités à cette organisation peuvent tous deux être attribués.

Management API

Effectuez une requête POST vers le point de terminaison Assign Organization Group Roles. Vous aurez besoin des renseignements suivants :

Paramètre	Description
org_id	ID de l’organisation.
group_id	ID du groupe d’entreprise.
role_id	ID du rôle d’organisation à attribuer. Répétez-le dans le tableau pour attribuer plusieurs rôles à la fois.
YOUR_MGMT_API_ACCESS_TOKEN	jeton d’accès à la Management API avec la portée create:organization_group_roles.

curl --request POST \
  --url 'https://{YOUR_AUTH0_DOMAIN}/api/v2/organizations/{ORG_ID}/groups/{GROUP_ID}/roles' \
  --header 'authorization: Bearer YOUR_MGMT_API_ACCESS_TOKEN' \
  --header 'content-type: application/json' \
  --data '{ "roles": [ "ROLE_ID" ] }'

Une requête réussie renvoie une réponse 204 No Content.

​

Groupes d’entreprise

Attribuez des rôles aux groupes d’entreprise provisionnés par SCIM. Lorsqu’un rôle est attribué à un groupe, tous les membres de ce groupe héritent du rôle attribué lorsqu’ils se connectent.

Pour savoir comment les groupes d’entreprise sont provisionnés à partir d’un fournisseur d’identité d’entreprise, consultez Configure Inbound SCIM.

Dashboard

1. Accédez à Dashboard > User Management > Groupes d’entreprise.
2. Sélectionnez le groupe auquel vous voulez attribuer des rôles.
3. Sélectionnez l’onglet Roles, puis Assign Roles.
4. Recherchez et sélectionnez les rôles à attribuer, puis sélectionnez Assign.

Les rôles attribués s’affichent dans l’onglet Roles du groupe.

Management API

Effectuez une requête POST vers le point de terminaison Assign Roles to a Group. Vous avez besoin des renseignements suivants :

Paramètre	Description
group_id	ID du groupe d’entreprise.
role_id	ID du rôle à attribuer. Répétez-le dans le tableau pour attribuer plusieurs rôles à la fois.
YOUR_MGMT_API_ACCESS_TOKEN	jeton d’accès à la Management API avec la portée update:groups.

curl --request POST \
  --url 'https://{YOUR_AUTH0_DOMAIN}/api/v2/groups/{group_id}/roles' \
  --header 'authorization: Bearer YOUR_MGMT_API_ACCESS_TOKEN' \
  --header 'content-type: application/json' \
  --data '{ "roles": [ "ROLE_ID" ] }'

Une requête réussie renvoie une réponse 204 No Content.

​

Supprimer des rôles

​

Groupes d’organisation

Supprimez des rôles des Groupes d’entreprise provisionnés par SCIM dans une organisation. Une fois un rôle supprimé, les membres de l’organisation de ce groupe n’en hériteront plus lorsqu’ils se connecteront.

La connexion d’entreprise de l’organisation doit avoir l’Auto-Membership activée pour que l’héritage des rôles de groupe s’applique.

Dashboard

1. Accédez à Dashboard > Organizations et sélectionnez l’organisation.
2. Sélectionnez l’onglet Groups.
3. Sélectionnez le groupe que vous souhaitez mettre à jour.
4. Repérez le rôle que vous souhaitez supprimer, puis sélectionnez l’icône de corbeille à côté.
5. Confirmez la suppression.

Le rôle n’apparaît plus dans les détails du groupe.

Management API

Effectuez une requête DELETE vers le point de terminaison Delete Organization Group Roles. Vous aurez besoin des renseignements suivants :

Paramètre	Description
org_id	ID de l’organisation.
group_id	ID du Groupe d’entreprise.
role_id	ID du rôle d’organisation à supprimer. Répétez-le dans le tableau pour supprimer plusieurs rôles à la fois.
YOUR_MGMT_API_ACCESS_TOKEN	Jeton d’accès à la Management API avec la portée delete:organization_group_roles.

curl --request DELETE \
  --url 'https://{YOUR_AUTH0_DOMAIN}/api/v2/organizations/ORG_ID/groups/GROUP_ID/roles' \
  --header 'authorization: Bearer YOUR_MGMT_API_ACCESS_TOKEN' \
  --header 'content-type: application/json' \
  --data '{ "roles": [ "ROLE_ID" ] }'

Une requête réussie renvoie une réponse 204 No Content.

​

Groupes d’entreprise

Supprimez des rôles des groupes d’entreprise provisionnés par SCIM. Une fois un rôle supprimé, les membres du groupe n’en hériteront plus lorsqu’ils se connecteront.

Dashboard

1. Accédez à Dashboard > User Management > Groupes d’entreprise.
2. Sélectionnez le groupe que vous souhaitez mettre à jour.
3. Sélectionnez l’onglet Roles.
4. Repérez le rôle que vous souhaitez supprimer, puis sélectionnez l’icône de corbeille à côté.
5. Confirmez la suppression.

Le rôle n’apparaît plus dans l’onglet Roles du groupe.

Management API

Effectuez une requête DELETE vers l’endpoint Remove Roles from a Group. Vous avez besoin des renseignements suivants :

Paramètre	Description
group_id	ID du groupe d’entreprise.
role_id	ID du rôle à supprimer. Répétez-le dans le tableau pour supprimer plusieurs rôles à la fois.
YOUR_MGMT_API_ACCESS_TOKEN	jeton d’accès à la Management API avec la portée update:groups.

curl --request DELETE \
  --url 'https://{YOUR_AUTH0_DOMAIN}/api/v2/groups/GROUP_ID/roles' \
  --header 'authorization: Bearer YOUR_MGMT_API_ACCESS_TOKEN' \
  --header 'content-type: application/json' \
  --data '{ "roles": [ "ROLE_ID" ] }'

Une requête réussie renvoie une réponse 204 No Content.

​

En savoir plus

• Rôles de l’organisation
• Configurer Inbound SCIM
• Accorder une appartenance juste-à-temps à une connexion d’organisation
• Ajouter des rôles aux membres de l’organisation
• Supprimer des rôles des membres de l’organisation
• Supprimer des rôles des utilisateurs
• Afficher les rôles attribués aux utilisateurs