接口規(guī)范 9. 推流認(rèn)證相關(guān)接口

9 推流認(rèn)證相關(guān)接口

9.1.開啟推流認(rèn)證

• 用途
  針對某個(gè)應(yīng)用，開啟推流認(rèn)證。
  開啟推流認(rèn)證后，所有向該應(yīng)用下的推送直播流的請求都需要做合法性認(rèn)證，只有認(rèn)證通過的請求才會允許推送。
  認(rèn)證的方法包括token認(rèn)證和第三方認(rèn)證。
  token認(rèn)證，就是為每個(gè)直播流配置一個(gè)認(rèn)證碼(token)，推流終端只有獲得該認(rèn)證碼，并將該認(rèn)證碼作為推流請求的參數(shù)提交，才能夠正常推送直播流。
  第三方認(rèn)證，就是將認(rèn)證請求轉(zhuǎn)交給第三方系統(tǒng)的服務(wù)接口去認(rèn)證，認(rèn)證通過后才允許推送直播流。開啟第三方認(rèn)證后，所有本地認(rèn)證策略會被忽略。

• 請求
  authMgr/?request=open_pub_auth&application=liveshow
  application 應(yīng)用名

• 響應(yīng)

  {
  "code":0
  }

9.2.關(guān)閉推流認(rèn)證

• 用途
  針對某個(gè)應(yīng)用，關(guān)閉推流認(rèn)證。關(guān)閉后向該應(yīng)用推送視頻流不需要做認(rèn)證。

• 請求
  authMgr/?request=close_pub_auth&application=liveshow
  application 應(yīng)用名

• 響應(yīng)

  {
  "code":0
  }

9.3.查詢推流token

• 用途
  查詢某個(gè)應(yīng)用下推流認(rèn)證token的列表。

• 請求
  authMgr/?request=list_pub_token&application=liveshow
  application 應(yīng)用名

• 響應(yīng)

  {
  "code":0,
  "data":{
      "count":1,
      "items":[
          {
              "application":"liveshow",
              "stream":"live1",
              "token":"9501E93993FC4D14",
              "use_once":0
          }
      ]
  }
  }

  items元素包含當(dāng)前應(yīng)用下的token定義。
  application 應(yīng)用名
  stream 流名稱
  token token值

9.4.添加推流token

• 用途
  為視頻流添加推流認(rèn)證token。

• 請求
  authMgr/?request=add_pub_token&application=liveshow&stream=live1&token_val=9501E93993FC4D14
  application 應(yīng)用名
  stream 流名稱
  token_val 添加的token值（注意這里使用token_val參數(shù)名，避免與接口認(rèn)證的token參數(shù)沖突）

• 響應(yīng)

  {
  "code":0
  }

9.5.刪除推流token

• 用途
  刪除某個(gè)視頻流的推流認(rèn)證token。

• 請求
  authMgr/?request=delete_pub_token&application=liveshow&stream=live1
  application 應(yīng)用名
  stream 流名稱

• 響應(yīng)

  {
  "code":0
  }

9.6.設(shè)置第三方推流認(rèn)證地址

• 用途
  將某個(gè)應(yīng)用下的推流認(rèn)證地址設(shè)置為一個(gè)第三方認(rèn)證地址。
  設(shè)置第三方認(rèn)證地址后，所有本地認(rèn)證策略失效。
  如果要取消第三方認(rèn)證，將url參數(shù)設(shè)置為空即可。

• 請求
  authMgr/?request=set_pub_auth_url&application=liveshow&url=http://i.ruiboyun.net/interface
  application 應(yīng)用名
  url 第三方認(rèn)證接口的url地址，本參數(shù)需要進(jìn)行【URL編碼】。

• 響應(yīng)

  {
  "code":0
  }