Modificar cabeçalhos de resposta do servidor de origem - Edge Security Acceleration: Central de Documentação do Alibaba Cloud

Como funcionam os cabeçalhos de resposta da origem para o ESA

Este recurso modifica cabeçalhos de resposta específicos da origem com base em regras predefinidas. Os cabeçalhos modificados entram em vigor antes que o servidor ESA processe o objeto. Se o conteúdo da resposta for armazenável em cache, os cabeçalhos modificados serão salvos no cache junto com a resposta.

Esse comportamento difere da modificação dos cabeçalhos de resposta do ESA para o cliente. Nesse caso, as alterações são aplicadas após o ESA processar a resposta completa do servidor de origem ou do cache, e a resposta é enviada imediatamente ao cliente.

Modificar cabeçalhos de resposta da origem para o ESA

No console do ESA, selecione Websites e, na coluna Websites, clique em Website no site desejado.
No painel de navegação à esquerda, escolha Websites > Website.
Selecione a aba Response Header, clique em Origin to ESA, clique em Add e configure as condições de correspondência na seção Match Conditions. Para obter mais informações, consulte Componentes de uma expressão de regra.

Na seção Modify Response Headers, selecione uma ação, insira um nome e um valor de cabeçalho e clique em Submit.

A tabela a seguir descreve as ações e os modos disponíveis. O campo Mode determina como especificar o valor do cabeçalho: Static usa um valor fixo inserido por você, enquanto Dynamic avalia uma expressão de regra em tempo de execução.

Action	Mode	Description	Example
Add	Static	Adiciona o cabeçalho de resposta especificado à resposta do servidor de origem. Se já existir um cabeçalho com o mesmo nome, o novo cabeçalho o substituirá.	Para adicionar um cabeçalho de resposta chamado `x-code` com o valor `key1`, defina Header Name como `x-code` e Header Value como `key1`.
Add	Dynamic	O valor do cabeçalho de resposta pode ser uma expressão de regra.	Para adicionar um cabeçalho de resposta chamado `Client-Ip-Geo-Location` com o valor dinâmico `ip.geoip.country` que registra o país ou região do IP do cliente, defina Header Name como `Client-Ip-Geo-Location` e Header Value como `ip.geoip.country`.
Modify	Static	Altera o valor de um cabeçalho de resposta especificado na resposta do servidor de origem.	Para alterar o valor do cabeçalho de resposta `x-code` para `key2`, defina Header Name como `x-code` e Header Value como `key2`.
Modify	Dynamic	O valor do cabeçalho de resposta pode ser uma expressão de regra.	Para alterar o valor do cabeçalho de resposta `Client-Ip-Geo-Location` para o valor dinâmico `ip.geoip.country`, defina Header Name como `Client-Ip-Geo-Location` e Header Value como `ip.geoip.country`.
Delete	—	Exclui todas as instâncias do cabeçalho correspondentes ao nome especificado na resposta do servidor de origem. A operação de exclusão é idêntica para os modos estático e dinâmico.	Para excluir o cabeçalho de resposta `x-code`, defina Header Name como `x-code`.

Nota

Não configure nomes de cabeçalho que comecem com ali-swift, ali-esa-inner, x-swift ou x-site (sem distinção entre maiúsculas e minúsculas).
Especifique vários valores no campo Header Value separados por vírgula (,).
A ação Modify altera um cabeçalho de resposta existente e só tem efeito se houver um cabeçalho com o nome especificado na resposta original.

Parâmetros de cabeçalho de resposta

Parameter	Description	Example
Custom	Permite adicionar cabeçalhos de resposta personalizados. O nome do cabeçalho personalizado deve atender aos seguintes requisitos: conter letras maiúsculas, minúsculas, dígitos e hifens (`-`), com comprimento de 1 a 100 caracteres.	`Test-Header`
`Access-Control-Allow-Credentials`	Indica se a resposta pode ser exposta à página. Valores: `true` (resposta exposta) ou qualquer outro valor (resposta não exposta).	`true`
`Access-Control-Allow-Headers`	Especifica os cabeçalhos permitidos para solicitações cross-origin.	`X-Custom-Header`
`Access-Control-Allow-Methods`	Define os métodos permitidos para solicitações cross-origin. Separe vários métodos com vírgula (`,`).	`POST,GET`
`Access-Control-Allow-Origin`	Determina quais origens podem acessar o recurso. Parte do mecanismo CORS (Cross-Origin Resource Sharing). Valores suportados: curinga (`*`) permite acesso de qualquer origem — adequado para recursos públicos, mas use com cautela em produção devido a riscos de CSRF; origem única, como `http://example.com` — permite apenas solicitações dessa origem.	`*`, `http://www.aliyun.com`
`Access-Control-Expose-Headers`	Especifica quais cabeçalhos os scripts do lado do cliente podem acessar.	`Content-Length`
`Access-Control-Max-Age`	Define o tempo de cache dos resultados de uma solicitação preflight, em segundos.	`600`
`Cache-Control`	Especifica diretivas de cache para solicitações e respostas.	`no-cache`
`Content-Disposition`	Sugere um nome de arquivo padrão caso o cliente salve o conteúdo da resposta como arquivo.	`examplefile.txt`
`Content-Type`	Indica o tipo de mídia do conteúdo da resposta.	`text/plain`
`Pragma`	Cabeçalho HTTP/1.0 usado nas respostas do servidor para definir o comportamento de cache dos clientes.	`no-cache`

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

O exemplo a seguir demonstra como usar a função regex_replace com o campo http.response.headers para substituir caracteres especiais em um valor de cabeçalho de resposta do servidor de origem.

Cenário: Substituir o símbolo # por - no valor do cabeçalho HTTP example na resposta do servidor de origem para o nó ESA.

Configuração

Na seção Modify Response Headers, configure os seguintes parâmetros:

Parameter	Value
Rules	Dynamic
Transform Rules	Modify
Type	`example`
Operation	`regex_replace(regex_replace(regex_replace(http.response.headers["example"], "#", "-"), "#", "-"), "#", "-")`

Resultado

	Value
Cabeçalho de resposta original	`example:cat#dog#duck#sheep`
Cabeçalho modificado	`example:cat-dog-duck-sheep`

Documentação relacionada

Os recursos relacionados a regras variam em prioridade efetiva, reentrância e granularidade. Para obter detalhes, consulte Characteristics of rule-based features.