全部产品
Search
文档中心

边缘安全加速:修改响应头

更新时间:Dec 17, 2024

节点HTTP响应头是HTTP响应消息头的组成部分之一,可携带特定响应参数并传递给客户端。通过配置节点HTTP响应头,边缘安全加速 ESA节点返回资源给客户端时,响应消息会携带您配置的响应头,从而实现跨域访问等特定功能。

image

典型应用场景

  • 告知客户端边缘安全加速 ESA响应文件的资源类型:添加响应头Content-Type: text/html告知客户端边缘安全加速 ESA响应文件的格式是HTML格式。

  • 实现跨域资源访问:当用户请求边缘安全加速 ESA上某个域名的资源时,您可以在边缘安全加速 ESA返回的响应消息中配置响应头Access-Control-Allow-Origin,以实现跨域访问,请参考配置跨域资源共享

  • 自定义响应行为:添加或修改自定义头部信息,可以根据业务需求调整客户端接收到的响应内容和格式,实现特定的功能或跟踪目的。

注意事项

在添加了多条配置的情况下,配置的执行顺序是按配置列表从上到下的顺序逐条执行,响应头名称相同的配置将被覆盖,最终结果可能与预期不符。例如:

  • 配置1:增加HTTP响应头:cache-control: max-age=3600

  • 配置2:增加HTTP响应头:cache-control: no-cache

以上两个配置叠加的结果是配置2最终生效,即cache-control: no-cache。

修改响应头

  1. 登录ESA控制台

  2. 在左侧导航栏,单击站点管理

  3. 站点管理页面,单击目标站点名称,或对应站点操作列的详情

  4. 在左侧导航栏,选择规则 > 转换规则

  5. 单击修改响应头页签。

  6. 单击新建规则,填写规则名称并根据需求设置要匹配的用户请求及修改返回客户端的响应头的具体配置。

    操作方式

    说明

    示例

    添加

    在返回客户端的响应中添加指定响应头。

    增加名称为x-code,值为key1的响应头,请填写:

    • 响应头名称:x-code

    • 响应头值:key1

    删除

    在返回客户端的响应中删除所有与响应头名称匹配的参数值,无论是否有重复的响应头参数。

    删除名称为x-code的响应头,请填写响应头名称:x-code。

    变更

    在返回客户端的响应中变更指定响应头的值。

    修改名称为x-code的响应头的值为key2,请填写:

    • 响应头名称:x-code

    • 响应头值:key2

    说明
    • 禁止配置“ali-”或者“Ali-”开头的响应头名称

    • 一个响应头参数中可以配置多个值,多个值用英文逗号(,)分隔。

  7. 单击确定

响应头参数

响应头参数

说明

示例

自定义

支持添加自定义响应头。自定义响应头名称要求如下:

  • 由大小写字母、短划线(-)和数字组成。

  • 长度为1~100个字符。

Test-Header

Cache-Control

指定客户端程序请求和响应遵循的缓存机制。

no-cache

Content-Disposition

指定客户端程序把请求所得的内容存为一个文件时提供的默认的文件名。

examplefile.txt

Content-Type

指定客户端程序响应对象的内容类型。

text/plain

Pragma

Pragma 是一个在 HTTP/1.0 中规定的通用首部,这个首部通常用于在服务器的响应中定义客户端对文件的缓存行为。

no-cache

Access-Control-Allow-Origin

指定允许的跨域请求的来源。填写星号(*)表示全部域名;您也可以填写完整域名,例如http://www.aliyun.com

说明
  • 响应头值支持配置为“*”,表示任意来源。

  • 响应头值非“*”的情况下,支持配置单个或者多个IP、域名、或者IP和域名混合。相互间用英文(,)分隔。

  • 响应头值非“*”的情况下,必须包含协议头“http:// ”或者“https://”。

  • 响应头值支持携带端口。

  • 响应头值支持泛域名。

  • *

  • http://www.aliyun.com

  • https://aliyun.com:8080,http://10.10.10.10

  • http://*.aliyun.com

Access-Control-Allow-Methods

指定允许的跨域请求方法。可同时设置多个方法,多个方法用英文逗号(,)分隔。

POST,GET

Access-Control-Allow-Headers

指定允许的跨域请求字段。

X-Custom-Header

Access-Control-Expose-Headers

指定允许访问的自定义头信息。

Content-Length

Access-Control-Allow-Credentials

该响应头表示是否可以将对请求的响应暴露给页面。

  • 返回true:表示可以暴露。

  • 返回其他值:表示不可以暴露。

true

Access-Control-Max-Age

指定客户端程序对特定资源的预请求返回结果的缓存时间,单位为秒。

600