密钥说明
本文档作为 OpenPaaS 接入过程中各类密钥的总索引,按"获取入口/作用范围"分为三大类。每类仅列要点,详细规范见对应专题文档。
一、应用(APP)基础信息
创建应用时直接获得,全局通用。
| 密钥名 | 作用 | 使用方 | 是否需保密 |
|---|---|---|---|
| appid | 应用唯一标识 | APP 客户端 / 服务端 | 否(公开标识) |
| appkey | APP 客户端 SDK 初始化时使用 | APP 客户端 | 否 |
| appsecret | APP 服务端调用 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 签名。
请勿将两套密钥相互混用。
