メンバーを組織に割り当てる

Auth0 DashboardまたはManagement APIを使ってメンバーを組織に直接割り当てる方法について説明します。

組織にメンバーを割り当てるには、先にテナント内にユーザーを作成しておく必要があります。ユーザーが見つからない場合には、代わりにユーザーを招待することもできます。

メンバーを直接管理するには、Auth0 DashboardまたはManagement APIを使用することができます。

​

Auth0 Dashboard

Auth0 Dashboardでメンバーを割り当てるには、以下を行います。

1. ［Auth0 Dashboard］>［Organization］に移動して、メンバーシップを構成したい組織を選択します。
2. ［Members（メンバー）］ ビューを選び、［Add members（メンバーの追加）、［Add Users（ユーザーの追加）］ の順に選択します。
3. メンバーとして組織に割り当てたいユーザーの名前を入力して、［Add user(s) to organization（ユーザーを組織に追加）］ を選択します。

​

Management API

Management APIでメンバーを割り当てるには、以下を行います。

Create Organization MembersエンドポイントにPOST呼び出しを行います。必ず、ORG_ID、MGMT_API_ACCESS_TOKEN、およびUSER_IDのプレースホルダーの値を、それぞれ組織ID、Management APIのアクセストークン、ユーザーIDに置き換えます。

cURL

curl --request POST \
  --url https://your_auth0_domain/api/v2/organizations/ORG_ID/members \
  --header 'authorization: Bearer MGMT_API_ACCESS_TOKEN' \
  --header 'cache-control: no-cache' \
  --header 'content-type: application/json' \
  --data '{ "members": [ "USER_ID", "USER_ID", "USER_ID" ] }'

Auth0ドメインを見つける

テナント名がAuth0ドメインである場合は、地域のサブドメイン（テナントが米国地域にあり、2020年6月より前に作成された場合を除く）の後に「.auth0.com」が続きます。たとえば、テナント名が「travel0」の場合、Auth0のドメイン名は「travel0.us.auth0.com」になります。（テナントが米国内にあって、2020年6月よりも前に作成された場合、ドメイン名は「https://travel0.auth0.com」になります。）

カスタムドメインを使用している場合には、これがカスタムドメイン名になります。

値	説明
ORG_ID	メンバーシップを割り当てたい組織のID。
MGMT_API_ACCESS_TOKEN	create:organization_membersのスコープを持つManagement APIのアクセストークン。
USER_ID	指定された組織に割り当てたいユーザーのID。送信できるメンバーの数は各要求で組織ごとに最大10までです。

​

応答ステータスコード

可能性のある応答ステータスコードは以下のとおりです。

ステータスコード	エラーコード	メッセージ	原因
204		Members successfully added to organization（メンバーが組織に追加されました）
400	invalid_body	Invalid request body（無効な要求本文です）メッセージは、原因によって異なります。	要求ペイロードが有効ではありません。
400	invalid_query_string	Invalid request query string（無効な要求クエリ文字列です）メッセージは、原因によって異なります。	クエリ文字列が有効ではありません。
401		Invalid token（無効なトークンです）
401		Invalid signature received for JSON Web Token validation（JSON Webトークン検証に無効な署名を受け取りました）
401		Client is not global（クライアントがグローバルでありません）
403	insufficient_scope	Insufficient scope; expected any of（スコープ不足。次のいずれかを想定します）： create:organization_members.	提供されたベアラートークンスコープで許可されていないフィールドのread/writeを試みました。
429		Too many requests（要求が多すぎます）X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Resetヘッダーを確認してください。