概览
本文档简要介绍了腾讯实时通信服务的两种认证方法,重点介绍 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 的源码文件,您可直接下载使用:
Android | iOS | Web | Windows(C++) | Windows(C#) | Flutter | Mac |
| | | | | | |
示例代码如下(当然您也可以参考我们各产品的 Demo 工程,详见各产品的开发文档):
import com.xxx.xxx.GenerateTestUserSig;
GenerateTestUserSig.SDKAPPID = xxxxxx;
GenerateTestUserSig.SECRETKEY = "xxxxxx";
String userSig = GenerateTestUserSig.genTestUserSig("userID");
#import "GenerateTestUserSig.h"
[GenerateTestUserSig setSDKAPPID:xxxxxx];
[GenerateTestUserSig setSECRETKEY:@"xxxxxx"];
NSString *userSig = [GenerateTestUserSig genTestUserSig:@"userID"];
<script src='js/libs/lib-generate-test-usersig.min.js'></script>
<script src='js/libs/generateTestUserSig.js'></script>
const {sdkAppId, userSig } = genTestUserSig({
sdkAppId: xxxxxx,
userId: 'xxxxxx',
sdkSecretKey: 'xxxxxx',
}
#include "GenerateTestUserSig.h"
const int SDKAPPID = xxxxxx;
const char* SECRETKEY = "xxxxxx";
const char* userSig = GenerateTestUserSig::genTestUserSig("userID", SDKAPPID, SECRETKEY);
using GenerateTestUserSig;
GenerateTestUserSig.SDKAPPID = xxxxxx;
GenerateTestUserSig.SECRETKEY = "xxxxxx";
string userSig = GenerateTestUserSig.GetInstance().GenTestUserSig("userID");
// Step1: 导入源码文件
import 'package:xxx/GenerateTestUserSig.dart';
// Step2: 填写上一步骤中获取到的 SDKAppID,SDK 密钥
GenerateTestUserSig.SDKAPPID = xxxxxx;
GenerateTestUserSig.SECRETKEY = "xxxxxx";
// Step3:根据 userID,生成 userSig
String userSig = GenerateTestUserSig.genTestUserSig("userID");
#import "GenerateTestUserSig.h"
[GenerateTestUserSig setSDKAPPID:xxxxxx];
[GenerateTestUserSig setSECRETKEY:@"xxxxxx"];
NSString *userSig = [GenerateTestUserSig genTestUserSig:@"userID"];
控制台获取 UserSig
在签名(UserSig)生成工具下,选择对应的 SDKAppID 和 UserID。
单击 Generate,即可计算得到对应的 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 计算源代码及其示例:
|
Java | HMAC-SHA256 | | |
GO | HMAC-SHA256 | | |
PHP | HMAC-SHA256 | | |
Node.js | HMAC-SHA256 | | |
Python | HMAC-SHA256 | | |
C# | HMAC-SHA256 | | |
本页内容是否解决了您的问题?