Skip to main content

​
エンドポイント

POST /oauth/par
Highly Regulated Identity 機能を使用するには、Enterprise Plan に Highly Regulated Identity アドオンを追加する必要があります。詳細は Auth0 Pricing を参照してください。
Pushed Authorization Requests (PAR) を使用する Authorization Code Flow では、通常 /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 属性を含める必要があります。その他の内容は自由に定義できます。

​
ヘッダー

​
string
リクエストに対する DPoP 証明です。任意項目で、アプリケーションで Demonstrating Proof-of-Possession を使用している場合にのみ必要です。

​
ボディパラメーター

​
string
各リソースに対して要求する権限です。スコープに似ています。
​
string
アクセス先の対象APIの一意の識別子です。
​
string
アクセス先の対象API (リソースサーバー) の識別子です。Auth0テナントに登録されている API Identifier と一致している必要があります。テナントのResource Parameter Compatibility Profileがcompatibilityに設定されている場合は、audienceの代わりに使用されます。
​
string
必須
codeやcode id_tokenなど、トークンの種類を指定します。必須です。
​
string
必須
アプリケーションのclient_idです。必須です。
​
string
必須
認可の付与後にAuth0がリダイレクトする先のURLです。必須です。
​
string
CSRF攻撃を防ぐために使用される不透明な値です。推奨です。
​
string
OIDCスコープとカスタムAPIスコープです。推奨です。
​
string
code_verifierから生成されるチャレンジです。推奨です。
​
string
チャレンジの生成に使用する方式で、通常はS256です。推奨です。
​
string
トークンのリプレイ攻撃を防ぐために使用します。response_type=id_tokenの場合に推奨されます。
​
string
アプリケーション用に設定されたコネクションの名前です。
​
string
prompt=consentのように、特定のプロンプトを強制するために使用します。
​
string
ユーザーの認証時に使用する組織のIDです。
​
string
proof-of-possession公開鍵のJWK Thumbprint RFC7638です。SHA-256ハッシュ関数を使用します。Demonstrating Proof-of-Possession (DPoP) を使用する場合にのみ指定します。

​
レスポンススキーマ

​
レスポンスメッセージ