修改入站请求头

背景介绍

在实际使用中，一些客户需要通过修改入站请求头来实现更灵活的回源和缓存控制。例如，在ESA中，添加特定请求头回源到不同的源站，但希望在回源完成后自动删除这些临时头，避免影响源站处理。因此，提供对入站请求头的添加、删除、修改，将帮助客户更好地实现回源路由控制、缓存优化和精细化缓存管理，满足多样化业务需求。

操作步骤

新增规则后，当用户发起资源访问请求时，ESA将根据规则的生效优先级依次进行匹配与执行。

1. 在ESA控制台，选择站点管理，在站点列单击目标站点。

2. 在左侧导航栏，选择规则 > 转换规则。

3. 单击修改入站请求头页签，单击新增规则，填写规则名称。

4. 在如果请求匹配以下规则...区域设置要匹配的用户请求特征，具体配置规则请参见规则表达式的组成。

5. 在修改入站请求头区域，选择规则适用的资源类型和操作方式，填入请求头名称和请求头值。

   操作方式	类型	说明	示例
   添加	静态	在回源请求中添加指定请求头。 如果客户端请求中已经包含了同名请求头，则新添加的请求头将会覆盖客户端请求中的同名请求头。	增加名称为x-code，值为key1的请求头，请填写： 请求头名称：x-code 请求头值：key1
   	动态	请求头值支持设置为一个表达式。	增加名称为True-Client-IP，值为ip.src的请求头，用于记录客户端的真实IP地址，请填写： 请求头名称：True-Client-IP 请求头值：ip.src
   变更	静态	在回源请求中变更指定请求头的值。	修改回源请求中名称为x-code的请求头的值为key2，请填写： 请求头名称：x-code 请求头值：key2
   	动态	请求头值支持设置为一个表达式。	修改回源请求中名称为True-Client-IP的请求头，值为ip.src，将请求头的值变更为客户端的真实IP地址，请填写： 请求头名称：True-Client-IP 请求头值：ip.src
   删除		在回源请求中删除所有与请求头名称匹配的参数值，无论是否有重复的请求头参数。	删除名称为x-code的请求头，请填写请求头名称：x-code。

   说明

   • 禁止配置以ali-或者Ali-开头的请求头名称。

   • 请求头值中可以配置多个值，用英文逗号,分隔。

   • 删除操作不区分静态模式和动态模式，效果一致。

   • 变更是对已存在的请求头进行修改，仅在原始请求头中存在对应名称的请求头时，变更操作才会生效。

6. 单击确定。

相关文档

规则相关的功能，在生效优先级、可重入性、生效颗粒度上存在差异，详细情况请查看规则相关功能的特性说明。