12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758 |
- import LibGenerateTestUserSig from './lib-generate-test-usersig-es.min.js';
- /**
- * Signature expiration time, which should not be too short
- * Time unit: second
- * Default time: 7 * 24 * 60 * 60 = 604800 = 7days
- *
- * 签名过期时间,建议不要设置的过短
- * 时间单位:秒
- * 默认时间:7 x 24 x 60 x 60 = 604800 = 7 天
- */
- const EXPIRETIME = 604800;
- /**
- * Module: GenerateTestUserSig
- *
- * Description: Generates UserSig for testing. UserSig is a security signature designed by Tencent Cloud for its cloud services.
- * It is calculated based on `SDKAppID`, `UserID`, and `EXPIRETIME` using the HMAC-SHA256 encryption algorithm.
- *
- * Attention: For the following reasons, do not use the code below in your commercial application.
- *
- * The code may be able to calculate UserSig correctly, but it is only for quick testing of the SDK’s basic features, not for commercial applications.
- * `SECRETKEY` in client code can be easily decompiled and reversed, especially on web.
- * Once your key is disclosed, attackers will be able to steal your Tencent Cloud traffic.
- *
- * The correct method is to deploy the `UserSig` calculation code and encryption key on your project server so that your application can request from your server a `UserSig` that is calculated whenever one is needed.
- * Given that it is more difficult to hack a server than a client application, server-end calculation can better protect your key.
- *
- * Reference: https://cloud.tencent.com/document/product/647/17275#Server
- *
- *
- * Module: GenerateTestUserSig
- *
- * Function: 用于生成测试用的 UserSig,UserSig 是腾讯云为其云服务设计的一种安全保护签名。
- * 其计算方法是对 SDKAppID、UserID 和 EXPIRETIME 进行加密,加密算法为 HMAC-SHA256。
- *
- * Attention: 请不要将如下代码发布到您的线上正式版本的 App 中,原因如下:
- *
- * 本文件中的代码虽然能够正确计算出 UserSig,但仅适合快速调通 SDK 的基本功能,不适合线上产品,
- * 这是因为客户端代码中的 SECRETKEY 很容易被反编译逆向破解,尤其是 Web 端的代码被破解的难度几乎为零。
- * 一旦您的密钥泄露,攻击者就可以计算出正确的 UserSig 来盗用您的腾讯云流量。
- *
- * 正确的做法是将 UserSig 的计算代码和加密密钥放在您的业务服务器上,然后由 App 按需向您的服务器获取实时算出的 UserSig。
- * 由于破解服务器的成本要高于破解客户端 App,所以服务器计算的方案能够更好地保护您的加密密钥。
- *
- * Reference:https://cloud.tencent.com/document/product/647/17275#Server
- */
- function genTestUserSig(options) {
- const { SDKAppID, secretKey, userID } = options;
- const generator = new LibGenerateTestUserSig(SDKAppID, secretKey, EXPIRETIME);
- const userSig = generator.genTestUserSig(userID);
- return {
- SDKAppID,
- userSig,
- };
- }
- export { genTestUserSig, EXPIRETIME };
|