Customize HTTP request headers in origin requests using rules - Edge Security Acceleration: Central de Documentação do Alibaba Cloud

Como funciona

Quando uma requisição de cliente resulta em cache miss, o POP do ESA encaminha uma requisição de origem ao seu servidor. Você pode personalizar os cabeçalhos HTTP nessa requisição de origem:

Observações

Momento de aplicação das regras: As regras se aplicam apenas a buscas na origem (cache misses). Requisições atendidas pelo cache do ESA não sofrem alterações.
Ordem de execução: O sistema executa as operações dentro de uma regra de cima para baixo. Quando várias operações têm como alvo o mesmo cabeçalho, a última prevalece. Por exemplo, se a requisição do cliente contiver test:123, a regra adicionar primeiro test:321 e depois exclua test, o cabeçalho test será removido da requisição de origem.

Procedimento

Ao receber uma requisição, o ESA executa as regras correspondentes com base na prioridade de execução de regras.

No console do ESA, selecione Websites e clique em no site desejado na coluna Websites.
No painel de navegação à esquerda, escolha Website > Rules.
Clique em na aba Transform Rules, selecione o item Modify request header e clique em ESA to Origin.

Na área Create Rule, configure os seguintes parâmetros:

Parâmetro	Descrição
Rule Name	Nome personalizado para a regra.
If requests match...	All Requests: aplica-se a todas as requisições do site atual. Filtered Requests: aplica-se apenas ao tráfego correspondente a uma expressão personalizada.
Modify Request Header	Detalhes da operação, tipo e cabeçalho. Consulte Operações e Restrições.

Operações

Operação	Tipo	Comportamento	Exemplo
Add	Static	Adiciona o cabeçalho à requisição de origem. Se já existir um cabeçalho com o mesmo nome, o novo valor o substituirá.	Request Header Name: `x-code`	Request Header Value: `key1`
Add	Dynamic	Adiciona um cabeçalho com valor calculado a partir de uma expressão.	Request Header Name: `True-Client-IP`	Request Header Value: `ip.src`
Change	Static	Altera o valor de um cabeçalho existente. Aplica-se somente se houver um cabeçalho com o nome especificado na requisição original.	Request Header Name: `x-code`	Request Header Value: `key2`
Change	Dynamic	Altera o valor de um cabeçalho existente usando uma expressão. A alteração ocorre apenas se o cabeçalho com o nome especificado já existir na requisição original.	Request Header Name: `True-Client-IP`	Request Header Value: `ip.src`
Delete	N/A	Exclua todos os cabeçalhos correspondentes ao Request Header Name especificado, independentemente de duplicatas.	Request Header Name: `x-code`

Restrições

Não utilize um Request Header Name que comece com ali- ou Ali-.
Para especifique vários valores no Request Header Value, separe-os por vírgula (,).
A operação Delete funciona da mesma forma para os tipos Static e Dynamic.
A operação Change só é aplicada se já existir um cabeçalho com o nome especificado na requisição original.
Dentro de uma única regra, as operações são executadas sequencialmente. Se operações diferentes tiverem como alvo o mesmo nome de cabeçalho, a última operação substituirá as anteriores.

Exemplos

Siga as etapas 1 a 3 na seção Procedimento para abrir a área Add Request Header Modification Rule.

Adicionar o endereço IP de origem do cliente a todas as requisições

Configure estes parâmetros:

Add Request Header Modification Rule: add-client-ip-out
If requests match...: Selecione All Requests.
Modify Request Header:
- Type: Dynamic
- Operation: Add
- Request Header Name: True-Client-IP-OUT
- Request Header Value: ip.src

Verificação

Antes: O cabeçalho da requisição não inclui o endereço IP do cliente.

Depois: O cabeçalho true-client-ip-out com o endereço IP do cliente é adicionado.

Adicionar o código do país para requisições fora de China (Hong Kong)

Configure estes parâmetros:

Rule Name: add-client-country
If requests match...: Selecione Filtered Requests e insira Country/Region does not equal China (Hong Kong). Também é possível edite a expressão diretamente: (ip.geoip.country ne "HK")
Modify Request Header:
- Type: Dynamic
- Operation: Add
- Request Header Name: IP-Country-Code
- Request Header Value: ip.geoip.country

Verificação

Antes: O cabeçalho da requisição não inclui o código do país referente ao endereço IP do cliente.

Depois: O cabeçalho ip-country-code com o código do país do cliente é adicionado.

Adicionar o código da província para um caminho de URI específico

Configure estes parâmetros:

Rule Name: add-client-province
Rule Name: Selecione If requests match... e insira URI Path equals /content. Também é possível edite a expressão diretamente: (http.request.uri.path eq "/content")
Filtered Requests:
- Modify Request Header: Type
- Dynamic: Operation
- Add: IP-Province-Code
- Request Header Name: ip.src.subdivision_1_iso_code

Verificação

Antes: O cabeçalho da requisição não inclui o código da província referente ao endereço IP do cliente.

Depois: O cabeçalho ip-province-code com o código da província do cliente é adicionado.

Referências

O tópico Como as regras do ESA entram em vigor aborda prioridade de execução, comportamento da regra e escopo de configuração.