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

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

最終更新日:Mar 12, 2026

リクエストがクラウドネイティブゲートウェイを通過する際、バックエンドサービスに到達する前、またはレスポンスがクライアントに戻る前に、HTTP ヘッダーを挿入、書き換え、または削除する必要がある場合があります。Microservices Engine (MSE) のヘッダー設定ポリシーを使用すると、アプリケーションコードを変更することなく、ルートレベルでリクエストとレスポンスの両方に対してヘッダーを追加、変更、または削除できます。

前提条件

開始する前に、以下があることを確認してください。

  • 少なくとも 1 つのルーティングルールを持つ MSE クラウドネイティブゲートウェイ

アクションタイプの動作

各アクションタイプは、既存のヘッダーを異なる方法で処理します。ユースケースに基づいてアクションタイプを選択してください。

アクションタイプ動作ユースケース
追加ヘッダーに値を追加します。同じキーを持つヘッダーがすでに存在する場合、新しい値は既存の値にコンマ (,) で区切られて連結されます。既存の値に加えて、カスタムトラッキングヘッダーを追加します。
変更ヘッダーを指定された値に設定します。ヘッダーが存在しない場合は作成されます。ヘッダーがすでに存在する場合は、既存の値が上書きされます。ヘッダーの有無にかかわらず、特定の Content-Type を強制するか、トレース ID を挿入します。
削除リクエストまたはレスポンスから指定されたヘッダーを削除します。アップストリームサービスに転送する前に、内部認証トークンまたはデバッグヘッダーを削除します。

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

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

  2. 左側のナビゲーションウィンドウで、[クラウドネイティブゲートウェイ] > [ゲートウェイ] を選択します。ゲートウェイの名前をクリックします。

  3. 左側のナビゲーションウィンドウで、[ルート] をクリックし、次に [ルート] タブをクリックします。

  4. 対象のルーティングルールを見つけ、操作 列の Policies をクリックします。

  5. Policies タブの左側のナビゲーションウィンドウで、[ヘッダー] をクリックします。[ヘッダーの編集] タブで、edit icon または Add Rule をクリックします。

  6. 次のパラメーターを設定し、右上隅にあるSave をクリックします。

    パラメーター説明
    Header Typeリクエストヘッダーを変更する場合は Request を、レスポンスヘッダーを変更する場合は Response を選択します。
    Action TypeAddModify、または Delete を選択します。 各操作タイプの詳細な動作については、「操作タイプの動作」をご参照ください。
    Header Keyヘッダー名 (例: X-Request-IDCache-Control) を指定します。
    Header Valueリクエストまたはレスポンスにおけるヘッダーの値を指定します。
  7. ポリシーを有効化するには、Enable トグルをオンにします。

    説明

    トグルがオフの場合、ゲートウェイはこのポリシーで定義されたヘッダー変更を適用しません。

結果の確認

次の例は、test: demo レスポンスヘッダーの追加を示しています。

Header policy configuration

  1. ゲートウェイのイングレス IP アドレスにリクエストを送信します。<gateway-ingress-ip> をゲートウェイの実際のイングレス IP アドレスに置き換えてください。

    curl -I http://<gateway-ingress-ip>/demo/item/list
  2. レスポンスに test: demo ヘッダーが含まれていることを確認します。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

適用シナリオ

次の表は、一般的なヘッダー操作シナリオと、それぞれの推奨される構成を示しています。

シナリオヘッダータイプアクションタイプヘッダーキーヘッダー値
レスポンスに CORS ヘッダーを追加レスポンス変更Access-Control-Allow-Origin*
リクエストにトレース ID を挿入リクエスト変更X-Request-ID<trace-id>
転送前に内部ヘッダーを削除リクエスト削除X-Internal-Debug--
リクエストにルーティングタグを追加リクエスト追加X-Route-Tagcanary