ロールの作成

Auth0 Dashboard または Management API を使用してロールを作成する方法を説明します。

Auth0 Dashboard または Management API を使用して、ロールを作成できます。ロールは API Authorization Core の機能セットと連携して機能します。

Auth0 では、2 種類のロールを作成できます。

• テナントロール: テナント全体に適用され、任意のユーザーに割り当てることができます。
• 組織 ロール: 特定の 組織 にスコープが設定されます。ユーザーは、所属する 組織 ごとに異なる 組織 ロールを持つことができます。詳細については、組織 Rolesを参照してください。

​

前提条件

• ロールベースのアクセス制御 (RBAC) を正しく機能させるには、Auth0 Dashboard または Management API を使用して、API で RBAC を有効にする必要があります。Authorization Core の機能は Authorization Extension とは異なります。比較については、Authorization Core と Authorization Extension の比較をご覧ください。
• Auth0 Dashboard で API を設定 します。
• 権限は事前定義された値から取得されます。権限の一覧が空の場合は、API に権限を追加する必要があります。

​

テナント ロールを作成する

テナント ロールは テナント 全体に適用され、組織のメンバーシップにかかわらず、任意のユーザーに割り当てることができます。

Auth0 Dashboard

1. Dashboard > User Management > Rolesに移動し、ロールの作成を選択します。
2. ロールに名前を付け、説明を追加してから、Createを選択します。

Management API

ロールの作成エンドポイントにPOST呼び出しを行います。MGMT_API_ACCESS_TOKEN、ROLE_NAME、ROLE_DESCのプレースホルダー値は、それぞれManagement APIのアクセストークン、ロール名、ロールの説明に必ず置き換えてください。

値	説明
MGMT_API_ACCESS_TOKEN	Management API 用アクセストークン (scope: create:roles) 。
ROLE_NAME	作成するroleの名前。
ROLE_DESC	roleのわかりやすい説明。

​

組織ロールを作成する

組織ロールは、組織の管理画面から作成します。テナント管理者は、組織ごとに最大350個の組織ロールを作成できます。

Auth0 Dashboard

1. Auth0 Dashboard > 組織に移動し、組織を選択します。
2. ロールタブを選択し、ロールの作成を選択します。
3. ロール名と説明を入力し、Createを選択します。

Management API

Create Role endpointにPOSTリクエストを送信します。typeを"organization"に設定し、owner_idに組織IDを設定します。MGMT_API_ACCESS_TOKEN、ROLE_NAME、ROLE_DESC、ORG_IDのプレースホルダー値は、それぞれManagement APIのアクセストークン、ロール名、ロールの説明、組織IDに必ず置き換えてください。

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

値	説明
MGMT_API_ACCESS_TOKEN	スコープcreate:rolesを持つManagement API用アクセストークン。
ROLE_NAME	作成する組織ロールの名前。組織内で一意である必要があります。
ROLE_DESC	ロールのわかりやすい説明。
ORG_ID	ロールを作成する組織のID。

レスポンスには、ロールがorganizationにスコープされていることを示すtype: "organization"とowner_idが含まれます。

​

詳しくはこちら

• ロールに権限を追加する
• ロールから権限を削除する
• ユーザーにロールを割り当てる
• ロールを削除する