全部產品
Search
文件中心

ApsaraVideo VOD:鑒權方式C說明

更新時間:Jul 13, 2024

URL鑒權功能主要用於保護使用者網站資源不被非法網站下載或盜用。ApsaraVideo for VOD的URL鑒權提供了三種鑒權方式,本文為您詳細介紹鑒權方式C的原理和樣本說明。

原理說明

鑒權方式C加密URL構成

  • 格式1

    http://DomainName/{<md5hash>/<timestamp>}/FileName
  • 格式2

    http://DomainName/FileName?{&KEY1=<md5hash>&KEY2=<timestamp>}
說明

{}中的內容表示在標準URL基礎上添加的加密資訊。

鑒權欄位說明

欄位

描述

DomainName

ApsaraVideo for VOD中接入的網域名稱。

PrivateKey

使用者自訂鑒權key,ApsaraVideo for VOD控制台配置的主Key或備Key,二者皆可。配置方法請參見開啟鑒權並配置鑒權URL

Filename

實際回源訪問的URL,鑒權時Filename需以正斜線(/)開頭。

timestamp

簽算伺服器產生鑒權URL的時間,與預設有效時間長度共同控制鑒權URL的失效時間。時間點取自簽算伺服器的Unix時間戳記(Unix時間戳記是從UTC時間1970年01月01日00時00分00秒到現在的總秒數,是十進位的整型正數,固定長度為10,與時區不轉換),以十六進位形式表示。

說明

多數情況下,鑒權URL的實際有效時間長度為ApsaraVideo for VOD中配置的預設有效時間長度。有時在簽算伺服器上增加了鑒權URL的有效時間長度情況下,此時,timestamp=簽算伺服器上的Unix時間戳記+簽算伺服器上增加的有效時間長度;鑒權URL實際有效時間長度=timestamp+點播配置的鑒權URL的預設有效時間長度

md5hash

通過MD5演算法計算出的驗證字串。由數字0~9和小寫英文字母a~z混合組成,固定長度為32。

md5hash的值通過以下字串計算得到。

sstring = "Privatekey+URI+timestamp" (URI是使用者的請求對象相對位址,不包含參數,如/Filename)
md5hash = md5sum(sstring)

鑒權邏輯說明

CDN伺服器接到資源訪問請求後,判斷最終產生鑒權URL請求中的timestamp+點播控制台URL鑒權中配置的預設有效時間長度是否小於目前時間。

  • 如果timestamp+預設有效時間長度小於目前時間,伺服器判定到期失效,並返回HTTP 403錯誤。

  • 如果timestamp+預設有效時間長度大於目前時間,則以sstring方式構造出一個字串,然後使用MD5演算法算出md5hash的值,再將計算出的md5hash值與使用者訪問請求中攜帶的md5hash的值進行比對。

    • 結果一致,鑒權通過,返回資源請求。

      說明

      當鑒權通過時,會去掉URL中與鑒權相關的那部分參數,可以提高快取命中率,減少回源流量:

      • 格式1和格式2,實際產生緩衝key的URL格式:http://DomainName/FileName

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

    • 結果不一致,鑒權失敗,返回HTTP 403錯誤。

鑒權URL樣本

通過以下樣本說明,您可以準確理解鑒權方式C的實現方式。

樣本條件

  • 回源請求對象:

    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。

    • 格式一:

      http://domain.example.com/a37fa50a5fb8f71214b1e7c95ec7a1bd/55CE8100/test.flv
    • 格式二:

      http://domain.example.com/test.flv?KEY1=a37fa50a5fb8f71214b1e7c95ec7a1bd&KEY2=55CE8100

當使用用戶端提供的加密URL進行訪問時,如果CDN伺服器計算出來的md5hash值與訪問請求中帶的md5hash值相同,都為a37fa50a5fb8f71214b1e7c95ec7a1bd,則鑒權通過,反之鑒權失敗。