9 推流認證相關接口
9.1.開啓推流認證
-
用途
針對某個應用,開啓推流認證。
開啓推流認證後,所有向該應用下的推送直播流的請求都需要做合法性認證,只有認證通過的請求才會允許推送。
認證的方法包括token認證和第三方認證。
token認證,就是爲每個直播流配置一個認證碼(token),推流終端只有獲得該認證碼,並將該認證碼作爲推流請求的參數提交,才能夠正常推送直播流。
第三方認證,就是將認證請求轉交給第三方系統的服務接口去認證,認證通過後才允許推送直播流。開啓第三方認證後,所有本地認證策略會被忽略。 -
請求
authMgr/?request=open_pub_auth&application=liveshow
application 應用名 - 響應
{ "code":0 }
9.2.關閉推流認證
- 用途
針對某個應用,關閉推流認證。關閉後向該應用推送視頻流不需要做認證。 -
請求
authMgr/?request=close_pub_auth&application=liveshow
application 應用名 - 響應
{ "code":0 }
9.3.查詢推流token
-
用途
查詢某個應用下推流認證token的列表。 -
請求
authMgr/?request=list_pub_token&application=liveshow
application 應用名 - 響應
{ "code":0, "data":{ "count":1, "items":[ { "application":"liveshow", "stream":"live1", "token":"9501E93993FC4D14", "use_once":0 } ] } }
items元素包含當前應用下的token定義。
application 應用名
stream 流名稱
token token值
9.4.添加推流token
- 用途
爲視頻流添加推流認證token。 -
請求
authMgr/?request=add_pub_token&application=liveshow&stream=live1&token_val=9501E93993FC4D14
application 應用名
stream 流名稱
token_val 添加的token值(注意這裏使用token_val參數名,避免與接口認證的token參數衝突) - 響應
{ "code":0 }
9.5.刪除推流token
-
用途
刪除某個視頻流的推流認證token。 -
請求
authMgr/?request=delete_pub_token&application=liveshow&stream=live1
application 應用名
stream 流名稱 - 響應
{ "code":0 }
9.6.設置第三方推流認證地址
-
用途
將某個應用下的推流認證地址設置爲一個第三方認證地址。
設置第三方認證地址後,所有本地認證策略失效。
如果要取消第三方認證,將url參數設置爲空即可。 -
請求
authMgr/?request=set_pub_auth_url&application=liveshow&url=http://i.ruiboyun.net/interface
application 應用名
url 第三方認證接口的url地址,本參數需要進行【URL編碼】。 - 響應
{ "code":0 }