音视频终端 SDK(腾讯云视立方) 生成 UserSig 签名

一、UserSig 介绍

其中 SDKAppID 用于标识你的应用，UserID 用于标识你的用户，而 UserSig 则是基于前两者计算出的安全签名，它由 HMAC SHA256 加密算法计算得出。只要攻击者不能伪造 UserSig，就无法盗用你的云服务流量。

UserSig 的计算原理如下所示，其本质就是对 SDKAppID、UserID 和 ExpireTime 等关键信息进行了一次哈希加密：

//UserSig 计算公式，其中 secretkey 为计算 usersig 用的加密密钥usersig = hmacsha256(secretkey, (userid + sdkappid + currtime + expire + base64(userid + sdkappid + currtime + expire)))

二、密钥获取

访问 云直播控制台 > 应用管理 可以查询计算 UserSig 用的密钥，方法如下：

1. 选择一个应用并进入详情页面，如果还没有应用就创建一个。

2. 进入应用管理页面，单击查看密钥按钮即可获得加密密钥。


三、客户端计算

我们在 IM SDK 的示例代码中提供了一个叫做GenerateTestUserSig的开源模块，你只需要将其中的 SDKAPPID、EXPIRETIME 和 SECRETKEY 三个成员变量修改成你自己的配置，就可以调用genTestUserSig()函数获取计算好的 UserSig，从而快速跑通 SDK 的相关功能：

注意：该方案仅适用于调试，如果产品要正式上线，不推荐采用这种方案，因为客户端代码（尤其是 Web 端）中的 SECRETKEY 很容易被反编译逆向破解。一旦你的密钥泄露，攻击者就可以盗用你的腾讯云流量。

注意：正确的做法是将 UserSig 的计算代码放在你的业务服务器上，然后由你的 App 在需要的时候向你的服务器获取实时算出的 UserSig。

四、服务端计算

采用服务端计算 UserSig 的方案，可以最大限度地保障计算 UserSig 用的密钥不被泄露，因为攻破一台服务器的难度要高于逆向一款 App。具体的做法如下：

1. 你的 App 在调用 SDK 的初始化函数之前，首先要向你的服务器请求 UserSig。

2. 你的服务器根据 SDKAppID 和 UserID 计算 UserSig，计算源码见文档前半部分。

3. 服务器将计算好的 UserSig 返回给你的 App。

4. 你的 App 将获得的 UserSig 通过特定 API 传递给 SDK。

5. SDK 将 SDKAppID + UserID + UserSig 提交给腾讯云服务器进行校验。

6. 腾讯云校验 UserSig，确认合法性。

7. 校验通过后，会向 TRTCSDK 提供实时音视频服务。

为了简化你的实现过程，我们提供了多个语言版本的 UserSig 计算源代码：

五、老版本算法

为了简化签名计算难度，方便客户更快速地使用腾讯云服务，即时通信 IM 服务自2019-08-06开始启用新的签名算法，从之前的 ECDSA-SHA256 升级为 HMAC-SHA256，也就是从2019-08-06之后创建的 SDKAppID 均会采用新的 HMAC-SHA256 算法。

如果你的 SDKAppID 是2019-07-19之前创建的，可以继续使用老版本的签名算法，算法的源码下载链接如下：