API 設定

許可されたアプリケーションから利用する登録済み API を設定するには、Dashboard > Applications > APIs にあるの設定タブを使用します。API の設定を行うには、一覧で対象の API の横にある … をクリックして設定を選択するか、API 名をクリックします。API の作成と登録の方法については、API を登録するを参照してください。

設定

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

一般設定

これらのフィールドは、Auth0 のを除き、API を最初に登録したときに設定されたものです。変更できるのは Name のみです。

Dashboard Applications APIs Settings Tab General Settings

Id: Auth0 によって生成される一意の英数字の文字列です。この情報は読み取り専用で、Auth0’s Management API Resource Servers endpoints を直接操作する場合にのみ必要です。
Name: API のフレンドリー名です。機能には影響しません。次の文字は使用できません: < >。
Identifier: API の一意の識別子です。この値は API の作成時に設定され、その後は変更できません。URL の使用を推奨しますが、公開された URL である必要はありません。Auth0 が API を呼び出すことはありません。

トークン設定

Dashboard - API - Token Settings - Expiration

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

RBAC 設定

RBAC を有効にする: この設定を有効にすると、API に RBAC ポリシーが適用されます。詳しくは、ロールベースのアクセス制御と API でロールベースのアクセス制御を有効にするを参照してください。
アクセストークンに Permissions を追加する: この設定を有効にすると、Permissions claim がアクセストークンに追加されます。この設定は、RBAC を有効にした場合にのみ利用できます。権限は Permissions タブで設定できます。

アクセス設定

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

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

My Account API の認証保証は現在、単一オプションのポリシーによる早期アクセスとして提供されています。この機能を使用することで、お客様は Okta の Master Subscription Agreement に定める該当する Free Trial 条項に同意したものとみなされます。Auth0 の製品リリースサイクルの詳細については、Product Release Stages をご覧ください。プログラムに参加するには、Auth0 Support にお問い合わせください。

2FA を必須にする: 有効にすると、Auth0 は My Account API にデフォルトポリシーを適用し、ステップアップ認証をトリガーします。ユーザーは 15 分以内に第 2 の認証要素で認証する必要があります。動作の詳細と有効化の方法については、My Account API: デフォルトポリシーを参照してください。

デフォルトポリシーはクラシックログインでは利用できません。

権限

Permissions タブの設定を使って、この API で使用する権限 (スコープ) を定義します。詳しくは、API の権限を追加すると API の権限を削除するをご覧ください。

Machine-to-Machine アプリケーション

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

テスト

API をテストできるように、Auth0 によってテスト用のアプリケーションが自動的に作成されます。Management API のテスト用に Machine-to-Machine アプリケーションをさらに作成する方法については、テスト用の Machine-to-Machine アプリケーションを作成するを参照してください。

Management API Explorer

Auth0 Management API の設定を開くと、API Explorer という追加のタブが表示されます。

Quickstarts

Auth0 の概要

Auth0 を設定する

アプリケーション

設定