回源鉴权功能使用说明：凭证管理模式

1 功能简介

回源鉴权是一种保护用户视频内容安全的功能。通过使用回源鉴权功能，用户可实时自行生成视频文件播放链接，该链接在用户指定时间内可用，从而有效保护视频内容。如果在使用回源鉴权功能之前，用户已经发布了播放地址，则在使用回源鉴权功能后，之前的播放地址不可用。用户需要通过动态生成链接以访问视频文件。

2 功能逻辑

此回源鉴权方式使用了网易云信提供的凭证管理API，以下是基本逻辑。

3 具体步骤

主要步骤如下所示：

第一步：开通功能

用户可联系网易云信视频确认开通回源鉴权功能。

第二步：创建视频播放凭证

用户可通过凭证管理 API 创建、更新、获取视频的播放凭证，从而用于分发给视频请求方。凭证管理 API 如下所示。

注：凭证管理 API 的请求方式（均为POST）、请求头信息，和网易云信视频点播服务端API相同。

4 API

4.1 凭证添加

4.1.1 接口描述

域名：vcloud.163.com

接口名：/app/authorization/add

用于添加视频的播放凭证。

4.1.2 输入参数

4.1.3 输出参数

4.1.4 响应状态码

4.1.5 示例代码

输入1

curl -X POST -H "Content-Type: application/json;charset=utf-8" -H "AppKey: 027338bf05cc4a65b5d98bc9d6af80b3" -H "Nonce: 1" -H "CurTime: 1465723418" -H "CheckSum: 61bbfd88c51028a2a28b3628584e65a2abe7ae13" -d'{"resId":"027338bf05cc4a65b5d98bc9d6af80b3_1300_0","expirationTime":"1476892800","randSeed":"1234567890"}' https://vcloud.163.com/app/authorization/add

输出1

{
    "ret" : {
        "type" : 1,
        "playToken" : "U/lVbNvo5av2xKDk15Re7Z3uOxiwXQhhBSt6LxSExIc="
    },
    "code" : 200
}

4.2 凭证更新

4.2.1 接口描述

域名：vcloud.163.com

接口名：/app/authorization/update

用于更新视频的播放凭证。

4.2.2 输入参数

4.2.3 输出参数

4.2.4 响应状态码

4.2.5 示例代码

输入1

curl -X POST -H "Content-Type: application/json;charset=utf-8" -H "AppKey: 027338bf05cc4a65b5d98bc9d6af80b3" -H "Nonce: 1" -H "CurTime: 1465723418" -H "CheckSum: 61bbfd88c51028a2a28b3628584e65a2abe7ae13" -d'{"resId":"027338bf05cc4a65b5d98bc9d6af80b3_1300_0","expirationTime":"1476792800","randSeed":"1254567890"}' https://vcloud.163.com/app/authorization/update

输出1

{
    "ret" : {
        "type" : 1,
        "playToken" : "U/lVbNvo5av2xKDk15Re7Z3uOxiwXQhhBSt6LxSExIc="
    },
    "code" : 200
}

4.3 凭证获取

4.3.1 接口描述

域名：vcloud.163.com

接口名：/app/authorization/get

用于获取视频的播放凭证。

4.3.2 输入参数

4.3.3 输出参数

4.3.4 响应状态码

4.3.5 示例代码

输入1

curl -X POST -H "Content-Type: application/json;charset=utf-8" -H "AppKey: 027338bf05cc4a65b5d98bc9d6af80b3" -H "Nonce: 1" -H "CurTime: 1465723418" -H "CheckSum: 61bbfd88c51028a2a28b3628584e65a2abe7ae13" -d'{"resId":"027338bf05cc4a65b5d98bc9d6af80b3_1300_0"}' https://vcloud.163.com/app/authorization/get

输出1

{
    "ret" : {
        "type" : 1,
        "playToken" : "U/lVbNvo5av2xKDk15Re7Z3uOxiwXQhhBSt6LxSExIc="
    },
    "code" : 200
}

5 生成播放地址

最终文件的播放地址生成过程如下：

• 通过获取视频文件信息 API 获取视频的原始播放地址，比如：originAddr = "http://vodk32ywxdf.vod.126.net/vodk32ywxdf/da9644d1-2dc5-40e3-9fbb-2b40d4267518.mp4"；
• 通过凭证管理 API 获取视频的播放凭证，playToken值即为sign值，比如：resId = "05d93b4f9dc742c5bf28aceaa6ff8de0_38_6" 和 sign = "U/lVbNvo5av2xKDk15Re7Z3uOxiwXQhhBSt6LxSExIc="；
• 拼接 resId 和 sign 参数，比如：param = "resId=URLEncode(05d93b4f9dc742c5bf28aceaa6ff8de0_38_6)&sign=URLEncode(U/lVbNvo5av2xKDk15Re7Z3uOxiwXQhhBSt6LxSExIc=)" = "resId=05d93b4f9dc742c5bf28aceaa6ff8de0_38_6&sign=U%2FlVbNvo5av2xKDk15Re7Z3uOxiwXQhhBSt6LxSExIc%3D"；
• 最终生成的播放地址为原始播放地址带上 resId 和 sign 经过url编码的参数，比如：url = "http://vodk32ywxdf.vod.126.net/vodk32ywxdf/da9644d1-2dc5-40e3-9fbb-2b40d4267518.mp4?resId=05d93b4f9dc742c5bf28aceaa6ff8de0_38_6&sign=U%2FlVbNvo5av2xKDk15Re7Z3uOxiwXQhhBSt6LxSExIc%3D"。

本篇文档内容是否对您有帮助？

有帮助 我要吐槽

如果遇到产品相关问题，您可 提交工单 或 在线客服 寻求帮助。

此文档对你是否有帮助

×

有帮助 我要吐槽

×

反馈成功

非常感谢您的反馈，我们会继续努力做得更好。

确定