Todos os produtos
Search
Central de documentação

Microservices Engine:Configurar modificação de cabeçalho

Última atualização: Jun 28, 2026

Use a modificação de cabeçalho para alterar os cabeçalhos de uma requisição antes do roteamento para um serviço de backend ou de uma resposta antes do retorno ao cliente. Este tópico explica como configurar regras de modificação de cabeçalho para um gateway nativo da nuvem.

Procedimento

  1. Faça login no MSE console. Na barra de navegação superior, selecione uma região.

  2. No painel de navegação à esquerda, escolha Cloud-native Gateway > Gateways. Na página Gateways, clique em ID do gateway.

  3. No painel de navegação à esquerda, clique em Routes. Em seguida, clique em aba Routes.

  4. Na regra de roteamento que deseja modificar, clique em Policies na coluna Actions.

  5. Na seção Policies, clique em Header Modification e, em seguida, clique em ícone 编辑图案 ou em Add Rule à direita.

  6. Configure os parâmetros da regra e clique em Save no canto superior direito.

    Parâmetro

    Descrição

    Header Type

    Selecione o tipo de cabeçalho. Valores válidos: Request e Response.

    • Request: modifica os cabeçalhos da requisição recebida.

    • Response: modifica os cabeçalhos da resposta enviada.

    Action Type

    Escolha o tipo de ação. Valores válidos: Add, Modify e Delete.

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

      Nota

      Se já existir um cabeçalho com o mesmo nome, o novo valor será anexado ao valor existente, separado por vírgula (,).

    • Modify: altera um cabeçalho específico na requisição ou resposta.

      Nota
      • Se o cabeçalho especificado não existir, o sistema adicionará um novo cabeçalho com a chave e o valor definidos.

      • Se o cabeçalho especificado já existir, o sistema sobrescreverá seu valor.

    • Delete: remove um cabeçalho específico da requisição ou resposta.

    Header Key

    Insira o nome do cabeçalho.

    Header Value

    Insira o valor do cabeçalho.

  7. Após configurar a regra de modificação de cabeçalho, ative a chave Enable.

    • Quando ativada, o gateway modifica os cabeçalhos de requisição e resposta conforme as regras configuradas.

    • Quando desativada, o gateway não altera os cabeçalhos de requisição ou resposta.

Verificação do resultado

Como exemplo, suponha que você tenha configurado uma regra para adicionar um cabeçalho de teste a uma resposta.

  • Execute o comando abaixo para enviar uma requisição de teste:

    curl -I  http://121.196.XX.XX/demo/item/list       // The ingress IP address of the gateway
  • A resposta inclui 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