全部產品
Search
文件中心

API Gateway:配置Header修改策略

更新時間:May 21, 2025

在請求轉寄給目標後端服務或後端服務的響應返回給用戶端之前,Header修改策略可以修改原始請求中的Header。本文介紹雲原生網關如何佈建要求和響應的Header。

設定Header規則

  1. 雲原生API Gateway提供了執行個體內和執行個體外兩種配置Header修改策略的方式:

    執行個體外API

    1. 登入雲原生API Gateway控制台。左側導覽列選擇API,並在頂部功能表列選擇地區。

    2. 單擊目標API,您可以在下拉框中選擇需要配置Header修改策略的執行個體,或者選擇全部執行個體image

    3. 選擇路由列表中的目標路由。

    執行個體內API

    1. 登入雲原生API Gateway控制台。左側導覽列選擇執行個體,並在頂部功能表列選擇地區。

    2. 執行個體頁面,單擊目標網關執行個體ID。左側導覽列選擇API,單擊目標API。

    3. 選擇路由列表中的目標路由。

  2. 單擊策略配置頁簽,然後單擊入站處理出站處理啟動策略/外掛程式

  3. 單擊Header修改卡片,在添加策略: Header修改面板配置相關參數,然後單擊添加

    參數

    描述

    開啟

    • 開啟:開啟Header修改策略後,網關會控制請求和響應的Header。

    • 關閉:關閉Header修改策略後,網關不會控制請求和響應的Header。

    Header類型

    選擇Header類型,包括請求響應

    • 請求:表示將會對請求的Header進行設定。

    • 響應:表示將會對響應的Header進行設定。

    操作類型

    選擇操作類型,包括新增修改刪除

    • 新增:向請求或響應新增一個Header。

      說明

      如果新增的Header已存在,那麼Header Value將會拼接在已有的Header值後面,並通過英文逗號(,)分隔。

    • 修改:修改請求或響應指定的Header。

      說明
      • 如果指定的Header不存在,將會按照Header Key和Header Value進行新增操作。

      • 如果指定的Header存在,將會進行覆蓋修改操作。

    • 刪除:刪除請求或響應指定的Header。

    Header Key

    輸入請求或響應的頭部名。

    Header Value

    輸入請求或響應的頭部值。

結果驗證

假設添加一個測試的響應Header,如下圖所示,您可以根據實際業務情境進行設定。

image

執行以下測試請求命令:

curl -I  http://121.196.XX.XX/demo/item/list       // 網關入口IP

響應結果(返回帶有test:demo的Header值):

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