鉴权方式F说明

URL鉴权功能主要用于保护用户站点资源不被非法站点下载或盗用。阿里云CDN为您提供了四种鉴权方式,本文为您详细介绍鉴权方式F的原理和示例说明。

原理说明

  • 鉴权方式F加密URL构成

    访问URL格式:

    http://DomainName/FileName?{sign=<md5hash>&time=<timestamp>}
    说明
    • {}中的内容表示在标准URL基础上添加的加密信息。

    • 访问URL中不能包含中文。

    • 不支持包含?带参数的URL鉴权。

  • 鉴权字段说明

    字段

    描述

    DomainName

    CDN站点的域名。

    PrivateKey

    用户自定义鉴权key,由16~32个字符(支持大写字母、小写字母、数字)组成。

    FileName

    实际回源访问的URL,鉴权时Filename需以/开头。

    timestamp

    签算服务器生成鉴权URL的时间,与鉴权URL有效时长共同控制鉴权URL的失效时间。时间点取自签算服务器的Unix时间戳(Unix时间戳是从UTC时间1970年01月01日00时00分00秒到现在的总秒数,是十进制的整型正数,固定长度为10,与时区无关),以十六进制形式表示。

    说明

    多数情况下,鉴权URL的有效时长为CDN配置有效时长。有时在签算增加鉴权URL的有效时长的,此时,timestamp=Unix时间戳+增加的时长;鉴权URL实际有效时长=timestamp+CDN配置的时长。

    md5hash

    通过MD5算法计算出的字符串,由数字0~9和小写英文字母a~z混合组成,固定长度32。

    md5hash的值通过以下字符串计算得到。

    sstring = "Privatekey+URI+timestamp" (URI是用户的请求对象相对地址,不包含参数,如/Filename)
    md5hash = md5sum(sstring)
  • 鉴权逻辑说明

    CDN服务器接到资源访问请求后,判断最终生成鉴权URL请求中的timestamp+鉴权URL有效时长是否小于当前时间。

    • 如果timestamp+鉴权URL有效时长小于当前时间,服务器判定过期失效,并返回HTTP 403错误。

    • 如果timestamp+鉴权URL有效时长大于当前时间,则以string方式构造出一个字符串,然后使用MD5算法算出md5hash的值,再将计算出的md5hash值与用户访问请求中携带的md5hash的值进行比对。

      • 结果一致,鉴权通过,返回资源请求。

        说明

        当鉴权通过时,会去掉URL中与鉴权相关的那部分参数,可以提高缓存命中率,减少回源流量:

        • 格式1和格式2,实际生成缓存key的URL格式:http://DomainName/FileName

        • 格式1和格式2,实际回源的URL格式:http://DomainName/FileName

      • 结果不一致,鉴权失败,返回HTTP 403错误。

鉴权URL示例

通过以下示例说明,您可以准确理解鉴权方式F的实现方式。

  • 示例条件

    • 回源请求对象:

      http://domain.example.com/test.flv
      说明

      如果您的回源请求对象中有中文汉字,请先对其进行URL转码(即Encode),再进行鉴权URL的拼接。

      • 原始URL:https://example.com/image/阿里云.jpg

      • 编码后的URL:https://example.com/image/%E9%98%BF%E9%87%8C%E4%BA%91.jpg

    • PrivateKey取值:aliyuncdnexp1234

    • timestamp取值:55CE8100

  • 拼接流程

    1. CDN服务器构造一个用于计算md5hash的签名字符串。

      aliyuncdnexp1234/test.flv55CE8100
    2. 根据该签名字符串,CDN服务器会计算出md5hash

      md5hash = md5sum(aliyuncdnexp1234/test.flv55CE8100) = a37fa50a5fb8f71214b1e7c95ec7a1bd
    3. 生成鉴权URL。

      鉴权URL格式:

      http://domain.example.com/test.flv?sign=a37fa50a5fb8f71214b1e7c95ec7a1bd&time=55CE8100

当使用客户端提供的加密URL进行访问时,如果CDN服务器计算出来的md5hash值与访问请求中带的md5hash值相同,都为a37fa50a5fb8f71214b1e7c95ec7a1bd,并且鉴权URL在有效期内,则鉴权通过,反之鉴权失败。