すべてのプロダクト
Search
ドキュメントセンター

Microservices Engine:ヘッダー設定ポリシーの構成

最終更新日:Jan 08, 2025

ヘッダー設定ポリシーを構成して、リクエストまたはレスポンスのヘッダーを、リクエストが宛先のバックエンドサービスに転送される前、またはバックエンドサービスのレスポンスがクライアントに返される前に変更できます。このトピックでは、クラウドネイティブゲートウェイのヘッダー設定ポリシーを構成する方法について説明します。

ヘッダー設定ポリシーの構成

  1. MSE コンソール にログインします。トップナビゲーションバーで、リージョンを選択します。

  2. 左側のナビゲーションペインで、Cloud-Native Gateway > ゲートウェイリスト を選択します。[ゲートウェイ] ページで、ゲートウェイの名前をクリックします。

  3. 左側のナビゲーションペインで、Routes をクリックし、[ルート] タブをクリックします。

  4. 変更するルーティングルールを見つけ、Actions 列の Policies をクリックします。

  5. Policies タブの左側のナビゲーションペインで、Headers をクリックします。[ヘッダーの編集] タブで、编辑图案 または右側の Add Rule をクリックします。

  6. パラメーターを構成し、右上隅にある Save をクリックします。

    パラメーター

    説明

    Header Type

    ヘッダータイプ。

    • Request: ヘッダー設定ポリシーはリクエストに適用されます。

    • Response: ヘッダー設定ポリシーはレスポンスに適用されます。

    Action Type

    リクエストまたはレスポンスに対して実行できるヘッダー関連の操作。

    • Add: リクエストまたはレスポンスにヘッダーを追加します。

      説明

      指定されたヘッダーがリクエストまたはレスポンスに既に存在する場合、このポリシーで指定されたヘッダー値が既存のヘッダー値に連結されます。値はカンマ (,) で区切られます。

    • Modify: リクエストまたはレスポンスのヘッダーを変更します。

      説明
      • 指定されたヘッダーがリクエストまたはレスポンスに存在しない場合、このルールで指定されたヘッダーキーと値に基づいてヘッダーがリクエストまたはレスポンスに追加されます。

      • 指定されたヘッダーが既に存在する場合、その値は、このルールで指定されたヘッダー値によって上書きされます。

    • Delete: リクエストまたはレスポンスからヘッダーを削除します。

    Header Key

    リクエストまたはレスポンスのヘッダーの名前。

    Header Value

    リクエストまたはレスポンスのヘッダーの値。

  7. ヘッダー設定ポリシーが構成された後、Enable をオンにします。

    • ヘッダー設定ポリシーを有効にすると、ゲートウェイはリクエストまたはレスポンスのヘッダーを制御します。

    • ヘッダー設定ポリシーを無効にすると、ゲートウェイはリクエストまたはレスポンスのヘッダーを制御しません。

結果の確認

この例では、レスポンスにヘッダーが追加されます。次の図は、ポリシーの構成を示しています。

Header.png

  • 次のコマンドを実行して、テストリクエストを送信します。

    curl -I  http://121.196.XX.XX/demo/item/list       // ゲートウェイのイングレス IP アドレス
  • 次のレスポンスが返されます。レスポンスには test:demo ヘッダーが含まれています。

    HTTP/1.1 200 OK
    x-content-type-options: nosniff
    x-xss-protection: 1; mode=block
    cache-control: no-cache, no-store, max-age=0, must-revalidate
    pragma: no-cache
    expires: 0
    x-frame-options: DENY
    content-type: application/json
    content-length: 86
    date: Tue, 30 Nov 2021 03:03:04 GMT
    x-envoy-upstream-service-time: 4
    test: demo
    server: istio-envoy