Edge Security Acceleration:API トークンコンプライアンス検証

API トークンルールを構成する

1. ESA コンソールで、サイト管理 に移動します。サイト 列で、対象のウェブサイトをクリックします。

2. 左側のナビゲーションウィンドウで、セキュリティ保護 > [API セキュリティ] に移動します。

3. [API セキュリティ] ページで、[API ルール] タブをクリックし、次に [トークン構成] をクリックします。

4. [追加] をクリックしてトークン構成を追加します。

5. 必要に応じてトークンパラメーターを構成し、[OK] をクリックします。

   • 名前: トークンのカスタム名 (例: JWT-Demo) を入力します。

   • トークンの場所: リクエスト内のトークンの場所を選択します。[ヘッダー] または [Cookie] を選択し、キーを入力します。

     説明

     異なる場所でトークンをチェックするには、[または] をクリックして論理的な OR 条件を作成できます。同時に最大 4 つのトークンの場所をチェックできます。

   • トークンキー: トークンキーを手動で入力するか、JSON ファイルをアップロードします。キーの要件の詳細については、「トークンの詳細」をご参照ください。

     説明

     複数のキーを構成する場合、ESA は kid フィールドを使用して検証用のキーを選択します。いずれかのキーで検証された場合、リクエストは有効と見なされます。

   

6. トークンを構成した後、API ルールを作成します。[API ルール] タブに戻り、[ルールの追加] をクリックします。

7. 必要に応じてトークン検証パラメーターを構成します。

   • ルール名: ルール名 (例: rule-jwt-demo) を入力します。

   • API の検証: ドロップダウンリストから、検証する API をホストするホスト名を選択します。ESA はそのホスト名の下にある管理対象 API のリストを自動的に表示します。リストから対象の API を選択します。

   • トークン構成の選択: 検証するトークンを 1 つ以上選択します。複数のトークンを選択する場合は、次のいずれかのオプションを選択します。

     • 少なくとも 1 つを検証: リクエストは、選択されたトークン構成の少なくとも 1 つに一致する必要があります。そうでない場合、リクエストは非準拠としてマークされます。

     • すべてを検証: リクエストは、選択されたすべてのトークン構成に一致する必要があります。そうでない場合、リクエストは非準拠としてマークされます。

       説明

       デフォルトでは、トークンがない場合、リクエストは非準拠としてマークされます。この動作を変更するには、[トークンがない場合] 列のドロップダウンリストから [無視] を選択できます。

   • アクション: トークン検証に失敗したリクエストのアクションを選択します。

     • 監視: 非準拠のリクエストを許可し、ログを記録します。詳細については、「イベント」をご参照ください。

     • ブロック: 非準拠のリクエストをブロックし、ブロックログを記録します。詳細については、「イベント」をご参照ください。

   

結果の検証

API ルールを作成した後、左側のナビゲーションウィンドウで セキュリティ保護 > イベント分析 を選択します。[イベント] ページで、フィルターを使用して保護ルールを [API ルール] に設定します。下にスクロールして、サンプリングログ セクションで詳細な緩和ログを表示します。

トークンの詳細

トークン検証は現在、JWT でのみ利用可能です。

{
  "kty": "EC",
  "use": "sig",
  "crv": "P-256",
  "kid": "esa",
  "x": "QG3VFVwUX4IatQvBy7sqBvvmticCZ-eX5-nbtGKBOfI",
  "y": "A3PXCshn7XcG7Ivvd2K_DerW4LHAlIVKdqhrUnczTD0",
  "alg": "ES256"
}

よくある質問

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWV9.TJVA95OrM7E2cBab30RMHrHDcEfxjoYZgeFONFh7HgQ