エンドポイント
POST /oauth/par
Highly Regulated Identity 機能を使用するには、Enterprise Plan に Highly Regulated Identity アドオンを追加する必要があります。詳細は Auth0 Pricing を参照してください。
/authorize への GET リクエストで送信する認可パラメーターを、アプリケーションから /oauth/par エンドポイントに送信できます。PAR では、パラメーター値の安全性を確保するために、バックエンドから POST メソッドを使用します。/oauth/par エンドポイントでは、/authorize に指定可能なすべての認可パラメーターを受け付けます。/oauth/par エンドポイントへの呼び出しが有効な場合、Auth0 は /authorize エンドポイントのパラメーターとして使用できる redirect_uri 値を返します。
/oauth/par エンドポイントへの呼び出しが有効な場合、Auth0 は /authorize エンドポイントのパラメーターとしても使用される redirect_uri 値を返します。PAR の設定について詳しくは、Configure Pushed Authorization Requests (PAR) を参照してください。
注記
- PARエンドポイントを呼び出すには、以下が必要です。
- リクエストのコンテンツタイプを
application/x-www-form-urlencodedに設定する - 渡すすべてのパラメータに
stringを使用する - リクエストに、アプリケーション認証用の追加パラメータを含める (例:
client_secret、または JSON Web Token Client Authentication の場合はclient_assertionとclient_assertion_type、あるいは Mutual TLS を使用する場合はclient-certificateとclient-certificate-ca-verifiedヘッダーを渡す) 。
- リクエストのコンテンツタイプを
- 各リソースに対するアクセス許可をリクエストするには、
authorization_detailsパラメータを使用します。たとえば、認可に関する詳細な情報を伝えるために、JSONオブジェクトの配列を指定できます。各JSONオブジェクトにはtype属性を含める必要があります。その他の内容は自由に定義できます。
ヘッダー
ボディパラメーター
アクセス先の対象API (リソースサーバー) の識別子です。Auth0テナントに登録されている API Identifier と一致している必要があります。テナントのResource Parameter Compatibility Profileが
compatibilityに設定されている場合は、audienceの代わりに使用されます。proof-of-possession公開鍵のJWK Thumbprint RFC7638です。SHA-256ハッシュ関数を使用します。Demonstrating Proof-of-Possession (DPoP) を使用する場合にのみ指定します。