Administrator
发布于 2025-11-28 / 4 阅读
0
0

Hyper CDN之URL鉴权说明

为保护您的站点资源不被非法站点下载盗用,您可按需选择四种鉴权方式的某一种,本文为您详细介绍各个模式的各个参数字段和原理。

鉴权字段说明

使用以下字段示例介绍鉴权模式

字段

说明

原始 URL

未添加鉴权参数的原始 URL ,示例为:http://www.example.com/example.jpg

DomainName

CDN 域名,示例为:www.example.com

Filename

资源访问路径,鉴权时 Filename 需以正斜线( / )开头,示例为:/example.jpg

timestamp

服务端生成鉴权 URL 的时间,使用十进制整型正数的 Unix 时间戳,示例为:2020年02月27日16:10:32(UTC+8),转换为十进制的整形数值为:1582791032(timestamp),转换为十六进制的整形数值为:5e577978(timestamp),不同模式使用的格式不同

模式一:使用十进制整型正数的 Unix 时间戳
模式二:使用十进制(YYYYMMDDHHMM)格式
模式三:使用十六进制(Unix 时间戳)
模式四:可选十或十六进制(Unix 时间戳)

rand

随机字符串,0 - 100位随机字符串,由大小写字母与数字组成。示例为:bexTIBz4n6xwKeavmnHyBE2VBbvzrL

pkey

自定义密钥:由6 - 128位大小写字母、数字构成,示例为:AUzTvavi33zKjw6Bn7hXk

uri

资源访问路径以正斜线(/)开头,示例为:/example.jpg

md5hash

通过 MD5 算法计算出的固定长度为32位的字符串,每种模式 md5hash 计算方式不同
模式一:md5sum(uri-timestamp-rand-pkey)

模式二:md5sum(pkeytimestampuri)
模式三:md5sum(pkeyuritimestamp)

模式四:md5sum(pkeyuritimestamp)

缓存策略

节点进行资源缓存时,自动忽略对应的鉴权参数进行缓存。

回源策略

鉴权通过后,如果未命中 CDN 节点,节点会发起回源请求,回源请求会去除鉴权参数。

模式一:

访问URL格式:http://DomainName/Filename?sign=timestamp-rand-md5hash

示例配置如下

参数

鉴权密钥

AUzTvavi33zKjw6Bn7hXk

签名参数

sign

有效时间

100s

鉴权范围

所有文件

计算签名串的 md5 值

md5hash=md5sum(uri-timestamp-rand-pkey)=md5sum(/example.jpg-1582791032-bexTIBz4n6xwKeavmnHyBE2VBbvzrL-AUzTvavi33zKjw6Bn7hXk)=7622a3ef7af0bea53b1d33d0de025ea4

生成鉴权 URL

http://www.example.com/example.jpg?sign=1582791032-bexTIBz4n6xwKeavmnHyBE2VBbvzrL-7622a3ef7af0bea53b1d33d0de025ea4

鉴权逻辑说明

当客户端通过加密 URL 进行访问时,如果 CDN 服务器计算出来的 md5hash 值与访问请求中带的 md5hash 值相同,都为:7622a3ef7af0bea53b1d33d0de025ea4,则鉴权通过,反之鉴权失败,返回错误码 403。

模式二:

访问URL格式:http://DomainName/timestamp/md5hash/Filename

示例配置如下

参数

鉴权密钥

AUzTvavi33zKjw6Bn7hXk

有效时间

100s

鉴权范围

所有文件

计算签名串的 md5 值

md5hash=md5sum(pkeytimestampuri)=md5sum(AUzTvavi33zKjw6Bn7hXk202002271610/example.jpg)=a22e99efcbe816208b2d7d6c4236b44e

生成鉴权URL

http://www.example.com/202002271610/a22e99efcbe816208b2d7d6c4236b44e/example.jpg

鉴权逻辑说明

当客户端通过加密 URL 进行访问时,如果 CDN 服务器计算出来的 md5hash 值与访问请求中带的 md5hash 值相同,都为:a22e99efcbe816208b2d7d6c4236b44e,则鉴权通过,反之鉴权失败,返回错误码 403。

模式三

访问URL格式:http://DomainName/md5hash/timestamp/Filename

示例配置如下

参数

鉴权密钥

AUzTvavi33zKjw6Bn7hXk

有效时间

100s

鉴权范围

所有文件

计算签名串的 md5 值

md5hash=md5sum(pkeyuritimestamp)=md5sum(AUzTvavi33zKjw6Bn7hXkexample.jpg5e577978)=0fa9ad3e92b381941ca3a12c5b918a1a

生成鉴权 URL

http://www.example.com/0fa9ad3e92b381941ca3a12c5b918a1a/5e577978/example.jpg

鉴权逻辑说明

当客户端通过加密 URL 进行访问时,如果 CDN 服务器计算出来的 md5hash 值与访问请求中带的 md5hash 值相同,都为:0fa9ad3e92b381941ca3a12c5b918a1a,则鉴权通过,反之鉴权失败,返回错误码 403。

模式四

访问URL格式:http://DomainName/Filename?sign=md5hash&t=timestamp

示例配置如下

参数

鉴权密钥

AUzTvavi33zKjw6Bn7hXk

签名参数

sign

有效时间

100s

时间戳参数名

time

时间格式

十进制(Unix 时间戳)

鉴权范围

所有文件

计算签名串的 md5 值

md5hash=md5sum(pkeyuritimestamp)=md5sum(AUzTvavi33zKjw6Bn7hXk/example.jpg1582791032)=d16990ff0fd402525107e4412e11b640

生成鉴权 URL

http://www.example.com//example.jpg?sign=d16990ff0fd402525107e4412e11b640&time=1582791032

鉴权逻辑说明

当客户端通过加密 URL 进行访问时,如果 CDN 服务器计算出来的 md5hash 值与访问请求中带的 md5hash 值相同,都为:d16990ff0fd402525107e4412e11b640,则鉴权通过,反之鉴权失败,返回错误码 403。



联系邮箱:sales@99cdn.com

授权平台:www.99cdn.com

云平台:www.vmrack.com


评论