常见问题
一、密钥通用问题
Q:各类密钥分别由谁生成、在哪个环节生成?
A:
- userSignature:由 APP 服务端生成。APP 客户端在调用 SUD SDK 鉴权接口前,先向 APP 服务端请求获取,再以其为入参完成 SDK 鉴权。
- sessionKey:由 SUD OP SVR 生成。玩家登录游戏时下发给 Game SVR 持有;获取用户敏感信息时,APP SVR 临时获取该密钥用于对敏感数据加密,Game SVR 收到加密数据后用持有的 sessionKey 解密。
- API 安全密钥(对称密钥 / 应用公私钥 / SUD OpenPaaS 证书):由 APP 在 SUD OpenPaaS 管理后台在线生成并下载,用于 APP 服务端与 SUD OP SVR 之间的 S2S 接口通信。
Q:密钥失效了该如何处理?
A:
- userSignature 失效(因载荷中的
expires_at已过期被服务端拒绝):重新向 APP 服务端发起签名生成请求。 - sessionKey 失效:重新执行游戏登录流程,获取新的会话密钥。
- API 安全密钥失效:登录 SUD OpenPaaS 管理后台核对密钥状态;如需轮换,重新生成密钥对/证书并同步更新服务端配置。
Q:密钥泄露会有什么风险,如何应急处置?
A:
- 风险:身份伪造、用户敏感信息泄露、接口被非法调用等。
- 应急处置:
- 立即在 SUD OpenPaaS 管理后台撤销并轮换对应密钥;
- 同步更新服务端配置,确保旧密钥不再使用;
- 审计接口调用日志,定位泄露时间窗与异常请求。
二、用户签名(userSignature)相关
Q:调用 SDK 鉴权接口时提示用户签名校验失败/无效,如何排查?
A:
- 确认 userSignature 由 APP 服务端按文档规范生成。
- 检查 APP 登录 Token 是否有效且未过期。
- 核对签名算法、参数、编码格式是否与文档一致。
- 确认签名在传输过程中未被篡改或编码破坏(如 URL 编码丢失、Base64 截位等)。
Q:拿不到 userSignature 会影响什么功能?
A:会直接导致 SDK 鉴权失败,无法进入后续游戏登录、获取用户信息等业务流程。
三、会话密钥(sessionKey)相关
Q:登录游戏后无法获取用户信息是什么原因?
A:通常由 sessionKey 流程异常导致,常见原因如下:
- 未能获取 encrypted_session_key。
- APP 服务端未正确实现 sessionKey 解密逻辑。
- 解密算法、密钥或编码方式与文档不符。
Q:sessionKey 解密失败该如何处理?
A:
- 按照文档指引解密:会话密钥解密指引。
- 检查密文是否完整、无乱码或转义异常。
- 确认解密密钥、编码方式(如 Base64)配置正确。
Q:sessionKey 在系统间是如何传递的?
A:
- 登录阶段:SUD OP SVR 为当前会话生成 sessionKey 并下发给 Game SVR 持有,仅服务端保管,不下发客户端。
- 获取敏感信息时:SUD OP SVR 将 sessionKey 加密为 encrypted_session_key,经 SUD OP → APP 透传至 APP SVR;APP SVR 用数据对称加密密钥解密得到 sessionKey,对用户敏感信息进行 AES 加密后回传。
- 解密阶段:加密结果沿原路返回至 Game,由 Game SVR 用登录阶段已持有的 sessionKey 解密敏感数据。
四、API 安全密钥相关
Q:服务端调用 SUD OpenPaaS API 提示签名错误/鉴权失败,如何排查?
A:
- 核对应用公私钥、对称密钥的 SN 是否与 SUD OpenPaaS 管理后台一致(公私钥成对、对称密钥未被轮换)。
- 检查待签名串拼接是否严格遵循
urlpath\nappid\ntimestamp\ndata格式,分隔符必须为 LF(\n)。 - 确认请求头
X-Sud-Timestamp与加密报文内的_timestamp一致,且与服务器当前时间差值未超过 300 秒(5 分钟)。 - 检查
_n(Nonce)是否每次请求重新生成、未复用。 - 完整错误码与对照见 服务端 API 签名加密 第五章。
Q:服务端 API 签名加密的完整规范在哪里?
Q:API 通信每次都需要重新生成签名吗?
A:是的。每次请求都必须重新生成签名与 _n(Nonce),防止重放攻击。
