Enterprise Groups にロールを割り当てる

Auth0 では、Auth0 Dashboard または Management API を使用して、でプロビジョニングされた Enterprise Groups にロールを割り当てたり、削除したりできます。グループにロールを割り当てると、すべてのメンバーがログイン時にそのロールを継承します。グループのロールは、次の 2 つのスコープで管理できます。

Organization グループ — 特定の Organization 内の Enterprise Groups。グループのロール継承を有効にするには、エンタープライズ接続で Auto-Membership を有効にする必要があります。
Enterprise Groups — Auth0 テナント内の Enterprise Groups。

ロールの割り当て

Organization グループ

Organization 内の SCIM でプロビジョニングされた Enterprise Groups にロールを割り当てます。Enterprise Groups は、SCIM を介してエンタープライズアイデンティティプロバイダー (Okta や Microsoft Entra ID など) から同期されます。organization のメンバーがログインすると、自分が所属する Enterprise Groups に割り当てられているロールを継承します。グループのロール継承を有効にするには、Organization のエンタープライズ接続で Auto-Membership enabled が有効になっている必要があります。Enterprise Groups がどのようにプロビジョニングされるかについて詳しくは、インバウンドSCIMを設定するを参照してください。 organization 内のエンタープライズグループには、テナントロールと組織ロールの両方を割り当てることができます。組織ロールについて詳しくは、組織ロールを参照してください。

Auth0 Dashboard
Management API

Auth0 Dashboard > Organizations に移動し、Organization を選択します。
Groups タブを選択します。
ロールを割り当てるグループを選択します。
Assign Roles を選択します。
割り当てるロールを検索して選択し、Assign を選択します。

割り当てられたロールは、グループの詳細に表示されます。この Organization にスコープが設定されたテナントロールと組織ロールの両方を割り当てることができます。

Assign Organization Group Roles エンドポイントに POST リクエストを送信します。必要な情報は次のとおりです。

Parameter	Description
`org_id`	Organization の ID。
`group_id`	Enterprise Group の ID。
`role_id`	割り当てる組織ロールの ID。複数のロールを一度に割り当てるには、配列内に複数指定します。
`YOUR_MGMT_API_ACCESS_TOKEN`	`create:organization_group_roles` スコープを持つ Management API access token。

Auth0 CLI
cURL

Auth0 CLI を使用していますか？まだの場合は、このコマンドを実行する前に CLI セッションを設定して認証します。

auth0 api post "organizations/{ORG_ID}/groups/{GROUP_ID}/roles" \
  --data '{ "roles": [ "ROLE_ID" ] }'

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" ] }'

リクエストが成功すると、204 No Content レスポンスが返されます。

Enterprise Groups

SCIM でプロビジョニングされた Enterprise Groups にロールを割り当てます。グループにロールを割り当てると、そのグループのすべてのメンバーに、ログイン時にそのロールが自動的に付与されます。エンタープライズアイデンティティプロバイダーから Enterprise Groups がどのようにプロビジョニングされるかについては、インバウンドSCIMを設定するを参照してください。

Auth0 Dashboard
Management API

Auth0 Dashboard > User Management > Enterprise Groups に移動します。
ロールを割り当てるグループを選択します。
Roles タブを選択し、Assign Roles を選択します。
割り当てるロールを検索して選択し、Assign を選択します。

割り当てられたロールは、グループの Roles タブに表示されます。

Assign Roles to a Group エンドポイントに POST リクエストを送信します。必要な情報は次のとおりです。

Parameter	Description
`group_id`	Enterprise Group の ID。
`role_id`	割り当てるロールの ID。複数のロールを一度に割り当てるには、配列内で繰り返し指定します。
`YOUR_MGMT_API_ACCESS_TOKEN`	`update:groups` スコープを持つ Management API access token。

Auth0 CLI
cURL

auth0 api post "groups/{group_id}/roles" \
  --data '{ "roles": [ "ROLE_ID" ] }'

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" ] }'

リクエストが成功すると、204 No Content レスポンスが返されます。

ロールを削除

Organization グループ

Organization 内の SCIM でプロビジョニングされた Enterprise Group からロールを削除します。ロールを削除すると、そのグループに属する Organization メンバーは、ログイン時にそのロールを継承しなくなります。グループのロール継承を有効にするには、その Organization のエンタープライズ接続で Auto-Membership を有効化しておく必要があります。

Auth0 Dashboard
Management API

Auth0 Dashboard > Organizations に移動し、対象の Organization を選択します。
Groups タブを選択します。
更新するグループを選択します。
削除するロールを見つけて、その横にあるごみ箱アイコンを選択します。
削除を確認します。

削除したロールは、グループの詳細に表示されなくなります。

Delete Organization Group Roles エンドポイントに DELETE リクエストを送信します。必要な情報は次のとおりです。

Parameter	Description
`org_id`	Organization の ID。
`group_id`	Enterprise Group の ID。
`role_id`	削除する Organization ロールの ID。複数のロールを一度に削除するには、配列内に複数指定します。
`YOUR_MGMT_API_ACCESS_TOKEN`	`delete:organization_group_roles` スコープを持つ Management API access token。

Auth0 CLI
cURL

auth0 api delete "organizations/ORG_ID/groups/GROUP_ID/roles" \
  --data '{ "roles": [ "ROLE_ID" ] }'

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" ] }'

リクエストが成功すると、204 No Content レスポンスが返されます。

Enterprise Groups

SCIM でプロビジョニングされた Enterprise Groups からロールを削除します。ロールを削除すると、グループメンバーはログイン時にそのロールを継承しなくなります。

Auth0 Dashboard
Management API

Auth0 Dashboard > User Management > Enterprise Groups に移動します。
更新するグループを選択します。
Roles タブを選択します。
削除するロールを見つけ、横にあるごみ箱アイコンを選択します。
削除を確定します。

削除したロールは、グループの Roles タブに表示されなくなります。

Remove Roles from a Group エンドポイントに DELETE リクエストを送信します。必要な情報は次のとおりです。

Parameter	Description
`group_id`	Enterprise Group の ID。
`role_id`	削除するロールの ID。一度に複数のロールを削除する場合は、配列内に複数指定します。
`YOUR_MGMT_API_ACCESS_TOKEN`	`update:groups` スコープを持つ Management API access token。

Auth0 CLI
cURL

auth0 api delete "groups/GROUP_ID/roles" \
  --data '{ "roles": [ "ROLE_ID" ] }'

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" ] }'

リクエストが成功すると、204 No Content レスポンスが返されます。

Manage Users

Manage Access

Enterprise Groups にロールを割り当てる

ロールの割り当て

Organization グループ

Enterprise Groups

ロールを削除

Organization グループ

Enterprise Groups

詳しくはこちら

​ロールの割り当て

​Organization グループ

​Enterprise Groups

​ロールを削除

​Organization グループ

​Enterprise Groups

​詳しくはこちら

ロールの割り当て

Organization グループ

Enterprise Groups

ロールを削除

Organization グループ

Enterprise Groups

詳しくはこちら