CDN

设置时间戳+共享密钥防盗链

最近更新时间:2019-10-10 17:28:53

SetRequestAuthConfig

描述

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

注意:

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

请求语法

本接口请求需包含公共请求header和该接口所特有的请求参数,具体请求语句参照下文请求示例。

请求头

参数名 必选 类型及范围 说明
X-Version String 版本号,取值:2016-09-01
X-Action String 操作接口名,取值:SetRequestAuthConfig

请求参数

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

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

  1. typeA(加密字符串 md5hash 和 时间戳 timestamp 都在URL的参数中):http://DomainName/FileName?{t=timestamp&k=md5hash} 。
  2. 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是 /download/main2.css 。 那么 md5hash = md5(aaaaaaaaaaa/main2.css1566299655) = 292a582af13f28923c878aacb7ed39bd 。
  • 上述条件下,该URL 鉴权后正常访问的URL是 http://selftest.com/download/main2.css?t=1566299655&k=292a582af13f28923c878aacb7ed39bd

示例

请求示例

GET方式:

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

POST方式:


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

DomainId=2D09XC0&Enable=on&AuthType=typeA& Key1=qwerqyt&ExpirationTime=3600

金山云,开启您的云计算之旅

注册有礼