一、配置原理
URL 鉴权的原理是云直播客户通过鉴权配置生成加密 URL,并将此 URL 提供给用户,用户采用加密 URL 对云直播加速节点发起请求后,直播加速节点对其权限信息进行校验以判断请求是否合法。若请求合法,将返回正常内容,若请求非法将被拒绝,以此实现对直播资源的保护。
二、注意事项
当你关闭 Key 鉴权后,你的直播服务可能面临被他人盗播的风险,从而产生额外的服务费用。为了保护你的直播内容安全,建议你保持 Key 鉴权配置状态开启。
三、前提条件
·已开通云直播服务,并登录 云直播控制台。
·已 添加播放域名。
四、开启Key鉴权
1. 选择 域名管理,单击需做鉴权配置的播放域名或管理,进入域名管理页。
2. 在访问控制 > Key鉴权,单击,选择开启 Key 鉴权。
3. 进入鉴权配置页,并进行如下配置:
| 配置项 | 说明 |
| 主KEY | 在配置鉴权主 Key 时,根据你的实际需求和安全策略,你可以选择系统随机生成一个主 Key,或者填写自定义的主 Key,例如:“test”。仅支持大写字母,小写字母和数字,最大长度256位。 |
| 备KEY | 在配置鉴权备 Key 时,根据你的实际需求和安全策略,你可以选择系统随机生成一个备 Key,或者填写自定义的备Key,例如:“testing”。仅支持大写字母,小写字母和数字,最大长度256位。 |
| 有效时间(秒) | 仅支持整数。填写签名有效时间,例如:20。 |
注意:说明:
4. 单击保存,即可保存配置。
五、修改Key鉴权
1. 选择 域名管理,单击需做鉴权配置的播放域名或管理,进入域名管理页。
2. 在访问控制 > Key 鉴权,单击编辑进入 Key 鉴权配置页。
3. 根据你的实际需求修改配置项信息,单击保存即可完成修改。
六、关闭 Key 鉴权
注意:在你选择关闭 Key 鉴权时,请确认你了解这可能会带来的风险。关闭 Key 鉴权后,你的直播服务可能会被他人盗播,从而产生额外的服务费用。因此,建议你保持 Key 鉴权的配置状态开启,以保护你的直播内容。
开启 Key 鉴权后,若你需关闭此功能,具体操作如下:
1. 选择 域名管理,单击需做鉴权配置的播放域名或管理,进入域名管理页。
2. 在访问控制 > Key鉴权,单击,选择关闭 Key 鉴权。
3. 在关闭 Key 鉴权之前,请再次确认你是否确实要执行此操作。如果你已经了解并接受这些风险,单击确定即可。
注意:开启播放域名的鉴权设置后,原有播放 URL 将无法直接访问,会返回403。开启此功能,请确保你的业务兼容以下鉴权算法,以免影响你的直播业务。
七、配置案例
若原始播放 URL 为:
对此域名配置鉴权时,参数如下:
主 Key:ngoeiq03备 Key:无有效时间:12495秒
时间戳计算:
设置时间:2018.12.01 08:30:00十进制 UNIX 时间戳:1543624200十六进制 UNIX 时间戳:5C01D608(云直播鉴权配置使用十六进制 UNIX 时间戳,十六进制不区分字母大小写)
鉴权签名计算:
txSecret = MD5(key+StreamName+txTime) StreamName 为流名称,与 StreamID 概念等同txTime 为时间戳key 为鉴权密钥txSecret = MD5(ngoeiq03+test01+5C01D608)txSecret = MD5(ngoeiq03test015C01D608)txSecret = ce797dc6238156d548ef945e6ad1ea20
新生成的播放 URL 为:
http://www.test.com/live/test01.flv?txSecret=ce797dc6238156d548ef945e6ad1ea20&txTime=5C01D608
此 URL 的有效时间截止到:2018.12.01 08:30:00 + 12495秒,即北京时间:2018.12.01 11:58:15。
若鉴权未通过或 URL 已失效,则云直播将返回403。