连接验证
每个服务、合作方、提供商及环境都使用独立密钥和独立账户。
文档 / API 安全
API 身份验证与安全
建立安全的 API 访问：选择身份验证方式，通过签名保护请求、分离权限、限制网络访问并建立活动监控。
访问
连接验证
签名
请求保护
角色
权限分离
监控
活动历史
安全模型
API 各层保护
01
连接验证
为每个接入服务配置独立 API 密钥、OAuth 2.0 客户端、JWT 或服务账号。
02
请求验证
签名、请求时间、唯一标识符以及防重放保护。
03
授权检查
角色、权限、IP 地址、环境及允许的操作限额。
04
历史与监控
请求标识符、发起方、结果、告警及事件响应流程。
概览
API 安全采用多层保护
仅有 API 密钥并不足够。可靠模型会验证接入服务、请求完整性、操作权限、允许的网络来源，并保留活动历史。
请求完整性
签名、请求时间及唯一标识符可保护请求不被篡改或重放。
活动历史
日志将请求、发起方、执行的操作、结果及后续变更关联起来。
身份验证
如何选择身份验证方式
选择取决于集成类型、连接数量、访问有效期以及是否需要委派特定权限。
API 密钥
适用于系统之间直接交换数据，并为每个客户端和环境配置独立密钥的场景。
OAuth 2.0
适用于需要权限受限、有效期较短并支持集中撤销的受控访问。
JWT
可携带主体、受众、过期时间及权限信息，并必须验证签名。
服务账号
用于区分自动化流程、系统权限及不同集成的责任范围。
不要让多个系统共用同一套凭据
独立密钥和账户允许单独限制或停用某项集成，而不影响其他模块。
请求签名
请求签名与防重放
签名用于确认请求来源，并帮助验证数据在发送后未被修改。
01
构建请求签名数据
按约定顺序组合 HTTP 方法、路径、参数、请求时间、唯一标识符及正文校验值。
02
生成签名
使用分配的密钥或私钥计算 HMAC 或数字签名。
03
检查时间与唯一性
拒绝过期请求、重复标识符或已经处理过的操作。
04
安全验证签名
接收方重新构建请求数据，并将计算出的签名与收到的签名进行比较。
访问与角色
网络访问、角色与密钥有效期
连接验证后，API 会确定请求来源、允许执行的操作以及所选环境中的访问有效性。
允许的 IP 地址
用于 API、传入事件及管理访问的允许地址和子网列表。
角色
区分运营、财务、管理及系统权限。
权限
读取、修改数据、出款、报表或玩家管理所需的最小权限集。
环境隔离
测试和生产环境使用不同端点、密钥、传入事件及数据集。
有效期
临时访问和短期令牌可降低旧凭据被继续使用的风险。
定期密钥轮换
在短暂过渡期内，旧密钥和新密钥可同时保持有效。
请求频率限制
根据客户端、操作、角色及风险级别限制请求频率。
快速撤销
可单独停用密钥、令牌、角色或 IP 地址，而无需修改其他集成。
数据保护
保护个人、游戏及财务数据
API 仅传输必要信息，同时根据数据敏感程度制定存储和展示规则。
存储与处理
对静态存储中的敏感数据及机密信息进行加密。
在界面中遮蔽令牌、支付信息及个人数据。
限制保存期限，并安全删除运营数据。
隔离生产和测试数据，不复制不必要的信息。
传输与最小化
所有 API 连接、传入事件及管理访问均使用 TLS。
仅传输具体操作所需的字段。
不要在页面 URL 或常规日志中放置机密信息、令牌或敏感数据。
对导出、诊断及支持请求中的数据进行过滤。
监控与审计
安全运营、审计与事件响应
上线后通过事件监控、定期权限审查、异常检测及明确的事件响应流程持续维护安全。
活动日志
发起方、请求标识符、操作、时间、结果、状态变更及决策原因。
状态监控
登录错误、无效签名、故障率上升、延迟以及接入服务的异常活动。
安全告警
针对重复请求、活动突然激增、不允许的 IP 地址及关键操作生成告警。
事件响应
限制访问、撤销密钥、保留历史、恢复服务并通知责任团队。
安全测试
过期令牌、无效签名、未授权权限、重放请求及尝试绕过限制。
访问审查
定期检查活跃密钥、账户、角色、IP 地址及未使用权限。
生产前安全审查
验证身份验证方式、请求签名、权限、日志及事件响应计划后，才发放生产访问权限。
测试与生产环境已创建独立访问密钥。
已测试签名验证、请求时间及防重放保护。
角色和权限仅限于实际需要的操作。
已确认允许的 IP 地址、TLS 及传入事件端点。
机密信息不会出现在页面 URL、常规日志或客户端代码中。
已配置日志、告警、密钥轮换及访问撤销流程。