M2M アクセス用にアプリケーションを設定する

Auth0 Dashboard と Management API を使用して、M2M アクセス用にアプリケーションを設定する方法を学びます。

Auth0 では、アプリケーションへのマシンツーマシン (M2M) アクセスを承認できます。Auth0 でアプリケーションを作成したら、マシンツーマシン アクセス用に設定します。

1. アクセスする必要がある各 API について、組織の動作を定義する。
2. アプリケーションがすべての組織ではなく特定の組織にのみアクセスする必要がある場合は、その特定の組織でアクセスする必要がある各 API に対して、マシンツーマシン アクセスを設定する。

​

組織の動作を定義する

各 API について、アプリケーションがクライアント認証情報フローで Organizations をどのように使用するかを設定できます。たとえば、アプリケーションに組織の使用を必須にするか、任意の組織へのアクセスを許可するか、または明示的に関連付けられた組織のみにアクセスを制限するかを指定できます。

次の表では、M2M アクセスにおける組織の動作を定義するための各項目について説明します。

​

組織 の動作 の定義表

項目	説明	APIマッピング
Organization Support	このアプリケーションがクライアント認証情報フローでアクセスする際に、組織をどのように使用できるかを決定します。 選択肢は次のとおりです: None: このアプリケーションは組織を使用してはいけません。これは既定値です。 Optional: このアプリケーションは組織を使用するかどうかを選択できます。 Required: このアプリケーションは組織を使用しなければなりません。	Organization Support は organization_usage に対応します。 選択肢: None は deny に対応 Optional は allow に対応 Required は required に対応
Allow machine-to-machine access to any organization	このアプリケーションがクライアント認証情報フローを使用する際に、任意の組織にアクセスできるか、または明示的に関連付けられた組織のみに制限されるかを決定します。既定では、この動作は許可されていません。 警告: 任意の組織へのマシンツーマシンアクセスを有効にすると、明示的に関連付けられていなくても、このアプリケーションは任意の組織にアクセスできるようになります。これは、信頼できる内部アプリケーションに対してのみ有効にするべきです。	Allow machine-to-machine access to any organization は allow_any_organization に対応します。 選択肢: Checked は true に対応 Unchecked は false に対応

Allow machine-to-machine access to any organization オプションは、サードパーティアプリケーションでは利用できません。サードパーティアプリケーションでは、各組織に対して明示的な 組織 クライアントグラントが常に必要です。詳細については、組織のサードパーティアプリケーションアクセスを有効にするをお読みください。

​

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

アプリケーションの 組織 の動作 を定義するには、Auth0 Dashboard または Management API を使用します。

Auth0 Dashboard

Machine-to-Machine アプリケーションの場合は、Auth0 Dashboard で 組織 の動作 を定義します。

1. Auth0 Dashboard > アプリケーション に移動し、組織 を設定するアプリケーションを選択します。
2. APIs タブを選択し、アクセスを設定する API の client_grant の詳細を展開します。
3. Define 組織 behavior table の説明に従って、適切な設定を行います。
4. Save を選択します。

Machine-to-Machine アプリケーションでない場合は、次の手順に従います。

1. Auth0 Dashboard > APIs に移動し、組織 へのアクセスを設定する API を選択します。
2. Machine-to-Machine Applications タブを選択します。このタブには、Machine-to-Machine アプリケーションだけでなく、すべてのアプリケーションが表示されます。対象のアプリケーションを見つけます。
3. アクセスを認可するには、対象のアプリケーションのトグルを選択します。次に、そのアプリケーションを選択して設定の詳細を展開します。
4. Define 組織 behavior table の説明に従って、適切な設定を行います。
5. Save を選択します。

Management API

Management API を使用して、アプリケーションの 組織 の動作 を定義することもできます。client_grant オブジェクトは、アプリケーションの API へのアクセスを制御します。アプリケーションがアクセスする必要がある API ごとに client_grant を設定する必要があります。M2M アクセス用の client_grant を設定するには、クライアントグラントを作成する または Update クライアントグラント エンドポイントを使用し、Define 組織 behavior table を参照して適切な設定を更新します。

次のコードサンプルは、M2M アクセスを持つ client_grant オブジェクトを作成します。

次のコードサンプルは、M2M アクセスを持つ client_grant オブジェクトを更新します。

​

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

一部のクライアントは、クライアント認証情報フローで非標準フィールドをサポートしていません。そのため、/oauth/token エンドポイントに必要な organization パラメーターを送信できません。こうしたクライアント向けに、none が指定され、かつ API で組織 サポートが required に設定されている場合は、アプリケーションからのすべての Client Credentials リクエストに自動的に適用されるデフォルトの組織を設定できます。

API (つまり対象の audience) で organization_usage=require の場合、デフォルトの組織が適用されます。

次の表では、machine-to-machine アクセスのデフォルトの組織を設定するための各フィールドについて説明します。

​

デフォルト組織設定表

フィールド	説明	APIマッピング
マシンツーマシンアクセスのデフォルト組織	組織を含まないClient Credentialsリクエストに適用する組織を定義します	Default Organization for Machine-to-Machine Access は、次のプロパティを持つ default_organization オブジェクトにマッピングされます。 organization_id: 使用する組織のID flows: デフォルト組織に使用する認証フロー。 この設定はUIでは非表示で、デフォルト値は ["client_credentials"] です

​

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

アプリケーションのデフォルト組織を設定するには、Auth0 Dashboard または Management API を使用します。

Auth0 Dashboard

Auth0 Dashboard でアプリケーションのデフォルト組織を有効にするには、次の手順を実行します。

1. Auth0 Dashboard > アプリケーション に移動し、設定するアプリケーションを選択します。
2. Organizations タブを選択します。
3. デフォルト組織の設定表 の説明に従って、適切な設定を行います。
4. Save を選択します。

Management API

Create a client または Update a client エンドポイントを使用して、アプリケーションのデフォルト組織を設定できます。現在サポート対象のフロー値は client_credentials のみです。

次のコードサンプルは、クライアントにデフォルト組織を設定する更新例です。