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 back-to-origin — Adicione ou modifique cabeçalhos para definir como os servidores de origem processam as requisições.
Enriquecer logs do backend — Transmita informações do cliente (como endereços IP de origem) por meio de cabeçalhos personalizados para registro e análise.
Remover cabeçalhos irrelevantes — Exclua 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 ESA. Para mais informações, consulte Rules.
Ativou o recurso Rules para o seu site.
Etapas
No console ESA, selecione Websites e, na coluna Websites, clique em no site desejado.
No painel de navegação à esquerda, escolha .
Clique em Modify request header > Client to ESA > Create Rule.
-
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 para as 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-codecom o valorkey1, insira:
- Header Name:x-code
- Header Value:key1Dynamic
O valor do cabeçalho pode ser definido como uma expression.
Para adicionar um cabeçalho de requisição chamado
True-Client-IPcom o valorip.srce registrar o endereço IP de origem do cliente, insira:
- Header Name:True-Client-IP
- Header Value:ip.srcModify
Static
Altera o valor de um cabeçalho de requisição especificado na requisição de origem. Tem efeito apenas 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-codeparakey2na requisição de origem, insira:
- Header Name:x-code
- Header Value:key2Dynamic
O valor do cabeçalho pode ser definido como uma expression.
Para alterar o cabeçalho de requisição chamado
True-Client-IPpara o valorip.srcna 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.srcDelete
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.
Não é possível configurar nomes de cabeçalhos de requisição que começam com
ali-swift,ali-esa-inner,x-swiftoux-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ó tem efeito se a requisição original contiver um cabeçalho com o nome especificado; caso contrário, nenhuma ação ocorre.
Em 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
No console ESA, selecione Websites e, na coluna Website, clique em no site desejado.
No painel de navegação à esquerda, escolha .
Clique em Websites > Client to ESA > Website.
-
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-INHeader Value:
ip.src
Verificar o resultado
Após a configuração, o cabeçalho true-client-ip-in conterá o endereço IP de origem do cliente.