Todos os produtos
Search

Este produto

    Edge Security Acceleration:Modificar cabeçalhos de requisição de entrada

    Central de documentação

    Edge Security Acceleration:Modificar cabeçalhos de requisição de entrada

    Última atualização: Jun 29, 2026

    Adicione, modifique ou exclua cabeçalhos de requisição de entrada específicos na borda para controlar o que seu backend recebe. Por exemplo, injete cabeçalhos Accept-Encoding ou Accept-Language para personalizar a experiência dos visitantes e rastrear o comportamento de uso.

    Visão geral

    O recurso de modificação de cabeçalhos de requisição de entrada permite adicionar, alterar ou remover cabeçalhos nos nós de borda antes que as requisições cheguem à sua origem. Com isso, você pode:

    • Controlar o roteamento de volta à origem — Adicionar ou modificar cabeçalhos para definir como os servidores de origem processam as requisições.

    • Enriquecer logs do backend — Transmitir informações do cliente (como endereços IP de origem) por meio de cabeçalhos personalizados para fins de registro e análise.

    • Remover cabeçalhos irrelevantes — Excluir cabeçalhos desnecessários da requisição original para reduzir sobrecarga e aumentar a segurança.

    Configurar cabeçalhos de requisição de entrada

    Pré-requisitos

    Antes de começar, verifique se você:

    • Criou um site no console do ESA. Para mais informações, consulte Precedência de regras.

    • Ativou o recurso Rules para o seu site.

    Etapas

    1. No console do ESA, selecione Websites e, na coluna Website, clique em no site desejado.

    2. No painel de navegação à esquerda, escolha Rules > Transform Rules.

    3. Clique em Modify request header > Client to ESA > Create Rule.

      Add rule

    4. Na área Add Request Header Modification Rule, configure os seguintes campos:

      • Rule Name: Insira um nome personalizado para a regra.

      • If requests match...: Selecione a condição que determina a quais requisições a regra se aplica.

        • All Requests: A regra se aplica a todas as requisições do site atual.

        • Filtered Requests: A regra se aplica apenas ao tráfego correspondente a uma expressão personalizada. Configure uma expressão para filtrar o tráfego.

      • Modify Request Header: Especifique a ação a executar nas requisições correspondentes. Use a tabela abaixo para escolher o tipo de operação e o modo.

        Operação

        Modo

        Descrição

        Exemplo

        Add

        Static

        Garante a presença do cabeçalho de requisição especificado na requisição de origem. Cria o cabeçalho se ele não existir ou substitui o cabeçalho existente com o mesmo nome.

        Para adicionar um cabeçalho de requisição chamado x-code com o valor key1, insira:
        - Header Name: x-code
        - Header Value: key1

        Dynamic

        É possível definir o valor do cabeçalho como uma expressão.

        Para adicionar um cabeçalho de requisição chamado True-Client-IP com o valor ip.src e registrar o endereço IP de origem do cliente, insira:
        - Header Name: True-Client-IP
        - Header Value: ip.src

        Modify

        Static

        Altera o valor de um cabeçalho de requisição especificado na requisição de origem. Só entra em vigor se já existir um cabeçalho com o nome especificado; caso contrário, nenhuma ação ocorre.

        Para alterar o valor do cabeçalho de requisição chamado x-code para key2 na requisição de origem, insira:
        - Header Name: x-code
        - Header Value: key2

        Dynamic

        É possível definir o valor do cabeçalho como uma expressão.

        Para alterar o cabeçalho de requisição chamado True-Client-IP para o valor ip.src na requisição de origem e definir seu valor como o endereço IP de origem do cliente, insira:
        - Header Name: True-Client-IP
        - Header Value: ip.src

        Delete

        Remove da requisição de origem todos os cabeçalhos correspondentes ao Header Name especificado, independentemente da existência de duplicatas.

        Para excluir o cabeçalho de requisição chamado x-code, insira o Header Name: x-code.
    Nota

    • Não é possível configurar nomes de cabeçalhos de requisição iniciados com ali-swift, ali-esa-inner, x-swift ou x-site (não diferencia maiúsculas de minúsculas).

    • Para especificar vários valores em Header Value, separe-os por vírgula (,).

    • A operação Delete funciona da mesma forma nos modos Static e Dynamic. A operação Modify só entra em vigor se a requisição original contiver um cabeçalho com o nome especificado; caso contrário, nenhuma ação ocorre.

    • Dentro de uma única regra, múltiplas operações são executadas sequencialmente. Se diferentes operações tiverem como alvo o mesmo nome de cabeçalho, a última operação substituirá as anteriores.

    Exemplos de configuração de expressão dinâmica

    Este exemplo demonstra como adicionar uma expressão dinâmica que transmite o endereço IP de origem do cliente em um cabeçalho de requisição personalizado.

    Adicionar uma expressão dinâmica para True-Client-IP-IN

    Procedimento

    1. No console do ESA, selecione Websites e, na coluna Website, clique em no site desejado.

    2. No painel de navegação à esquerda, escolha Rules > Transform Rules.

    3. Clique em Modify request header > Client to ESA > Create Rule.

      Add rule

    4. Na área Add Incoming Request Header, configure os seguintes campos:

      • Rule Name: Insira add-client-ip-in.

      • Match Condition: Selecione All Requests para aplicar a regra a todas as requisições do site atual.

      • Header Operation:

        • Type: Dynamic

        • Operation: Add

        • Header Name: True-Client-IP-IN

        • Header Value: ip.src

      Expression configuration

    Verificar o resultado

    Após a configuração, o cabeçalho true-client-ip-in conterá o endereço IP de origem do cliente.

    Result verification