文档中心 网页加速 自定义头部黑白名单

自定义头部黑白名单

更新时间:2023-09-13 14:10:14

功能介绍

网宿支持通过配置 自定义头部防盗链规则实现访问控制。
通过对HTTP头部值进行规则判断,按需放行或拒绝用户访问。

操作步骤

  1. 登录网宿CDN控制台,选择域名所在的产品线。
  2. 选择域名,单击配置修改。
  3. 在自助配置界面选择:访问控制- 自定义头部防盗链,单击添加。
  4. 配置访问控制的生效范围,即配置针对哪些请求进行访问控制。此处提供5种生效范围供选择:
    网宿科技爱心捐赠 谱写“蓝天下的至爱”
    常规生效范围有5种:
参数 描述
所有请求 针对该域名下的所有请求都会生效此功能
仅首页 表示仅针对http://domain/或https://domain/这种根目录格式的请求生效此功能。
指定文件类型 可选择常用类型或自定义文件类型,多个文件类型之间以英文分号分隔。例如:ace;aac。表示此配置对此类文件类型均会生效
指定URI 可以设定针对URI的请求生效此功能。
不以“http://”或“https://”开头,仅配置URL中的URI部分;多条换行分隔。例如:完整URL为:http://www.test.com/browse/index.html,则配置内容为:/browse/index.html。
指定目录 可以设定仅部分目录下的请求进行访问控制。目录必须以“/”开头和结尾,由字母、数字及部分特殊符号(包含下划线、减号、百分号、点)任意组合;多个目录换行分隔。
例如:/file1/123/和/file2/1%1/表示http://加速域名/file1/123/和http://加速域名/file2/1%1/两个目录及目录下所有文件。

另外,可选配置进阶生效范围, 此配置项配置的内容,与“生效范围”中配置的内容,取交集则为此功能的生效范围。“例外”表示非,例如,例外的文件类型为jpg, 则表示除了jpg以外的其他文件类型。

  1. 配置访问控制策略。
    1) 设置HTTP头的黑名单:
    网宿科技爱心捐赠 谱写“蓝天下的至爱”
    2) 设置HTTP头的白名单:
    网宿科技爱心捐赠 谱写“蓝天下的至爱”

    参数说明:

    参数 描述
    头域黑名单 设置禁止的HTTP头的名称,一条规则只能配置一个头部
    头域值黑名单 设置禁止的HTTP头的值,多个换行分隔。 当HTTP头值匹配此处配置值时,则进行禁止。
    头域白名单 设置允许的HTTP头的名称,一条规则只能配置一个头部
    头域值白名单 设置允许的HTTP头的值,多个换行分隔。 当HTTP头值匹配此处配置值时,则允许访问。
  2. 配置其他参数。
    网宿科技爱心捐赠 谱写“蓝天下的至爱”

    参数 描述
    来源 可选择客户端或服务器,选择客户端则在客户端请求方向做防盗链;选择服务端则在源响应方向;
    优先级 配置了多条访问控制规则,系统按优先级大小先后执行,数字大的优先级高。
    控制动作 访问校验不通过的请求,是选择禁止访问还是跳转URL。其中, 禁止:访问校验不通过的请求,系统返回403。跳转:访问校验不通过的请求,系统返回跳转的页面。跳转的页面在跳转到URL中进行配置。
  3. 配置完毕,单击确认,然后单击下一步。

  4. 为了避免影响线上业务,建议先预部署测试效果,单击预部署。

  5. 预部署成功后,可以获取到对应的测试节点,可以host节点进行测试。

  6. Host测试后,确保配置无误,则单击直接部署,预计需要3-5分钟的部署时间。

配置示例

场景一: 配置黑名单
实现场景:如果客户端请求头中带Test-Header,且值为key1或key2,则禁止访问,其他情况则允许访问。配置如下图所示:
网宿科技爱心捐赠 谱写“蓝天下的至爱”

场景二: 配置白名单
实现场景:如果客户端请求头中带Test-Header,且值为key1或key2,则允许访问,其他情况则禁止访问。配置如下图所示:
网宿科技爱心捐赠 谱写“蓝天下的至爱”

注意事项

  1. 白名单只能配置一条规则,如果有多个头部值需要设置为白名单,请写到一条规则中。
  2. 请勿同时自助配置黑白名单,否则容易造成业务异常。如需配置,请联系网宿技术支持进行评估。如下图配置,会导致所有访问被拒绝。原因如下:
    1)Test-Header值为key1的请求,匹配第一条黑名单规则,访问会被拒绝。
    2)Test-Header值为非key1的请求,匹配第一条未被拒绝,但匹配第二条白名单规则时被拒绝.因为第二条白名单规定只有Test-Header值为key1的请求才允许访问。
    网宿科技爱心捐赠 谱写“蓝天下的至爱”
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!