メインコンテンツへスキップ
アプリケーションを作成したら、次の手順に従ってマシンツーマシンアクセス用に設定します。
  1. アクセスが必要な各 API について、組織の動作を定義します。
  2. アプリケーションがすべての組織ではなく特定の組織にのみアクセスする必要がある場合は、それらの特定の組織でアクセスが必要な各 API に対して、M2M アクセスを承認します。

組織の動作を定義する

各 API について、Client Credentials フローでアプリケーションが組織をどのように使用するかを設定できます。たとえば、アプリケーションに組織の使用を必須とするか、任意の組織へのアクセスを許可するか、または明示的に関連付けられた組織のみにアクセスを許可するかを指定できます。 次の表では、M2M アクセスにおける組織の動作を定義するためのフィールドについて説明します。

組織の動作を定義する表

フィールド説明API マッピング
組織のサポートこのアプリケーションが Client Credentials フロー でアクセスする際に、組織をどのように使用できるかを決定します。

オプションは次のとおりです。
  • なし: アプリケーションは組織を使用できません。これはデフォルト値です。
  • 任意: アプリケーションは組織を使用するかどうかを選択できます
  • 必須: アプリケーションは組織を使用する必要があります
組織のサポートは organization_usage にマッピングされます。

オプション:
  • なしdeny にマッピングされます
  • 任意allow にマッピングされます
  • 必須required にマッピングされます
任意の組織へのマシンツーマシンアクセスを許可このアプリケーションが Client Credentials フロー を使用する際に、任意の組織にアクセスできるか、または明示的に関連付けられた組織のセットのみに制限されるかを決定します。デフォルトでは、この動作は許可されていません。

警告: 任意の組織へのマシンツーマシンアクセスを有効にすると、明示的に関連付けられていない場合でも、アプリケーションが任意の組織にアクセスできるようになります。信頼できる内部アプリケーションでのみ有効にしてください。
任意の組織へのマシンツーマシンアクセスを許可 は allow_any_organization にマッピングされます。

オプション:
  • チェックあり は true にマッピングされます
  • チェックなし は false にマッピングされます

アプリケーションの組織の動作を設定する

アプリケーションの組織の動作を設定するには、Auth0 Dashboard または Management API を使用します。
マシン間アプリケーションの場合は、Auth0 Dashboard で組織の動作を設定します。
  1. Auth0 Dashboard > Applications に移動し、組織を設定するアプリケーションを選択します。
  2. APIs タブに切り替え、アクセスを設定する API の client_grant の詳細を展開します。
  3. 組織の動作を定義する表 の説明に従って、適切な設定を行います。
  4. Save を選択します。
また、マシン間アプリケーションではない場合は、次の手順に従います。
  1. Auth0 Dashboard > APIs に移動し、組織へのアクセスを設定する API を選択します。
  2. Machine To Machine Applications タブに切り替えます。ここには、マシン間アプリケーションだけでなく、すべてのアプリケーションが表示されます。対象のアプリケーションを見つけます。
  3. アクセスを認可するには、対象のアプリケーションのトグルをクリックします。次に、そのアプリケーションをクリックして設定の詳細を展開します。
  4. 組織の動作を定義する表 の説明に従って、適切な設定を行います。
  5. Save を選択します。

デフォルト組織を設定する

一部のクライアントは、Client Credentials フローの非標準フィールドをサポートしていません。そのため、/oauth/token エンドポイントに必要な organization パラメーターを送信できません。こうしたクライアントでは、none が指定され、API で組織のサポートが required に設定されている場合、アプリケーションからの Client Credentials リクエストに自動的に適用されるデフォルト組織を設定できます。
デフォルト組織は、API (つまり対象のオーディエンス) で organization_usage=require が設定されている場合に適用されます。
次の表では、マシンツーマシンアクセス用のデフォルト組織を設定するフィールドについて説明します。

デフォルト組織の設定テーブル

FieldDescriptionAPI Mapping
マシンツーマシンアクセスのデフォルト組織組織が含まれていないクライアントクレデンシャルリクエストに適用する組織を定義しますマシンツーマシンアクセスのデフォルト組織は、次のプロパティを持つ default_organization オブジェクトにマッピングされます。
  • organization_id: 使用する組織の ID
  • flows: デフォルト組織に使用する認証フロー。

    この設定は UI では非表示で、デフォルト値は ["client_credentials"] です

アプリケーションのデフォルト組織を設定する

アプリケーションのデフォルト組織を設定するには、Auth0 Dashboard または Management API を使用します。
Auth0 Dashboard でアプリケーションのデフォルト組織を有効にするには、次の手順に従います。
  1. Auth0 Dashboard > Applications に移動し、設定対象のアプリケーションを選択します。
  2. 組織 タブを選択します。
  3. デフォルト組織の設定表 の説明に従って、適切な設定を行います。
  4. Save をクリックします。