ApsaraVideo Live：推/播流地址鑒權

鑒權URL組成

鑒權URL適用於PC端、移動端、第三方推流和播放工具。由直播推流地址或播放地址+鑒權串組成，樣本如下：

rtmp://push.aliyundoc.com/app/stream?auth_key=1740562218-0-0-183e22e*********

參數auth_key即鑒權串。

timestamp-rand-uid-md5hash

使用方法

使用鑒權URL，需要推/播流網域名稱開啟URL鑒權功能（網域名稱初次添加時，預設已開啟URL鑒權，相關配置可參見URL鑒權配置）。鑒權URL可通過直播地址產生器或代碼自訂產生，具體資訊，可參見產生直播地址。

功能原理

當開啟URL鑒權功能後，伺服器擷取請求後會進行如下驗證：

1. 判斷請求中的失效時間是否小於目前時間。

   • 如果小於目前時間，則認為到期失效並返回HTTP 403錯誤。

   • 如果大於目前時間，則構造出一個同樣的字串（參見下文sstring構造方式）。

2. 使用MD5演算法算出HashValue，再和請求中帶來的md5hash進行比對。

   • 比對結果一致，則認為鑒權通過，返回直播流。

   • 否則鑒權失敗，返回HTTP 403錯誤。

sstring = "URI-timestamp-rand-uid-PrivateKey"
HashValue = md5sum(sstring)

注意事項

• 鑒權功能預設為開啟狀態，建議您保持預設開啟狀態，否則會出現直播被盜錄、盜播的風險。如果您想要關閉鑒權功能，需要瞭解盜刷風險並在控制台URL鑒權頁面簽署《關閉URL鑒權免責協議》。

• 鑒權功能預設為開啟狀態，但是配置鑒權auth_key參數必須需要業務端根據鑒權原理自行實現，暫時沒有提供API介面計算鑒權auth_key參數。

• 開啟鑒權後推流或播流地址均需要添加鑒權auth_key參數才可正常播放。暫時不支援僅推流或者播流一個地址開啟鑒權的功能。

• 鑒權URL提供的是到期時間戳記的限制，即在該時間段內該地址可以一直訪問，不會有任何限制，鑒權還無法實現設定某個URL僅能夠一次訪問的功能。

• 鑒權auth_key參數是根據去掉queryString後的URI計算MD5值後拼接得到的，參見前述設定鑒權參數小節。因此，推流和播流地址的URI均為AppName/StreamName。建議使用者商務邏輯中如果推流地址有泄漏的情況下設定到期時間戳記在業務功能內盡量短一些，避免播流地址被惡意訪問。

• 針對RTMP、FLV、RTS格式的推播流地址鑒權僅會在推流或者播流開始的時候進行驗證，在推流或者播流過程中不會驗證，即推流或者播流過程中如果超過了鑒權時間戳記也可以繼續播放。

• 針對M3U8格式的播流地址鑒權會在播流開始以及播流過程中進行驗證，即在播流過程中如果超過了鑒權時間戳記，M3U8格式的播流地址將不能正常播放。

• 若您需要動態控制URL鑒權設定有效期間的話，可通過相關SDK，以動態傳入AppName和StreamName的方式進行控制，並參考相關連結鑒權程式碼範例。

• auth_key 建置原則選擇：播放地址的 auth_key 支援預產生和即時產生兩種方式。無嚴格安全要求且需要在有效期間內複用播放地址的情境，可提前產生 auth_key，例如將 timestamp 設定為目前時間 + 7200 秒。需要降低 URL 泄露風險或按請求發放訪問授權的情境，建議每次請求播放地址時即時產生有效期間較短的 auth_key，例如將 timestamp 設定為目前時間 + 300 秒。M3U8 格式的播流地址在播流開始及播流過程中會持續驗證鑒權時效，建議採用即時建置原則，避免鑒權在播流過程中到期。

• 針對網路攝影機等無法遠程更新配置的固定IP推流裝置，若鑒權有效期間到期導致斷流，建議在安全性和可用性之間平衡設定有效期間，或改用推流IP白名單功能替代URL鑒權。

• 針對阿里雲即時音視頻ARTC協議，建議正式使用時務必開啟URL鑒權以防止資源被盜用產生額外費用；僅在臨時測試播放時可暫時關閉以確保地址可訪問。

• 推流網域名稱和播流網域名稱的鑒權主KEY可設定為相同值，推流地址和播流地址的鑒權及正常推流、播放均不受影響。鑒權主KEY長度建議不少於16位，控制台對不足8位的KEY會拒絕儲存並提示安全風險。

常見問題

$args = isset($matches[4]) ? $matches[4] : '';