开放数据校验与解密
开发者后台校验与解密开放数据
抖音会对这些开放数据做签名和加密处理。开发者后台拿到开放数据后可以对数据进行签名校验和解密,来保证数据不被篡改。
签名校验以及数据加解密涉及用户的会话密钥
session_key。 开发者应该通过 tt.login 登录流程后由服务端获取会话密钥 session_key 并保存在服务器。为了数据不被篡改,开发者不应该把 session_key 传到小游戏客户端等服务器外的环境。
数据签名校验
为了确保开放接口返回用户数据的安全性,抖音会对明文数据进行签名。开发者可以根据业务需要对数据包进行签名校验,确保数据的完整性。
开发者将
signature、rawData 发送到开发者服务器进行校验。服务器利用用户对应的 session_key 使用相同的算法计算出签名 signature2 ,比对 signature 与 signature2 即可校验数据的完整性。
tt.getUserInfo
数据校验示例
接口返回的 rawData:
{ "nickName": "ByteDancer", "gender": 1, "language": "zh_CN", "city": "Beijing", "province": "Beijing", "country": "CN", "avatarUrl": "https://example.com/avatar.jpg" }
用户的 session_key:
HyVFkGl5F5OQWJZZaNzBBg==
用于签名的字符串为:
{ "nickName": "ByteDancer", "gender": 1, "language": "zh_CN", "city": "Beijing", "province": "Beijing", "country": "CN", "avatarUrl": "https://example.com/avatar.jpg" }
使用 sha1 得到的结果为:
cc346c352e2281865ba85198e0d7c74692d2434d (此为示例 hash,实际会不同)
加密数据解密算法
用户登录态签名
部分服务端接口需要使用
session_key 进行用户身份校验,为了保持 session_key 私密性,接口不明文传输 session_key,而是通过校验登录态签名 signature 完成。
登录态签名的生成方式详见用户登录态签名
set_user_storage的签名校验示例
会话密钥 session_key 有效性
开发者如果遇到因为
session_key 不正确而校验签名失败或解密失败,请关注下面几个与 session_key 有关的注意事项。
- 1.
tt.login 调用时,用户的 session_key 可能会被更新而致使旧 session_key 失效(刷新机制存在最短周期,如果同一个用户短时间内多次调用 tt.login,并非每次调用都导致 session_key 刷新)。开发者应该在明确需要重新登录时才调用 tt.login,并及时通过服务端 jscode2session 接口更新服务器存储的 session_key。- 2.抖音不会把
session_key 的有效期告知开发者。我们会根据用户使用小游戏的行为对 session_key 进行续期。用户越频繁使用小游戏,session_key 有效期越长。- 3.开发者在
session_key 失效时,可以通过重新执行登录流程获取有效的 session_key。使用接口 tt.checkSession 可以校验 session_key 是否有效,从而避免小游戏反复执行登录流程。- 4.当开发者在实现自定义登录态时,可以考虑以
session_key 有效期作为自身登录态有效期,也可以实现自定义的时效性策略。
