Skip to content

常见问题 ​

一、密钥通用问题 ​

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:

  • 风险:身份伪造、用户敏感信息泄露、接口被非法调用等。
  • 应急处置:
    1. 立即在 SUD OpenPaaS 管理后台撤销并轮换对应密钥;
    2. 同步更新服务端配置,确保旧密钥不再使用;
    3. 审计接口调用日志,定位泄露时间窗与异常请求。

二、用户签名(userSignature)相关 ​

Q:调用 SDK 鉴权接口时提示用户签名校验失败/无效,如何排查?

A:

  1. 确认 userSignature 由 APP 服务端按文档规范生成。
  2. 检查 APP 登录 Token 是否有效且未过期。
  3. 核对签名算法、参数、编码格式是否与文档一致。
  4. 确认签名在传输过程中未被篡改或编码破坏(如 URL 编码丢失、Base64 截位等)。

Q:拿不到 userSignature 会影响什么功能?

A:会直接导致 SDK 鉴权失败,无法进入后续游戏登录、获取用户信息等业务流程。


三、会话密钥(sessionKey)相关 ​

Q:登录游戏后无法获取用户信息是什么原因?

A:通常由 sessionKey 流程异常导致,常见原因如下:

  1. 未能获取 encrypted_session_key。
  2. APP 服务端未正确实现 sessionKey 解密逻辑。
  3. 解密算法、密钥或编码方式与文档不符。

Q:sessionKey 解密失败该如何处理?

A:

  1. 按照文档指引解密:会话密钥解密指引。
  2. 检查密文是否完整、无乱码或转义异常。
  3. 确认解密密钥、编码方式(如 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:

  1. 核对应用公私钥、对称密钥的 SN 是否与 SUD OpenPaaS 管理后台一致(公私钥成对、对称密钥未被轮换)。
  2. 检查待签名串拼接是否严格遵循 urlpath\nappid\ntimestamp\ndata 格式,分隔符必须为 LF(\n)。
  3. 确认请求头 X-Sud-Timestamp 与加密报文内的 _timestamp 一致,且与服务器当前时间差值未超过 300 秒(5 分钟)。
  4. 检查 _n(Nonce)是否每次请求重新生成、未复用。
  5. 完整错误码与对照见 服务端 API 签名加密 第五章。

Q:服务端 API 签名加密的完整规范在哪里?

A:服务端 API 签名加密

Q:API 通信每次都需要重新生成签名吗?

A:是的。每次请求都必须重新生成签名与 _n(Nonce),防止重放攻击。