Skip to content

密钥说明 ​

本文档作为 OpenPaaS 接入过程中各类密钥的总索引,按"获取入口/作用范围"分为三大类。每类仅列要点,详细规范见对应专题文档。

一、应用(APP)基础信息 ​

创建应用时直接获得,全局通用。

密钥名作用使用方是否需保密
appid应用唯一标识APP 客户端 / 服务端否(公开标识)
appkeyAPP 客户端 SDK 初始化时使用APP 客户端否
appsecretAPP 服务端调用 auth.getAccessToken 换取 access_token 时使用APP 服务端是

派生凭证 access_token:由 APP 服务端通过 appsecret 调用 auth.getAccessToken 获取,作为后续所有 S2S 开放接口的调用凭证。属于动态短效凭证(expires_in 通常 7200 秒),需缓存复用,不应每次调用都重新获取。完整凭证管理与并发刷新规范见接口文档「最佳实践与凭证管理」一节。

二、数据安全 ​

应用业务数据流转过程中的加解密与签名验签密钥。

密钥名作用
数据对称加密密钥sessionKey、userSignature 等敏感数据的对称加解密
数据签名公私钥gameSignature 等带签业务数据载荷的验签

详细配置与使用规范:数据安全密钥说明

三、API 安全 ​

服务端与 SUD OP SVR 之间 S2S 接口通信(包括开放接口与回调接口)使用的密钥(对称密钥、应用公私钥、SUD OpenPaaS 证书)。

详细配置与使用规范:服务端 API 签名加密(开放接口方向)、回调签名加密(回调方向,密钥完全相同,仅签名方与验签方互换)。

四、数据安全 vs API 安全 ​

两类密钥完全独立,分别在管理后台不同配置页生成与下载,作用范围互不重叠:

  • 数据安全密钥 服务于"业务数据载荷":sessionKey / userSignature 加解密、gameSignature 等带签字段验签;
  • API 安全密钥 服务于"S2S HTTP 报文":开放接口与回调接口请求/响应整体的 AES-256-GCM 加密与 RSASSA-PSS 签名。

请勿将两套密钥相互混用。