メインコンテンツへスキップ
認可済みアプリケーションから利用する登録済み API を設定するには、Dashboard > Applications > APIs にある Settings タブを使用します。API の設定を構成するには、一覧内の API の横にある をクリックして Settings を選択するか、API 名をクリックします。API を作成して登録する方法については、API を登録する を参照してください。
Dashboard の Applications API 一覧

設定

このタブでは、トークンの有効期限、ロールベースアクセス制御 (RBAC) 、その他のアクセス設定を構成できます。変更を保存するには、タブの下部にある Save をクリックします。

一般設定

これらのフィールドは、Auth0 の の場合を除き、API を最初に登録した際に設定されるものです。変更できるのは 名前 のみです。
Dashboard アプリケーション API 設定タブ 一般設定
  • Id: Auth0 によって生成される一意の英数字文字列です。この情報は読み取り専用で、Auth0 の Management API のリソースサーバー endpoint を直接操作する場合にのみ必要です。
  • 名前: API のわかりやすい名前です。機能には影響しません。次の文字は使用できません: < >
  • 識別子: API の一意の識別子です。この値は API の作成時に設定され、その後は変更できません。URL を使用することを推奨しますが、公開されている URL である必要はありません。Auth0 が API を呼び出すことは一切ありません。

トークン設定

Dashboard - API - Token Settings - Expiration
  • 最大有効期間 (秒) : アクセストークンの有効期限が切れるまでの時間 (秒数) です。デフォルト値は 86400 秒 (24 時間) です。設定可能な最大値は 2592000 秒 (30 日) です。
  • Implicit / Hybrid Flow アクセストークン有効期間 (秒) : Implicit Flow または Hybrid Flow で発行されたアクセストークンの有効期限が切れるまでの時間 (秒数) です。デフォルト値は 86400 秒 (24 時間) です。この値は、アクセストークンの最大有効期間を超えることはできません。
  • (JWT) プロファイル: このプロファイルは、API 用に発行されるアクセストークンの形式を決定します。使用できる値は Auth0RFC 9068 です。詳しくは、アクセストークンプロファイルをご覧ください。
  • JSON Web Token (JWT) : トークンの署名に使用するアルゴリズムです。この署名は、JWT の送信者が名乗っている本人であることを検証し、メッセージが途中で変更されていないことを保証するために使用されます。使用できる値は HS256RS256 です。RS256 (推奨) を選択すると、トークンはテナントの秘密鍵で署名されます。この値は API の作成時に設定され、その後は変更できません。署名アルゴリズムと Auth0 での動作について詳しくは、署名アルゴリズムをご覧ください。
    署名は JWT の一部です。JWT の構造に不慣れな場合は、JSON Web Token Structureをご覧ください。
  • JSON Web Encryption (JWE): 有効にすると、発行されるアクセストークンは JSON Web Encryption (JWE) 形式で暗号化されます。詳しくは、JSON Web Encryptionをご覧ください。

RBAC 設定

Auth0 Dashboard API 設定の RBAC トグル

アクセス設定

Dashboard Applications APIs Settings Tab Access Settings
  • ユーザーの同意のスキップを許可: この設定を有効にすると、「ファーストパーティ」として指定されたアプリケーションでは、API のユーザー同意をスキップできます。
  • オフラインアクセスを許可: この設定を有効にすると、アプリケーションが API に対して を要求できるようになります。

デフォルトポリシーの設定

My Account API の認証保証は現在、単一オプションのポリシーで 早期アクセスとして提供されています。この機能を使用すると、Okta の Master Subscription Agreement に定められた該当する Free Trial 条項に同意したものとみなされます。Auth0 の製品リリースサイクルの詳細については、Product Release Stagesを参照してください。プログラムに参加するには、Auth0 Support までお問い合わせください。
デフォルトポリシー API 設定
  • 2FA を必須にする: 有効にすると、Auth0 は My Account API にデフォルトポリシーを適用し、ステップアップ認証を要求します。ユーザーは 15 分以内に第 2 の認証要素で認証する必要があります。動作の詳細と有効化の手順については、My Account API: Default Policyを参照してください。
デフォルトポリシーは Classic Login では利用できません。

Permissions

API で使用する権限 (スコープ) を定義するには、Permissions タブの設定を使用します。詳細については、Add API Permissions および Delete API Permissions を参照してください。
Dashboard で API Permissions を追加するための API 権限定義画面

マシン間アプリケーション

マシン間アプリケーションがある場合は、このタブの一覧に表示されます。一覧内のアプリケーションを認可するには、トグルを使用します。詳しくは、マシン間アプリケーションを登録するを参照してください。
Dashboard アプリケーション API マシン間アプリケーション

テスト

API をテストできるように、Auth0 によってテスト用アプリケーションが自動的に作成されます。Management API のテスト用に追加のマシン間アプリケーションを作成する方法については、テスト用のマシン間アプリケーションを作成するを参照してください。
Dashboard の Applications APIs Test タブ

Management API Explorer

Auth0 Management API の Settings を開くと、API Explorer という追加のタブが表示されます。
Dashboard Applications APIs Management API Explorer
トラブルシューティングについては、API 呼び出しを確認する を参照してください。

詳しくはこちら