业务回调鉴权

业务可在控制台提供鉴权服务HTTP地址来发起指定的鉴权请求(如,视频流上行鉴权),开播时会将鉴权请求回调给业务服务器,实现自定义鉴权。业务回调鉴权适用于安全性要求极高的场景,如音视频流上行。

实现方法

前提条件

操作步骤

  1. 登录控制台
  2. 点击左侧导航栏,选择 项目管理
  3. 在操作栏点击鉴权图标,选择 业务鉴权
  4. 设置 鉴权模式 并输入 鉴权服务地址
    • 音频流上行:推送音频流时需业务鉴权。
    • 视频流上行:推送视频流时需业务鉴权。
    • 鉴权服务地址:需符合相关规则,详见 鉴权服务地址规范
  5. 点击 应用鉴权

鉴权服务地址规范

鉴权服务地址为HTTP协议格式,以下定义了业务回调鉴权的HTTP接口规范。

请求格式

字段说明
请求方法POST
HeadContent-Type: application/json;charset=UTF-8

请求参数(JSON)

字段说明类型
AppID项目ID32位无符号整型
roomId房间号字符串类型
uid用户ID字符串类型
ip用户IP(点分十进制)字符串类型
auth鉴权类型:65538-语音流上行、131074-视频流上行32位无符号整型
sendTime请求鉴权时间,UTC时间(1970年以来),单位:毫秒64位无符号整型
session鉴权代理会话ID字符串类型
tokenToken字符串类型

响应参数(JSON)

  • HTTP状态码:200-执行成功
  • 响应头:application/json
字段说明类型
code响应返回码32位无符号整型
message响应描述字符串类型
session鉴权代理会话ID,同请求内容的session字段字符串
expire鉴权结果失效时间点,UTC时间(1970年以来),单位:秒
注意:通过expire可以控制鉴权请求周期
32位无符号整形

响应返回码

编码说明备注
0成功成功
10000App Token 接口系统错误服务器内部错误,可以重试
10001App Token 不存在App Token 不存在
10002App Token 校验失败App Token 校验失败
10003AppID 参数不合法请求参数与Token中的App ID不一致
10004uid 参数不合法请求参数与Token中的uid不一致
10005App Token 过期App Token 过期
10006App不存在App不存在
10007Token即将要过期Token 在30s内过期
10008用户被封禁用户被封禁
10009参数异常参数异常

文档是否有解决您的问题?

有帮助 没帮助
提交成功,非常感谢您的反馈!

反馈

TOP