2.6 访问控制
2.6.5 URL 鉴权
2.6.5.2 鉴权方式 B
CDN分发的内容默认为公开资源,URL鉴权功能主要用于保护用户站点资源,防止资 源被用户恶意下载盗用。华为云CDN提供了4种URL鉴权配置。本章为您详细介绍鉴权 方式B的实现方式。
用户访问加密URL构成:
http://DomainName/timestamp/sha256/FileName http://DomainName/timestamp/md5hash/FileName
当鉴权通过时,实际回源的URL为:
http://DomainName/FileName
鉴权字段描述如下表所示:
字段 描述
DomainNam
e CDN加速域名。
timestamp 用户定义的有效访问时间起始点,格式为YYYYMMDDHHMM,
如:201706301000。
字段 描述
有效时间 鉴权有效的时间长度,取值为0~31536000s。
示例:如果设置有效时间为1800s,用户设置的timestamp为 2017-06-30 10:00:00,则链接在2017-06-30 10:30:00失效。
md5hash 通过md5算法计算出来的验证串,数字0-9和小写英文字母a-z混合 组成,固定长度32。
sha256 通过sha256算法计算出来的验证串,数字0-9和小写英文字母a-z混 合组成,固定长度32。
Filename 实际回源访问的URL,鉴权时Filename需以/开头。不包含?后面的 参数。
PrivateKey 用户设定的鉴权密钥,来生成加密URL。如huaweicloud123。密钥 的格式为大小写字母、数字,长度6到32。
校验方法
CDN服务器拿到请求后,会按照如下步骤进行校验:
1. 是否携带鉴权参数。如果没有携带鉴权参数,认为请求非法,返回HTTP 403错 误。
2. 时间校验:判断系统当前时间是否在区间[timestamp,timestamp+有效时间]
内。超出该区间,认为过期失效并返回HTTP 403错误。
3. 加密串校验:时间校验通过后,则以sstring方式构造出一个字符串(参考以下 sstring构造方式)。然后使用md5(sha256)算法算出HashValue,并和用户请 求中带来的md5hash(sha256)进行对比。结果一致则认为鉴权通过并返回文 件,否则鉴权失败返回HTTP 403错误。HashValue计算方式如下:
sstring = “PrivateKeytimestampFilename”
HashValue = sha256sum(sstring)
或:sstring = “PrivateKeytimestampFilename”
HashValue = md5sum(sstring)
操作步骤
1. 登录华为云控制台,在控制台首页中选择“CDN与智能边缘 > CDN”,进入CDN 控制台。
2. 在左侧菜单栏中,选择“域名管理”。
3. 在域名列表中,单击需要修改的域名或域名所在行的“设置”,进入域名配置页 面。
4. 选择“访问控制”页签,单击“URL鉴权配置”,进入配置弹窗。
5. 参照下表配置参数,单击“确定”,完成配置。
参数 说明
鉴权KEY 鉴权密码,6~32位大/小写字母、数字构成。
加密算法 用于信息加密的算法,可选MD5或SHA256。
有效时间长度 鉴权有效的时间长度,取值为0~31536000s。
鉴权计算器
鉴权计算器是为了方便您生成鉴权URL以供用户使用,根据参数提示设置不同的 参数后,单击“生成”即可生成鉴权URL和过期时间。
表2-6 参数说明
参数 说明
鉴权KEY 鉴权密码,6~32位大/小写字母、数字构成,与鉴权配置中的 密码一致。
访问路径 资源所在路径,以/开头,无需携带参数。
加密算法 用于信息加密的算法,可选MD5或SHA256。
开始时间 鉴权URL的生效起始时间。
有效时间长度 鉴权URL的有效时间,取值为0~31536000s。最大值为鉴权配 置中设置的有效时间。
示例:鉴权配置中设置的有效时间长度为1800秒,鉴权计算器 中设置2000秒,那么有效时间依然是1800秒。
说明
示例说明
以使用MD5算法为例:
1. 回源请求对象:
http://hwcdn.example.com/T128_2_1_0_sdk/0210/M00/82/3E/test.mp3
2. 密钥设为:huaweicloud123(用户自行设置)
3. 用户访问客户源服务器时间为:201706301000(格式为:YYYYMMDDHHMM)
4. CDN服务器构造一个用于计算md5hash的签名字符串:
huaweicloud123201706301000/T128_2_1_0_sdk/0210/M00/82/3E/test.mp3
5. CDN服务器根据该签名字符串计算md5hash:
md5hash = md5sum("huaweicloud123201706301000/T128_2_1_0_sdk/0210/M00/82/3E/test.mp3") = 51415b2256b64a9772a30edf69c00b08
6. 请求CDN时URL:
http://hwcdn.example.com/201706301000/51415b2256b64a9772a30edf69c00b08/T128_2_1_0_sdk/
0210/M00/82/3E/test.mp3
如果请求在有效时间内(2017年6月30日10:00:00-2017年6月30日10:30:00),并 且计算出来的md5hash与用户请求中带的md5hash值
(51415b2256b64a9772a30edf69c00b08)一致,则鉴权通过。