Tenant Access Control List ルールを設定する

Tenant ACL のルールは、次の要素で構成されます。

Signal: シグナルは、IP アドレス、地理位置情報、ユーザーエージェントなど、受信したリクエストから取得される識別情報です。
Condition: 条件は、演算子 (match など) と値のセット (IP アドレスのリストなど) を組み合わせたものです。
Action: Action は、条件が満たされた場合にルールが実行する動作を指定するもので、allow、block、redirect などがあります。
Scope: スコープは、そのルールが適用されるエンドポイントの範囲を示します。これには Authentication API、Management API、またはテナント全体が含まれます。
Priority: 優先順位は、そのルールが他のルールに対してどの順序で実行されるかを定義します。

これらの Tenant ACL ルールのプロパティと使用方法の詳細については、Management API Endpoint Parameter Reference を参照してください。

Tenant ACL では、一貫したルール評価ロジックを使用して、特定のリクエストに対してどの Action を適用するか、または適用しないかを判断します。ユースケースに応じたきめ細かなアクセス制御ポリシーを作成するため、優先順位は慎重に設定してください。

ルールの作成と削除

以下のManagement APIエンドポイントを使用して、Tenant ACLルールを作成および削除できます。指定のスコープを持つManagement API アクセストークンが必要です。

操作	エンドポイント	必要なスコープ
ルールを作成	アクセス制御リストを作成	`create:network_acls`
ルールを削除	アクセス制御リストを削除	`delete:network_acls`

以下の Management API エンドポイントを使用して、Tenant ACL ルールを変更できます。指定のスコープを持つ Management API アクセストークンが必要です。

Action	Endpoint	Required scope
ルールを更新する	アクセス制御リストを部分更新	`update:network_acls`
ルールを上書きする	アクセス制御リストを更新	`update:network_acls`

Management API の Update アクセス制御リストエンドポイントを使用すると、ルールを有効または無効にできます。rule オブジェクトの active プロパティを、それぞれ true または false に設定します。

以下のManagement API エンドポイントを使用して、既存のTenant ACLルールを確認できます。必要なスコープが付与されたManagement API アクセストークンが必要です。

Action	Endpoint	Required スコープ
ルールを表示	テナントの特定のアクセス制御リストエントリを取得	`read:network_acls`
すべてのルールを表示	テナントのすべてのアクセス制御リストエントリを取得	`read:network_acls`

既存のルール一覧を表示するには、Auth0 Dashboard > Security > Access Control に移動します。