Todos os produtos
Search
Central de documentação

API Gateway:Configure uma política de modificação de cabeçalho

Última atualização: Sep 21, 2026

As políticas de modificação de cabeçalho permitem adicionar, atualize ou excluir cabeçalhos nas requisições antes de chegarem aos serviços de backend, ou nas respostas antes de serem enviadas aos clientes.

Procedimento

  1. O Cloud-native API Gateway oferece dois métodos para configure uma política de modificação de cabeçalho:

    APIs fora de instâncias

    1. Acesse o console do API Gateway. No painel de navegação à esquerda, escolha API. Na barra de navegação superior, selecione uma região.

    2. Clique em API de destino. Na lista suspensa, selecione a instância para a qual deseja configure a política ou escolha All instances.

    3. Na guia Routes, selecione a rota de destino.

    APIs dentro de uma instância

    1. Acesse o console do API Gateway. No painel de navegação à esquerda, escolha Instance. Na barra de navegação superior, selecione uma região.

    2. Na página Instance, clique em ID da instância do gateway de destino. No painel de navegação à esquerda, escolha API e, em seguida, clique em API de destino.

    3. Na guia Routes, selecione a rota de destino.

  2. Clique em guia Configure Policy e, em seguida, clique em Enable Policy/Plug-in em Inbound Processing ou Outbound Processing.

  3. Clique em cartão Edit Header. No painel Add Policy: edite Header, configure os parâmetros e clique em Add.

    Parâmetro

    Descrição

    Enable

    • Enable: Aplica a política de modificação de cabeçalho às requisições e respostas.

    • Disable: Não aplica a política de modificação de cabeçalho.

    Header Type

    O tipo de cabeçalho a ser modificado. Valores válidos: Request e Response.

    • Request: A política aplica-se aos cabeçalhos de requisição.

    • Response: A política aplica-se aos cabeçalhos de resposta.

    Operation Type

    A operação a ser executada no cabeçalho. Valores válidos: Add, Modify e Delete.

    • Add: Adiciona um cabeçalho à requisição ou resposta.

      Nota

      Se o cabeçalho especificado já existir, essa operação anexa o novo valor do cabeçalho ao existente, separado por vírgula (,).

    • Modify: Modifica um cabeçalho especificado na requisição ou resposta.

      Nota
      • Se o cabeçalho especificado não existir, essa operação adiciona um novo cabeçalho com a chave e o valor especificados.

      • Se o cabeçalho especificado já existir, essa operação sobrescreve o seu valor.

    • Delete: Exclui um cabeçalho especificado da requisição ou resposta.

    Header Key

    O nome do cabeçalho a ser adicionado, modificado ou excluído.

    Header Value

    O valor do cabeçalho.

Verifique o resultado

O exemplo a seguir adiciona um cabeçalho de resposta test:demo. Substitua os valores pelos seus valores reais.

Execute o seguinte comando para testar a configuração:

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

A resposta contém o cabeçalho 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