組織の接続を有効にする

Auth0 DashboardとManagement APIを使用して組織の接続を有効にする方法を説明します。

組織のそれぞれに特定の接続を有効化すると、ユーザーに異なるログインオプションを提供できるようになります。有効にした接続は組織のログインプロンプトに追加され、ユーザーがその接続を使ってアプリケーションにアクセスできるようになります。

組織に接続を有効にするには、テナントにその接続がなくてはなりません 。サポートされている接続にはデータベース接続、ソーシャル接続やエンタープライズ接続が含まれます。

​

組織のプロパティ

組織を使う場合、接続によっては以下のようなプロパティを追加で構成することができます。

プロパティ	接続の種類	説明
Membership On Authentication（認証時のメンバーシップ）	全種類の接続	有効にすると、指定の接続を使用した初回の認証でエンドユーザーに組織のメンバーシップを自動的に割り当てます。 これは、その接続で認証可能なすべてのユーザーが組織のメンバーになる場合に便利です。
Organization Signup（組織のサインアップ）	データベース接続のみ	エンドユーザーがログインプロンプトでサインアップリンクを使用して、組織のメンバーシップも獲得できるかを決定します。これ使用するには、［Membership On Authentication（認証時のメンバーシップ）］も有効にする必要があります。 以下のように、ユーザーの自主的な組織への参加が必要な場合に使用します。 ワークスペースなど、組織が自由参加のユーザー集団をモデルにしている B2B2C（ビジネス対ビジネス対消費者）のユースケースで、ユーザーが自由にアカウントにサインアップできる
Display connection as a button（接続をボタンとして表示する）	エンタープライズ接続のみ	この任意のプロパティは、組織のログインプロンプトで特定の接続をオプションとして表示するかを決定します。 注意：このオプションが接続に無効な場合でも、接続パラメーターを認可要求に含めて直接送信すると、エンドユーザーはその接続で認証し、組織のアプリケーションにログインできます。また、ホーム領域検出を使用したIdentifier First認証プロファイルを［Prompt for Credentials（資格情報を求める）］組織ログインフローと組み合わせて使っている場合も、ユーザーはその接続で認証できます。

エンドユーザーは特定の組織に関連したアプリケーションにのみ、その組織に有効な接続を使ってログインできます。

​

組織の接続を構成する

組織の接続はAuth0 DashboardまたはManagement APIを使って構成することができます。

Auth0 Dashboard

​

Auth0 Dashboard

Auth0 Dashboardを使って接続を有効にするには以下を行います。

1. ［Auth0 Dashboard］ > ［Organizations］に移動して、接続を構成したいOrganizationを選択します。

2. ［Connections（接続）］ ビューを選択してから、［Enable Connections（接続の有効化）］ を選択します。

3. 有効にしたい接続を選んで、［Enable Connection（接続の有効化）］ を選択します。

4. ［Authentication（認証）］セクションの ［Membership On Authentication（認証時のメンバーシップ）］］、メンバーシップの自動付与を有効または無効に設定します。有効にすると、その接続を使ってログインするユーザーがすべてOrganizationのメンバーとして自動的に追加されます。

5. データベース接続のみ：［Organization Signup（Organizationのサインアップ）］セクションで、ユーザーの自主的なサインアップを有効または無効に設定します。有効にすると、ユーザーはログインプロンプトのサインアップリンクを使って自分のアカウントを作成し、自動的にOrganizationのメンバーシップを取得できるようになります。

   • 注：これを有効にするには、まず ［Membership on Authentication（認証時のメンバーシップ）］ を有効にする必要があります。

6. エンタープライズ接続のみ：その接続がOrganizationのログインプロンプトでオプションとして表示されるように、接続ボタンセクションで任意の ［Display connection as a button（接続をボタンで表示）］ プロパティを有効に設定します。

   Organization内の有効な接続がすべてエンタープライズ接続で、すべての接続が非表示の場合、ユーザーがアプリケーションにアクセスすると、Auth0から「Message: no connections enabled for the organization are visible（メッセージ：組織に対して有効化された接続はすべて非表示です）」というエラーが返されます。

7. ［Save（保存）］ を選択します。

Management API

​

Management API

Management APIを使って接続を有効にするには以下を行います。

Create Organization ConnectionsエンドポイントにPOST呼び出しを行います。必ず、以下のプレースホルダーの値を適切な情報で更新してください。

• {orgId}をOrganization IDに置き換えます。
• {mgmtApiAccessToken}をManagement APIのアクセストークンに置き換えます。
• {connectionId}を特定の接続IDに置き換えます。
• ［Membership on Authentication（認証時のメンバーシップ）］の設定に合わせて、{assignMembershipOption}をtrueまたはfalseに置き換えます。
• データベース接続のみ ：サインアップの設定に合わせて、{isSignupEnabled}をtrueまたはfalseに置き換えます。
• エンタープライズ接続のみ ：接続ボタンの設定に合わせて、{showAsButtonOption}をtrueまたはfalseに置き換えます。

Auth0ドメインを見つける

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

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

値	説明
{orgId}	接続を有効にしたい組織のID。
{mgmtApiAccessToken}	create:organization_connectionsのスコープを持つ［Management APIアクセストークン］（/tokens/management-api-access-tokens）
{connectionId}	特定の組織に有効化したい接続のID。
{assignMembershipOption}	この接続を使ってログインするユーザーに対して、組織のメンバーシップを自動的に付与したいかを指定する。trueに設定すると、ユーザーに対して自動的にメンバーシップが付与されます。falseに設定すると、メンバーシップは自動的に付与されません。
{isSignupEnabled}	ユーザーがログインプロンプトでセルフサービスのサインアップリンクにアクセスできるかどうかを指定します。trueに設定すると、プロンプトにサインアップリンクが表示されます。falseに設定すると、リンクは表示されません。 注：このオプションを有効にするには、{assignMembershipOption}もtrueに設定する必要があります。
{showAsButtonOption}	組織のログインプロンプトに特定のエンタープライズ接続をオプションとして表示したいかを指定します。trueに設定すると、プロンプトに接続がボタンとして表示されます。falseに設定すると、プロンプトに接続は表示されません。

応答ステータスコード

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

ステータス コード	エラーコード	メッセージ	原因
201		接続が組織に正常に追加されました。
401		無効なトークンです。
401		JSON Web Tokenの検証に無効な署名を受信しました。
401		クライアントがグローバルではありません。
403	insufficient_scope	スコープが不足しています。create:organizations_connectionsのいずれかが予期されています。	提供されたベアラートークンのスコープでは許可されないフィールドの読み込み/書き込みが試行された。
429		要求が多すぎます。X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Resetヘッダーを確認してください。