业务可在控制台提供鉴权服务HTTP地址来发起指定的鉴权请求(如,视频流上行鉴权),开播时会将鉴权请求回调给业务服务器,实现自定义鉴权。业务回调鉴权适用于安全性要求极高的场景,如音视频流上行。
前提条件
操作步骤
鉴权服务地址为HTTP协议格式,以下定义了业务回调鉴权的HTTP接口规范。
字段 | 说明 |
---|---|
请求方法 | POST |
Head | Content-Type: application/json;charset=UTF-8 |
字段 | 说明 | 类型 |
---|---|---|
AppID | 项目ID | 32位无符号整型 |
roomId | 房间号 | 字符串类型 |
uid | 用户ID | 字符串类型 |
ip | 用户IP(点分十进制) | 字符串类型 |
auth | 鉴权类型:65538-语音流上行、131074-视频流上行 | 32位无符号整型 |
sendTime | 请求鉴权时间,UTC时间(1970年以来),单位:毫秒 | 64位无符号整型 |
session | 鉴权代理会话ID | 字符串类型 |
token | Token | 字符串类型 |
字段 | 说明 | 类型 |
---|---|---|
code | 响应返回码 | 32位无符号整型 |
message | 响应描述 | 字符串类型 |
session | 鉴权代理会话ID,同请求内容的session字段 | 字符串 |
expire | 鉴权结果失效时间点,UTC时间(1970年以来),单位:秒 注意:通过expire可以控制鉴权请求周期 | 32位无符号整形 |
编码 | 说明 | 备注 |
---|---|---|
0 | 成功 | 成功 |
10000 | App Token 接口系统错误 | 服务器内部错误,可以重试 |
10001 | App Token 不存在 | App Token 不存在 |
10002 | App Token 校验失败 | App Token 校验失败 |
10003 | AppID 参数不合法 | 请求参数与Token中的App ID不一致 |
10004 | uid 参数不合法 | 请求参数与Token中的uid不一致 |
10005 | App Token 过期 | App Token 过期 |
10006 | App不存在 | App不存在 |
10007 | Token即将要过期 | Token 在30s内过期 |
10008 | 用户被封禁 | 用户被封禁 |
10009 | 参数异常 | 参数异常 |