Todos los productos
Search
Centro de documentos

API Gateway:Configurar una política de modificación de encabezados

Última actualización: Sep 21, 2026

Las políticas de modificación de encabezados permiten agregar, actualizar o eliminar encabezados en las solicitudes antes de que lleguen a los servicios de backend. También se pueden modificar los encabezados en las respuestas antes de devolverlas a los clientes.

Procedimiento

  1. Cloud-native API Gateway ofrece dos métodos para configurar una política de modificación de encabezados:

    APIs outside instances

    1. Inicie sesión en la consola de API Gateway. En el panel de navegación izquierdo, elija API. En la barra de navegación superior, seleccione una región.

    2. Haga clic en la API de destino. En la lista desplegable, seleccione la instancia para la que desea configurar la política o elija All instances.

    3. En la pestaña Routes, seleccione la ruta de destino.

    APIs within an instance

    1. Inicie sesión en la consola de API Gateway. En el panel de navegación izquierdo, elija Instance. En la barra de navegación superior, seleccione una región.

    2. En la página Instance, haga clic en el ID de la instancia de puerta de enlace de destino. En el panel de navegación izquierdo, elija API y luego haga clic en la API de destino.

    3. En la pestaña Routes, seleccione la ruta de destino.

  2. Haga clic en la pestaña Configure Policy. Después, haga clic en Enable Policy/Plug-in dentro de Inbound Processing o de Outbound Processing.

  3. Haga clic en la tarjeta Edit Header. En el panel Add Policy: Edit Header, configure los parámetros y haga clic en Add.

    Parámetro

    Descripción

    Enable

    • Enable: aplica la política de modificación de encabezados a las solicitudes y respuestas.

    • Disable: no aplica la política de modificación de encabezados.

    Header Type

    El tipo de encabezado que se va a modificar. Valores válidos: Request y Response.

    • Request: la política se aplica a los encabezados de solicitud.

    • Response: la política se aplica a los encabezados de respuesta.

    Operation Type

    La operación que se ejecutará sobre el encabezado. Valores válidos: Add, Modify y Delete.

    • Add: agrega un encabezado a la solicitud o respuesta.

      Nota

      Si el encabezado especificado ya existe, esta operación añade el nuevo valor al existente y los separa con una coma (,).

    • Modify: modifica un encabezado específico en la solicitud o respuesta.

      Nota
      • Si el encabezado especificado no existe, esta operación crea uno nuevo con la clave y el valor indicados.

      • Si el encabezado especificado existe, esta operación sobrescribe su valor.

    • Delete: elimina un encabezado específico de la solicitud o respuesta.

    Header Key

    El nombre del encabezado que se va a agregar, modificar o eliminar.

    Header Value

    El valor del encabezado.

Comprobar el resultado

A continuación se muestra un ejemplo que agrega un encabezado de respuesta test:demo. Sustituya los valores por los datos reales de su entorno.

Ejecute el siguiente comando para probar la configuración:

curl -I  http://121.196.XX.XX/demo/item/list       // Replace with your gateway's ingress IP address

La respuesta incluye el encabezado 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