产品动态
产品近期公告
关于 TRTC Live 正式上线的公告
关于TRTC Conference 正式版上线的公告
Conference 商业化版本即将推出
关于多人音视频 Conference 开启内测公告
关于音视频通话 Call 正式版上线的公告
关于腾讯云音视频终端 SDK 播放升级及新增授权校验的公告
关于 TRTC 应用订阅套餐服务上线的相关说明
UserSig 相关
概览
本文档简要介绍了腾讯实时通信服务的两种认证方法，重点介绍 UserSig——腾讯云设计的保护签名，防止恶意攻击者窃取云服务使用权。使用基础云服务时，在 SDK 初始化或登录过程中需提供 SDKAppID、UserID 和 UserSig 三项关键信息。
SDKAppID 用于标识您的应用。
UserID 用于标识您的用户。
UserSig 则是基于前两者计算出的安全签名，它由 HMAC SHA256 加密算法计算得出。只要攻击者不能伪造 UserSig，就无法盗用您的云服务流量。
在调试阶段如何计算 UserSig？
不安全：
注意，如下两种 UserSig 获取计算方案仅适用于调试，如果产品要正式上线，不推荐采用这种方案，因为客户端代码（尤其是 Web 端）中的 SECRETKEY 很容易被反编译逆向破解。一旦您的密钥泄露，攻击者就可以盗用您的腾讯云流量。
客户端计算 UserSig
1. 获取 SDKAPPID 和密钥：
登录 Tencent-RTC 控制台 > 应用管理。
找到您需查看的 SDKAppID 对应的应用后，点击应用名称进入详情；
点击 SDKSecretKey 显示并复制。
2. 计算 UserSig：
为了方便客户端使用，我们提供各平台计算 UserSig 的源码文件，您可直接下载使用：
示例代码如下（当然您也可以参考我们各产品的 Demo 工程，详见各产品的开发文档）：
// Step1: 导入源码文件import com.xxx.xxx.GenerateTestUserSig;// Step2：填写上一步骤中获取到的 SDKAppID，SDK 密钥GenerateTestUserSig.SDKAPPID = xxxxxx; GenerateTestUserSig.SECRETKEY = "xxxxxx";// Step3：根据 userID，生成 userSig String userSig = GenerateTestUserSig.genTestUserSig("userID");
// Step1: 导入头文件#import "GenerateTestUserSig.h"// Step2: 填写上一步骤中获取到的 SDKAppID，SDK 密钥[GenerateTestUserSig setSDKAPPID:xxxxxx];[GenerateTestUserSig setSECRETKEY:@"xxxxxx"];// Step3：根据 userID，生成 userSigNSString *userSig = [GenerateTestUserSig genTestUserSig:@"userID"];
// Step1: 导入模块<script src='js/libs/lib-generate-test-usersig.min.js'></script><script src='js/libs/generateTestUserSig.js'></script>// Step2：填写上一步骤中获取到的 SDKAppID，SDK 密钥、输入自定义的userID，生成 userSigconst {sdkAppId, userSig } = genTestUserSig({sdkAppId: xxxxxx,userId: 'xxxxxx',sdkSecretKey: 'xxxxxx',}
// Step1: 导入头文件#include "GenerateTestUserSig.h"// Step2：填写上一步骤中获取到的 SDKAppID，SDK 密钥const int SDKAPPID = xxxxxx;const char* SECRETKEY = "xxxxxx";// Step3：根据 userID，生成 userSigconst char* userSig = GenerateTestUserSig::genTestUserSig("userID", SDKAPPID, SECRETKEY);
// Step1: 导入头文件using GenerateTestUserSig;// Step2: 填写上一步骤中获取到的 SDKAppID 和 SDK 密钥GenerateTestUserSig.SDKAPPID = xxxxxx;GenerateTestUserSig.SECRETKEY = "xxxxxx";// Step3：根据 userID，生成 userSigstring userSig = GenerateTestUserSig.GetInstance().GenTestUserSig("userID");
// Step1: 导入源码文件import 'package:xxx/GenerateTestUserSig.dart';// Step2: 填写上一步骤中获取到的 SDKAppID，SDK 密钥GenerateTestUserSig.SDKAPPID = xxxxxx;GenerateTestUserSig.SECRETKEY = "xxxxxx";// Step3：根据 userID，生成 userSigString userSig = GenerateTestUserSig.genTestUserSig("userID");
// Step1: 导入头文件#import "GenerateTestUserSig.h"// Step2: 填写上一步骤中获取到的 SDKAppID，SDK 密钥[GenerateTestUserSig setSDKAPPID:xxxxxx];[GenerateTestUserSig setSECRETKEY:@"xxxxxx"];// Step3：根据 userID，生成 userSigNSString *userSig = [GenerateTestUserSig genTestUserSig:@"userID"];
控制台获取 UserSig
登录 Tencent-RTC 控制台，进入 Development Tools > UserSig Tools。
在签名（UserSig）生成工具下，选择对应的 SDKAppID 和 UserID。
单击 Generate，即可计算得到对应的 UserSig。
在正式运行阶段如何计算 UserSig？
业务正式运行阶段，Tencent-RTC 提供安全等级更高的服务端计算 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. 校验通过后，会向该 SDK 提供服务。
为了简化您的实现过程，我们提供了多个语言版本的 UserSig 计算源代码及其示例：
文档反馈