JWT で保護された認可リクエスト (JAR) を設定する

アプリケーションで JWT で保護された認可リクエスト (JAR) を設定する方法を学びます。

Highly Regulated Identity 機能を使用するには、Highly Regulated Identity アドオンを含む Enterprise プランが必要です。詳しくは、Auth0 Pricingを参照してください。

JWT-Secured Authorization Requests (JAR) では、OAuth 2.0 の認可リクエストパラメーターを 1 つの JWT リクエストパラメーターにまとめ、完全性を保護するために署名できます。

​

前提条件

JAR を使用するようにアプリケーションを設定する前に、RSA キーペアを生成する必要があります。

資格情報の用途ごとに、別々のキーペアを生成してください。たとえば、JAR と Private Key JWT 認証の両方に同じキーペアを使い回さないでください。

​

アプリケーションのJARを設定する

アプリケーションのJARは、Auth0 Dashboard と Management API を使用して設定できます。

Auth0 Dashboard

Auth0 Dashboard を使用して、事前に生成した RSA キーで JAR を使用するようにアプリケーションを設定します。

1. Auth0 Dashboard > アプリケーション に移動します。

2. JAR で使用するアプリケーションを選択します。

3. Application Settings タブを選択します。

4. Authorization Requests セクションで、Require JWT-Secured Authorization Requests を有効にします。

5. 資格情報が割り当てられておらず、利用可能な資格情報がある場合は、既存の資格情報を割り当てるよう求められます。

   

6. 新しい資格情報を割り当てることもできます。

   

7. 事前に生成した RSA キーペアをアップロードして、新しい資格情報を追加し、割り当てます。求められたら、次の内容を入力します。

   • Name: 資格情報を識別するための名前
   • Public Key: PEM 形式の X.509 証明書の公開キー
   • Algorithm: JAR の署名アルゴリズムを選択
   • Expiration Date: 資格情報の有効期限を設定

Management API

Management API を使用して、signed_request_object クライアント設定プロパティでアプリケーションの JAR を設定します。このオブジェクトプロパティには、次のフィールドが含まれます。

• required: /authorize および /oauth/par へのすべての認可リクエストで JAR の使用を必須にします。詳しくは、JWT で保護された認可リクエストを使用する認可コードフロー を参照してください。
• credentials: 署名の検証に使用する資格情報 ID の配列です。

credentials パラメーターは、Private Key JWT パラメーター client_authentication_methods.private_key_jwt.credentials と同様に動作し、新しいアプリケーションの作成時に資格情報の作成をサポートします。詳しくは、Private Key JWT を設定する を参照してください。

Management API を使用すると、新しいアプリケーションまたは既存のアプリケーションに対して JAR を設定できます。

​

新しいアプリケーションに JAR を設定する

新しいアプリケーションを作成するときは、signed_request_object を含む POST リクエストを送信して JAR を設定します。その POST リクエストでは、対応するクライアント資格情報 (つまりキー PEM) も登録できます。

POST https://{yourTenant}.auth0.com/api/v2/clients
Authorization: Bearer <YOUR_ACCESS_TOKEN>
Content-Type: application/json
{
  "name": "My App using JAR",
  "signed_request_object": {
      "required": true,
"credentials": [{
        "name": "My credential for JAR",
        "credential_type": "public_key",
        "pem": "[YOUR PEM FILE CONTENT]",
        "alg": "RS256"
}]
  },
  "jwt_configuration": {
    "alg": "RS256"
  }
}

​

既存のアプリケーションに JAR を設定する

既存のアプリケーションを更新する場合は、まずクライアント資格情報を明示的に作成する必要があります。次の POST リクエストでは、PEM ファイルの内容を使用して JAR 用のクライアント資格情報を作成します。

改行が余分な書式なしで適切に JSON エンコードされていることを確認してください。

次に、クライアント資格情報を signed_request_object クライアント設定に割り当てます。次の PATCH リクエストは、クライアント資格情報を signed_request_object に関連付けます。

​

詳しくはこちら

• JWT で保護された認可リクエスト (JAR) を使用する認可コードフロー