Skip to content

数据安全密钥说明 ​

本文档说明 OpenPaaS 接入过程中"数据安全"相关密钥的作用、配置入口与使用文档。

一、数据对称加密密钥 ​

1.1 作用 ​

由 APP 服务端与 SUD OP SVR 共同持有的对称密钥,用于敏感业务数据的对称加解密。典型使用场景:

  • sessionKey 加解密:SUD OP SVR 将 sessionKey 加密为 encrypted_session_key 下发,APP 服务端用该密钥解密获得真实 sessionKey;
  • userSignature 加解密:APP 服务端生成 userSignature 时,用该密钥对鉴权 Payload 进行 AES-GCM 加密。

1.2 算法与规范 ​

项取值
加密算法AES-256-GCM
密钥长度256 位(32 字节)
编码格式43 字符 Base64 字符串,解码后 32 字节

1.3 配置与下载 ​

在 SUD OpenPaaS 管理后台对应配置页生成并下载(仅可下载一次,需本地妥善保管,建议托管至 KMS 或密文配置中心)。

该密钥与 服务端 API 签名加密 中 S2S 接口报文加解密所用的「对称密钥」是两套独立密钥,分别在不同配置页生成与下载,请勿混用。

1.4 使用文档 ​

1.5 示例代码 ​

覆盖 userSignature 生成与 sessionKey 解密两个场景的完整示例代码见 示例代码。

二、数据签名公私钥 ​

2.1 作用 ​

用于 APP 侧对 SUD OpenPaaS 下发的业务数据载荷中的签名字段进行验签,确认载荷来源真实、未被篡改。典型使用场景:

  • gameSignature 验签
  • 其它带签业务数据字段验签

本机制只处理"业务数据载荷字段"的签名;API 与回调的 HTTP 报文层加密/签名走 服务端 API 签名加密(应用公私钥 / SUD OpenPaaS 证书),两者互不重叠,请勿混用。

2.2 公钥获取 ​

在 SUD OpenPaaS 管理后台获取应用对应的公钥。若 APP 不启用验签可不获取(不推荐,验签是抵御载荷伪造的关键防线)。

2.3 验签算法规范 ​

项取值
签名算法RSASSA-PSS
摘要算法SHA-256
MGFMGF1(SHA-256)
Salt 长度32 字节
Trailer Field1
待签名内容编码UTF-8
签名输出编码Base64

由 SUD OpenPaaS 使用应用对应的私钥对业务数据载荷进行签名,APP 侧使用从管理后台获取的公钥进行验签。各业务数据(如 gameSignature 等)的"待验签内容拼接规则"由对应业务文档单独定义。

2.4 示例代码 ​

覆盖业务数据载荷验签场景的完整示例代码见 示例代码。