后台传输配置
在后台 程序管理 → 传输配置 页面中进行配置。配置结构页面包含「基础配置」「加密配置」「校验配置」「返回值配置」四个页签。每个接口在「接口详情」中还有独立的「安全传输」开关 —— 两者必须同时开启,安全特性才会生效。
基础配置
APPKEY
用于接口加密验证、数据传输与返回加密的密钥。是所有安全机制的核心。注意APPKEY 泄露将导致加密通信失效,请妥善保管。
登录状态码有效期
按秒计算,登录成功返回的 statecode 在有效期内可用于心跳验证。推荐值建议设为 60 ~ 86400 秒(1 分钟 ~ 1 天)。设置过长会降低安全性,设置过短会频繁触发重新登录。
加密配置
全局数据加解密
| 开启 | 启用加密通信,客户端和服务器之间的数据均经过加密 |
加密算法
全局数据加解密开启后可选择以下算法:
| Base64 自定义编码集 | 编码替换 | 64 个字符的自定义编码集 |
| RSA | 非对称加密 | RSA 公钥 + RSA 私钥 | 各算法详细说明 |
- RC4 — 轻量级流式加密,性能好,适合大部分场景
- Base64 自定义编码集 — 用自定义 64 字符替换标准 Base64 编码表,安全性较低
- DES-ECB — 使用 DES-ECB 模式 + PKCS7 填充,安全性中等
- RSA — 服务器用私钥加密,客户端用公钥解密,安全性最高但性能较低详细实现请参考 加密算法指南。
请求值加密
请求值编码
加密后的编码方式:
| HEX 编码 | 加密后转为 16 进制字符串 | 推荐使用 HEX 编码Base64 中的 + 号在 URL 传参时会被替换为空格,导致解密失败。使用 HEX 编码可避免此问题。 |
返回值加密
校验配置
时间戳校验
| 开启 | 请求需携带 t 参数,服务器验证请求是否在 30 秒有效期内 |
时间戳校验增强
开启后额外验证请求时间是否 晚于 服务器时间,防止重放攻击。
签名校验
| 双向签名 | 请求签名 + 返回值携带 token 用于客户端二次验证 | Token 计算方式(双向签名) |
- 请求签名模式:
token = md5(ID + APPKEY + 到期时间 + 当前日期分钟) - 双向签名模式:
token = md5(ID + APPKEY + 签名原文 + 到期时间 + 当前日期分钟)双向签名模式安全性更高,因为 Token 中包含了请求参数的签名原文。
返回值配置
返回值格式
JSON 返回时间戳
开启后所有响应携带 time 字段(当前服务器时间戳)。
JSON_CODE 类型
| String | {"code": "200", "msg": "..."} |
| int | {"code": 200, "msg": "..."} |
接口级配置
提示每个接口在「接口详情」中还有独立的配置项:
| 安全传输 | 此接口是否启用加密(需与程序级配置同时开启) |
| 返回时间戳 | 仅心跳接口可见,开启后文本格式也返回时间戳 |