所有文档

          内容分发网络 CDN

          设置访问Referer控制

          Method Path 说明
          PUT /v2/domain/{domain}/config?refererACL 设置访问Referer配置

          domain: CDN加速域名

          请求体(Request Body)

          参数 可选 类型 说明
          refererACL 必选 RefererACL参数项解释如下:
          - blackList:可选项,list类型,表示referer黑名单列表,支持使用通配符,不需要加protocol,如设置某个黑名单域名,设置为"www.xxx.com"形式即可,而不是"http://www.xxx.com"。
          - whiteList:可选项,list类型,表示referer白名单列表,支持通配符
          ,同样不需要加protocol。
          - allowEmpty:必选项,Bool类型,表示是否允许空referer访问,默认为true即允许空referer访问。
          访问Referer配置规则

          注意:blackList和whiteList不可同时存在。

          防盗链域名匹配规则

          • 对于原有存量的referer配置,匹配策略保持不变,仅支持*.a.com/*形式的模糊匹配。
          • 对于2019年12月6日以后 新增存量更新 的referer防盗链配置,匹配方式为域名级匹配,支持通过添加通配符匹配子域名,如:*.test.com
          • Referer不区分协议设置,前缀不再需要输入http:// 或 https://,如果要配置http://zoe.baidu.com的Referer地址只需要输入zoe.baidu.com即可。

          请求示例1——设置白名单

          PUT /v2/domain/myself.baidu.com/config?refererACL HTTP/1.1
          Host: cdn.baidubce.com
          Content-Length: 78
          Content-Type: text/json;utf-8   
          
          {
              "refererACL":{
                  "blackList":[
                      "www.xxx.com",
                      "*.abcde.com"
                  ],
                  "allowEmpty":true
              }
          }

          请求示例2——设置黑名单

          PUT /v2/domain/myself.baidu.com/config?refererACL HTTP/1.1
          Host: cdn.baidubce.com
          Content-Length: 78
          Content-Type: text/json;utf-8   
          
          {
              "refererACL":{
                  "whiteList":[
                      "www.xxx.com",
                      "*.baidu.com"
                  ],
                  "allowEmpty":true
              }
          }

          响应示例

          HTTP/1.1 200 OK
          Content-Length: 0
          Content-Type: application/json;utf-8
          x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
          Server: BCE-CDN
          
          {
              "status":"RUNNING"
          }
          上一篇
          缓存配置接口
          下一篇
          查询访问Referer控制