URL鉴权功能主要用于保护用户站点资源不被非法站点下载盗用。阿里云CDN为您提供了三种鉴权方式,本文为您详细介绍鉴权方式A的原理和示例说明。
原理说明
- 鉴权方式A加密URL构成
http://DomainName/Filename?auth_key=timestamp-rand-uid-md5hash
- 鉴权字段说明
字段 描述 DomainName CDN站点的域名。 Filename 实际回源访问的URL,鉴权时Filename需以正斜线( /
)开头。auth_key 您设定的鉴权密钥。 timestamp 签算服务器生成鉴权URL的时间,与鉴权URL有效时长共同控制鉴权URL的失效时间。时间点取自签算服务器的Unix时间戳(Unix时间戳是从UTC时间1970年01月01日00时00分00秒到现在的总秒数,是十进制的整型正数,固定长度为10,与时区无关)。 说明 多数情况下,鉴权URL的有效时长为CDN配置的鉴权URL有效时长。有时在签算增加鉴权URL的有效时长的,此时,timestamp=签算服务器上的Unix时间戳+签算服务器上加的有效时长;鉴权URL实际有效时长=timestamp+CDN配置的鉴权URL有效时长。rand 随机数。建议使用UUID,不能包含中划线(-),例如:477b3bbc253f467b8def6711128c7bec。 uid 用户ID,暂未使用,设置成0即可。 md5hash 通过MD5算法计算出的字符串,由数字0~9和小写英文字母a~z混合组成,固定长度为32。 md5hash
的值通过以下字符串计算得到。sstring = "URI-Timestamp-rand-uid-PrivateKey"(URI是用户的请求对象相对地址,不包含参数,如/Filename) md5hash = md5sum(sstring)
- 鉴权逻辑说明CDN服务器接到资源访问请求后,判断最终生成鉴权URL请求中的
timestamp
+鉴权URL有效时长
是否小于当前时间。- 如果
timestamp
+鉴权URL有效时长
小于当前时间,服务器判定过期失效,并返回HTTP 403错误。 - 如果
timestamp
+鉴权URL有效时长
大于当前时间,则以sstring
方式构造出一个字符串(参考表格中sstring
构造方式),然后使用MD5算法算出md5hash
的值,再将计算出的md5hash
值与用户访问请求中携带的md5hash
的值进行比对。- 结果一致,鉴权通过,返回资源请求。说明 当鉴权通过时,会去掉URL中与鉴权相关的那部分参数,可以提高缓存命中率,减少回源流量:
- 实际生成缓存key的URL格式:
http://DomainName/FileName
- 实际回源的URL格式:
http://DomainName/FileName
- 实际生成缓存key的URL格式:
- 结果不一致,鉴权失败,返回HTTP 403错误。
- 结果一致,鉴权通过,返回资源请求。
- 如果
鉴权URL示例
通过以下示例说明,您可以准确理解鉴权方式A的实现方式。
- 示例条件
- 回源请求对象:
http://cdn.example.com/video/standard/test.mp4
说明 如果您的回源请求对象中有中文汉字,请先对其进行URL转码(即Encode),再进行鉴权URL的拼接。 - 设置密钥为:aliyuncdnexp1234。
- 签算服务器生成鉴权URL的时间:2015年10月10日08:00:00(UTC+8),转换为十进制的整型数值为1444435200。
- 回源请求对象:
- 拼接流程
- CDN服务器构造出一个用于计算
md5hash
的签名字符串。/video/standard/test.mp4-1444435200-0-0-aliyuncdnexp1234
- 根据该签名字符串,CDN服务器会计算出
md5hash
。md5hash = md5sum("/video/standard/test.mp4-1444435200-0-0-aliyuncdnexp1234") = 23bf85053008f5c0e791667a313e28ce
- 生成鉴权URL。
http://cdn.example.com/video/standard/test.mp4?auth_key=1444435200-0-0-23bf85053008f5c0e791667a313e28ce
- CDN服务器构造出一个用于计算
当使用客户端提供的加密URL进行访问时,如果CDN服务器计算出来的md5hash
值与访问请求中带的md5hash
值相同,都为23bf85053008f5c0e791667a313e28ce,则鉴权通过,反之鉴权失败。