SetRequestAuthConfig

描述

本接口用于设置加速域名的时间戳+共享密钥防盗链功能。

注意：

加速域名创建后，默认不开启时间戳+共享密钥防盗链功能。

请求语法

本接口请求需要包含指定目录/2016-09-01/domain/SetRequestAuthConfig、公共请求header和该接口所特有的请求参数，具体请求语句参照下文请求示例。

请求参数

参数名	必选	类型及范围	说明
DomainId	是	String	域名ID
Enable	是	String	配置是否开启或关闭取值：on、off，默认值为off关闭。开启时，下述必须项为必填项；关闭时，只更改此标识，忽略后面的项目。
AuthType	是	String	防盗链类型，取值：typeA 、typeB；开启后必填（两种类型说明见下）
Key1	是	String	主享密钥，必须由大小写字母（a-Z）或者数字（0-9）组成，长度在6-128个字符之间。
Key2	否	String	备享密钥，必须由大小写字母（a-Z）或者数字（0-9）组成，长度在6-128个字符之间。
ExpirationTime	是	Long	过期时间，单位为“秒”，输入大于等于0的正整数，最大不要超过31536000。

两种防盗链类型说明如下：

typeA（加密字符串 md5hash 和时间戳 timestamp 都在URL的参数中）：
http://DomainName/FileName?t=timestamp&k=md5hash
typeB（加密字符串 md5hash 和时间戳 timestamp 都在URL的路径中，md5hash 在前时间戳在后）：http://DomainName/md5hash/timestamp/FileName

标准配置说明如下：

对于标准配置来说，防盗链的 timestamp 为十进制unix时间戳，单位是秒，如：1566299655；计算 md5hash 值的方法都为：md5（秘钥+URI+时间戳）
以 URL http://selftest.com/main2.css 为例
若配置 typeA的防盗链，key是 aaaaaaaaaaa ，timestamp 是 1566299655，其 URI是 /main2.css
那么 md5hash = md5（aaaaaaaaaaa/main2.css1566299655）= 2f24a0858b44959f095c7c7eb41c114d
上述条件下，该URL 鉴权后正常访问的URL是 http://selftest.com/main2.css?t=1566299655&k=2f24a0858b44959f095c7c7eb41c114d

示例

请求示例

GET方式：

GET /2016-09-01/domain/SetRequestAuthConfig?DomainId=2D09XC0&Enable=on& AuthType=typeA& Key1=qwerqyt& ExpirationTime=3600
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: SetRequestAuthConfig
x-version: 2016-09-01

POST方式:

POST /2016-09-01/domain/SetRequestAuthConfig
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: SetRequestAuthConfig
x-version: 2016-09-01
Content-Type: application/json

{
  "DomainId":"2D08M8V",
  "Enable":"on",
  "AuthType":"typeA",
  "Key1":"qwerqyt",
  "ExpirationTime":"3600"
}

返回示例

说明：本接口调用成功只会返回200的状态码，无返回值，若调用失败，则会返回403/400状态码，400的具体错误原因详见【使用须知】中错误代码表说明

文档导读

上一篇：设置高级回源

下一篇：设置HTTP 2.0

纯净模式常规模式

纯净模式

点击可全屏预览文档内容