设置访问Referer控制
更新时间:2021-01-25
接口
本接口用于设置域名访问Referer配置。
Method | Path | 说明 |
---|---|---|
PUT | /v2/dsa/domain/{domain}/config?action=setRefererAcl | 设置访问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不可同时存在。
请求示例1——设置白名单
PUT /v2/dsa/domain/myself.baidu.com/config?action=setRefererAcl HTTP/1.1
Host: cdn.baidubce.com
Content-Length: 78
Content-Type: text/json;utf-8
{
"refererAcl":{
"blackList":[
"www.xxx.com"
],
"allowEmpty":true
}
}
请求示例2——设置黑名单
PUT /v2/dsa/domain/myself.baidu.com/config?action=setRefererAcl HTTP/1.1
Host: cdn.baidubce.com
Content-Length: 78
Content-Type: text/json;utf-8
{
"refererACL":{
"whiteList":[
"www.xxx.com",
"test.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"
}