接口规范 9. 推流认证相关接口

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
  }