多端智能选路枢纽 · 节点状态正常
|
稳定路由，多端极速互联与安全访问枢纽
面向乐鱼体育网页平台、移动应用（Android / iOS）、H5页面与桌面客户端四类终端形态，乐鱼账户网关构建了高内聚的身份状态流转基座。通过非对称加密令牌签发、毫秒级会话同步与细粒度策略引擎，确保用户在多端切换时维持平滑、安全、一致的登录状态。
为防止长效凭证泄露并消除频繁重新登录的割裂感，乐鱼账户网关采用短周期 Access Token (AT) 与单次滚动 Refresh Token (RT) 双轨机制。从签发、内网自省、滑动续期到异常吊销，每个环节均由状态机严格管控。
乐鱼体育各端发起认证请求后，身份网关核验用户凭证并结合设备安全中心返回的硬件信誉评分，使用 KMS 托管的 Ed25519 私钥生成紧凑型 JWT。令牌载荷严格遵循最小化原则，不存储敏感明文信息。
{
"iss": "https://gateway.leyu-cloud.com",
"sub": "ly_usr_982410573",
"aud": ["leyu-web", "leyu-app-ios", "leyu-h5", "leyu-pc-client"],
"iat": 1773993600,
"exp": 1773994500,
"jti": "at_01JM8X9K7V3R5T2W8Q4Z",
"tf_id": "fam_8841209c",
"client_type": "APP_ANDROID",
"dev_fp": "sha256:4f8b92c1e7a09d31...",
"scope": "profile:read session:sync client:connect"
}
为避免每次 API 请求都回源查询中央数据库，网关边缘节点通过 JWKS (JSON Web Key Set) 端点定期同步公钥。验签通过且未命中本地吊销列表后，网关剥离外部长 Token，转换为轻量级内网安全头转发至后端微服务。
X-Leyu-Authenticated: true X-Leyu-Account-ID: ly_usr_982410573 X-Leyu-Terminal-Category: MOBILE_APP X-Leyu-Device-Trust-Level: HIGH_VERIFIED X-Leyu-Session-Family: fam_8841209c X-Leyu-Trace-ID: tr_20260320_9918273645
针对乐鱼体育客户端或 H5 页面多异步请求并发触发换票的场景，网关内置10 秒宽限期 (Grace Period)。在同一终端网络抖动导致的并发刷新请求中，网关幂等返回同一组新令牌，防止因并发竞争引发误判登出。
CONSUMED，保留家族谱系追踪记录。tf_id，顺延滑动过期时间，绑定当前终端指纹。
若攻击者窃取了历史 Refresh Token 并在宽限期外尝试换取访问权限，网关检测到处于 CONSUMED 状态的令牌被二次激活，立即触发家族级熔断策略，强制清除该分支下所有有效 Token。
解决传统无状态 JWT 在过期前无法主动废止的痛点。乐鱼账户网关维护一个高压缩比的增量吊销列表（Revocation Delta List），仅存储尚未自然过期的被吊销 jti 摘要，过期后自动从内存清理。
面向桌面主流浏览器环境，采用高安全级别的 HttpOnly + Secure + SameSite=Lax 加密 Cookie 结合内存态双令牌架构，有效抵御 XSS 脚本窃取凭证。
依托 Android Keystore 与 iOS Keychain 系统级硬件安全模块存储长效刷新凭证。支持生物识别（FaceID / 指纹）快速唤醒会话与弱网断线重连态保持。
针对移动端浏览器免安装即点即用场景，适配 Safari ITP 及主流移动浏览器隐私隔离策略。支持从 H5 页面一键唤起本地已安装 APP 并无缝移交当前登录态。
面向独立运行的桌面客户端环境，通过专用 WebSocket 安全长连接维持心跳。当客户端执行版本在线升级或热更新重启后，自动恢复升级前的账户状态。
乐鱼账户网关支持“异端并行、同端互斥”的会话并发策略。同一乐鱼体育账户可同时在 1 台移动应用设备与 1 个桌面网页/客户端保持并行在线；若同一槽位（如第二台手机登录 APP）产生新登录，网关将向原设备推送下线通知并平滑移交会话锁。
基于一次性临时 Ticket 与端到端信道确认，无需在公共电脑键盘输入密码即可完成跨端身份投射。
通过单次有效、限时 30 秒的 exchange_code 完成浏览器与原生客户端的登录态交接。
通过身份认证并不意味着获得无限制的系统访问权。乐鱼账户网关在 API 路由层集成了基于角色的访问控制 (RBAC) 与基于上下文属性的动态授权 (ABAC)，对每一次模块调用执行实时策略裁决。
评估账户实名核验状态、安全等级、绑定的多因素认证（MFA）完整度以及历史安全合规记录。
将平台接口划分为公开资源（L1）、个人资料读取（L2）、账户偏好配置（L3）与核心安全凭证变更（L4）。
实时比对当前请求 IP 自治域 (ASN)、地理位置突变情况、客户端版本合规性以及常用受信设备标记。
结合时间窗口内的接口调用频率、跨模块跳转序列，识别自动化脚本枚举或非正常越权请求。
| 安全级别 | 权限作用域 (Scope) | 典型业务场景 | 网关鉴权要求 | 异常环境处置策略 |
|---|---|---|---|---|
| L1 公开级 | public:catalog:read | 浏览公开产品说明、版本公告、静态帮助文档 | 匿名通行 / 基础流量签名校验 | 正常放行 (限流保护) |
| L2 标准级 | profile:read session:sync | 读取个人基础资料、多端偏好同步、常规模块访问 | 有效 Access Token + 签名核验 | 透明无感续期 |
| L3 敏感级 | device:manage auth:grant | 管理已登录设备列表、跨端扫码授权、导出账户日志 | AT + 受信设备指纹匹配校验 | 触发图形/滑块人机验证 |
| L4 核心级 | security:credential:write | 修改登录密码、换绑安全手机/邮箱、注销或冻结账户 | 短时高权 Step-up Token (5分钟有效) | 强制二次 MFA 动态口令核验 |
乐鱼账户网关全面兼容 OAuth 2.1 与 OpenID Connect (OIDC) 核心协议簇，面向网页平台、移动应用、H5 与桌面客户端提供标准化的 RESTful 端点及统一状态码，降低多端 SDK 对接与维护复杂度。
application/json)X-Leyu-Nonce 与毫秒时间戳统一令牌签发与刷新端点。支持 authorization_code (含 PKCE) 及 refresh_token 授权模式。
跨终端会话移交端点。用于 H5 唤起原生 APP 或移动端扫码授权桌面端时的短时凭证兑换。
公钥分发端点。供边缘网关节点及内部授权微服务拉取最新 EdDSA / RSA 验签公钥集，支持平滑密钥轮转。
令牌主动吊销端点。支持按单终端 jti 吊销或按 tf_id 销毁整条会话家族链。
{
"code": "AUTH_OK",
"request_id": "req_2026_8839201a",
"timestamp": 1773993600128,
"data": {
"access_token": "eyJhbGciOiJFZERTQSI...",
"refresh_token": "rt_v2_994810293847...",
"token_type": "Bearer",
"expires_in": 900,
"refresh_expires_in": 604800,
"session_slot": "NATIVE_APP",
"step_up_required": false
}
}
乐鱼账户网关并非孤立运行。在每次签发身份令牌前，系统会实时调用设备接入中心的硬件指纹风控结果；在验签通过后，通过平台连接网格将用户上下文毫秒级分发至后端核心服务集群。