Skip to main content
API は外部リソースを表すエンティティであり、アプリケーションから送信される保護されたリソースへのリクエストを受け取り、それに応答できます。OAuth2 specification では、API は に相当します。

API へのアクセスを認可する

カスタム API では、いずれユーザーに代わって保護されたリソースへの限定的なアクセスを許可する必要が生じます。認可とは、ユーザーが何にアクセスできるかを検証するプロセスを指します。認証 と同じ意味で使われることもありますが、認可は本質的に異なる機能です。詳しくは、認証および認可 を参照してください。 認可では、API が付与すべき権限の範囲を判断したうえで、ユーザーまたはアプリケーションに API へのアクセス権が与えられます。通常、認可は認証によってアイデンティティが正常に検証された後に行われます。これにより API は、どの程度のアクセスを付与すべきかを判断できます。

アクセス制御による認可の決定

認可は、policies や ルール を使って決定できます。これらは role-based access control (RBAC) と組み合わせて利用することも可能です。RBAC を使用するかどうかにかかわらず、要求されたアクセスはスコープを通じて API に送信され、付与されたアクセスは発行された で返されます。 その後、アプリケーションはアクセストークンを使用して API の保護されたリソースにアクセスできます。同じアクセストークンは、有効期限が切れるまで、再度認証しなくても API リソースへのアクセスに使用できます。

APIの権限

想定されるすべての操作を把握できるのはAPIだけであるため、APIは独自の権限を定義する内部的なアクセス制御システムを備える必要があります。呼び出し元アプリケーションの実効権限を判断するには、APIは受信したスコープと、自身の内部アクセス制御システム内で割り当てられた権限を組み合わせ、それに基づいてアクセス制御の判断を行う必要があります。

API を設定する

API を保護するには、 で API を登録する必要があります。詳しくは、API を登録する を参照してください。
Auth0 Dashboard で API を登録する前でも、すでに 1 つの API が用意されています。それが Auth0 Management API です。Management API の機能と利用可能なエンドポイントの詳細については、Management API を参照してください。

API を登録する

Auth0 Dashboard で API を登録する方法を学びます。

API 設定

Auth0 Dashboard で利用できる API に関連する設定について説明します。

アプリケーション向け API アクセスポリシー

ユーザー委任フローと Client Credential フローの両方で、すべて許可、アプリごとの認可、またはすべて拒否のポリシーを使用して、API にアクセスできるアプリケーションを制御します。

API の権限を追加する

Auth0 Dashboard または Management API を使用して、API に権限を追加する方法について説明します。

API の権限を削除

Auth0 Dashboard または Management API を使用して、API から権限を削除する方法を説明します。

アクセストークンプロファイルを設定する

API のアクセストークンプロファイルを設定して、発行されるアクセストークンの形式とクレームを制御します。

JSON Web Encryption(JWE)を設定する

JSON Web Encryption(JWE)を使用してアクセストークンのペイロードを暗号化し、中継者による閲覧やデータ侵害時の漏えいから機密性の高いクレームを保護します。

複数の API 向けの論理 API を設定する

Auth0 で単一の論理 API を使って複数の API へのアクセスを表現し、管理する方法を学びます。

Rich Authorization Requests (RAR) を設定する

リソースサーバー向けに Rich Authorization Requests (RAR) を設定する方法を学びます。

テスト用の マシンツーマシン アプリケーションを作成する

アクセストークンを使用して Management API エンドポイントを呼び出すための、テスト用の マシンツーマシンアプリケーションを登録して認可する方法を説明します。

API でロールベースのアクセス制御を有効にする

Auth0 Dashboard または Management API を使用して、API でロールベースのアクセス制御(RBAC)を有効にする方法について説明します。