全部產品
Search
文件中心

ApsaraVideo Live:配置推流回調地址

更新時間:Oct 31, 2024

ApsaraVideo for Live支援配置推流回調地址、對推流回調地址鑒權,避免越權造成直播異常。本文介紹配置推流回調地址及其鑒權的具體操作。

推流回調地址

如果您需要接收推流相關的回調訊息,請參考以下步驟配置推流回調地址及回調鑒權:

說明

關於回調邏輯和回調鑒權說明,請參考回調邏輯說明回調鑒權說明

  1. 登入ApsaraVideo for Live控制台
  2. 在左側導覽列單擊推/播流網域名稱管理,進入網域名稱管理頁面。

  3. 選擇您要配置的推流網域名稱,單擊網域名稱配置

  4. 進入直播管理 > 基本配置頁面,單擊推流資訊頁簽。

  5. 單擊推流回調地址的編輯表徵圖,開啟回調設定小視窗。

    回調地址中文

  6. 回調設定小視窗完成推流回調地址配置。

    1. 輸入推流回調地址。

    2. 選擇是否為推流回調地址開啟鑒權。

      如需鑒權,開啟鑒權開關,輸入鑒權KEY,再單擊確定完成配置。推流回調健全KEY

      如無需鑒權,直接單擊確定完成配置。

      推流回調鑒權NO

回調邏輯說明

直播推流狀態回調中開播(publish)狀態回調邏輯

  1. RTMP推流在阿里雲直播服務收到On Publish訊息後2秒內,如果推流端不主動斷開,阿里雲直播服務就會發推流成功回調。

  2. 假設您有推流網域名稱A和播流網域名稱B,如果您的網域名稱B使用拉流直播(固定拉流和觸發回源拉流)需要回調,請在網域名稱A配置推流回調。配置後網域名稱B的拉流回調邏輯與上一條一致,建聯後預設2秒無主動斷開即認為拉流成功。

說明

建議業務方不僅根據回調通知判斷推流、拉流接入正常,同時配合查詢網域名稱線上流列表介面查詢推流正常後,再下發直播流播放地址。

回調鑒權說明

推流回調鑒權功能預設關閉,使用者可在配置推流回調地址時啟用鑒權。啟用功能後,鑒權邏輯如下:

  1. 阿里雲ApsaraVideo for Live發起回調請求時在HTTP(S)要求標頭中帶上ALI-LIVE-TIMESTAMPALI-LIVE-SIGNATURE 欄位,供回調訊息接收服務端進行簽名認證。其中,ALI-LIVE-SIGNATURE的值由如下計算而得:

    ALI-LIVE-SIGNATURE=MD5SUM(MD5CONTENT)

    MD5CONTENT=推流網域名稱|ALI-LIVE-TIMESTAMP取值|鑒權KEY

    說明

    回調網域名稱指配置回調URL的推流網域名稱。鑒權Key指使用者為推流回調URL配置的鑒權Key。

  2. 回調訊息接收服務端接收回調訊息時,將回調網域名稱、ALI-LIVE-TIMESTAMP取值、鑒權Key進行拼接後計算MD5值,得到加密字串,再將計算出的加密字串與ApsaraVideo for Live發起的HTTP(S)要求標頭中的ALI-LIVE-SIGNATURE欄位值進行對比。如果不一致,則請求非法。