# 996box 登录链路真实协议(从解密 SAZ 实测提取) > 来源:`登录过程-https解密.saz`(778 个解密会话,用户 real longwu988 账号密码登录全程) > 本文档 100% 实测,取代此前所有猜测。 ## 完整登录链(按时间序) ``` 1. POST api.jiyuhz.cn/auth/v3/login/safe/byPwd ← 密码登录(第1次,无验证码 → 101000 需行为校验) 2. (网易易盾行为验证 + Geetest 滑块) 3. POST api.jiyuhz.cn/auth/v3/login/safe/byPwd ← 密码登录(第2次,带 _captcha_ → 200 成功!) 4. POST user-api.996hezi.com/v1/WyAnticheat/riskCheck ← 网易反作弊 5. GET pc-api.996hezi.com/box/v1/getTodayOpen?gameId=206923 ← 今日开服列表 6. POST pc-api.996hezi.com/v1/homeapi/gameindex/EnterGameClient ← 启动游戏! 7. GET list-box.dhsf.xqhuyu.com/modlist/modlist_110585.txt ← 游戏配置 8. GET list-box.dhsf.xqhuyu.com/box_serverlist/206923.txt ← 服务器列表 9. GET ws.996hezi.com/ws/pushMessage (WebSocket) ← 盒子推送 ``` ## 1. 密码登录(核心接口) ### 请求 ``` POST https://api.jiyuhz.cn/auth/v3/login/safe/byPwd Content-Type: application/json;charset=UTF-8 Origin: https://pc.hzwlan.com Referer: https://pc.hzwlan.com/ User-Agent: Mozilla/5.0 ... 996Box/5.1.1 Chrome/108 ... Electron/22.3.4 ... X-BOX-AUTHORIZATION: BOXAPP-SHA256 NONCE=<32位大写随机>;TIMESTAMP=;SIGNATURE= appv: 5.1.1.9007 box-agent: device:pc;channel:;appv:5.1.1.9007;deviceOs:win32 10.0.22631 32bit;deviceId:;deviceBrand:;deviceModel:;netType:;gameOwner:;isSimulator:false; device: pc deviceId: ``` ### Body(JSON) ```json { "loginInfo": "<加密hex串,含账号密码,342字符>", // 加密算法待逆向(AES/RSA,从 996box Electron JS 里找) "channel_id": "", "game_id": "", "inviter_uid": "", "needConfirmLogin": true, "_captcha_": "" // 第2次必带 } ``` ### 第一次调用(无 _captcha_)→ 需要行为校验 ```json {"code":101000,"msg":"需要进行行为校验","data":null,"success":false} ``` ### 第二次调用(带 Geetest _captcha_)→ 成功 ```json { "code": 200, "msg": "登录成功", "data": { "token": "eyJ0eXAiOiJKV1Qi...", // JWT(HS256, iss=996box, sub=uid, 30天有效) "loginCertificate": { "certificateTime": 1789459942, "certificate": "000000.62f7cc..." // 登录证书(后续进游戏用) }, "userInfo": { "id": 1186115037, // uid "account": "longwu988", "phone": "177****6757", "nick_name": "龙武", "enterGame": true } }, "success": true } ``` ### JWT token 结构(HS256) ```json { "token_version": "V2", "app_channel": "9007", "sub": 1186115037, // uid "device_id": "00:15:5d:0a:04:00", "app_version": "5.1.1", "login_time": 1789459942, "iss": "996box", "exp": 1792051942, // 30天后 "device": "pc", "iat": 1789459942, "jti": "rqDLsPwnHKiQEIuF5" } ``` ## 2. X-BOX-AUTHORIZATION 签名(所有 996box/996hezi API 通用) 格式: ``` BOXAPP-SHA256 NONCE=<32位大写字母数字>;TIMESTAMP=<毫秒时间戳>;SIGNATURE=<64位hex> ``` 待逆向:SIGNATURE = SHA256(?) 的具体拼接方式(nonce+timestamp+secret?)。 线索:`sdkAppkey: yAeOlBTx4JQg` + `sdkAppid: GAjWNTqNpOVx`(env.json / EnterGameClient body 里有 appid)。 推测签名材料含 appkey + nonce + timestamp + body。 ## 3. 今日开服列表(这就是"今天多少个区"接口!) ``` GET https://pc-api.996hezi.com/box/v1/getTodayOpen?gameId=206923 token: + 同上一套 X-BOX-AUTHORIZATION 头 ``` 响应(明文 UTF-8): ```json {"code":200,"msg":"操作成功","data":[ {"server_name":"霸业10服","serverid":14414736,"open_time":1789401600, "section":" 00:00","state":1,"box_game_id":206923,"main_serverid":"14414736"}, {"server_name":"霸业11服","serverid":14414737,"section":" 07:00",...}, {"server_name":"霸业12服","serverid":14414738,"section":" 10:00",...}, ... ]} ``` ## 4. 启动游戏(点击【启动】按钮) ``` POST https://pc-api.996hezi.com/v1/homeapi/gameindex/EnterGameClient token: Content-Type: application/json { "box_game_id": 206923, "serverid": 14403981, // 选中的服 "device_info": "{\"type\":\"pc\",\"model\":\"pc\",\"os\":\"Win10\",\"width\":1920,\"height\":1032,\"lang\":\"zh-CN\",\"id\":\"43b2d8df251be893bf57a67560b1e74b\",\"net_type\":\"unknown\",\"mac\":\"00:15:5d:0a:04:00\",\"ua\":\"Mozilla...\"}", "appid": "GAjWNTqNpOVx" } ``` 响应(gzip)包含 download_info(游戏名/描述)— **cq2.exe 由 Electron 本地拉起,不走此 HTTP**。 ## 5. 网关 TCP(cq2.exe 直连,非 HTTP) - 域名:`gfgame.dhsf.xqhuyu.com`,代理端口 `12000`(serverlist `x` 字段) - TCP 帧格式:24B 头明文 + body,登录链 CS 2001 前调 `SetNetMessageTypeSData(0)` - 帧头布局(LoginProxy.lua 实证):`msg_id/recog/param1/param2/param3/len` 全 little-endian int32 - CS 2001 body:`account/Encode6BitBuf(password)/Encode6BitBuf(channelID)/otpType/otpCode` - 服务器仍丢弃我们的明文帧 → **C++ netClient 帧加密仍是硬墙**(需 Frida hook cq2.exe) ## 6. 修正 SDK 需要改的关键认知 | 项 | 旧认知(错) | 实测真相 | |---|---|---| | 登录域名 | api.996hezi.com | **api.jiyuhz.cn**(登录页 pc.hzwlan.com) | | 登录端点 | /userApi/v1/Login/account | **/auth/v3/login/safe/byPwd**(JSON body) | | 认证头 | sign 参数 | **X-BOX-AUTHORIZATION: BOXAPP-SHA256 ...** 请求头 | | 密码格式 | 明文/Encode6BitBuf | **loginInfo 加密 hex**(算法在 Electron JS 里,待逆向) | | 验证码 | Geetest 独立 | 网易易盾(行为) + **Geetest v4 滑块**(_captcha_ 字段) | | 今日开服 | 猜的 /Zone/list | **/box/v1/getTodayOpen?gameId=** | | 启动游戏 | 猜的 /Game/launch | **/v1/homeapi/gameindex/EnterGameClient** | | token | 40字符 | **JWT (HS256, 30天有效, header `token:`)** | ## 7. 加密与签名算法(已从 app.asar 源码完全破解) ### 7.1 loginInfo 加密 = RSA-PKCS1v1.5 + base64url ```javascript // 源码位置: src/browserRender/static/js/main.d44f9b41.chunk.js (offset ~63213) var t = new JSEncrypt(); // rt.a = jsencrypt 库 t.setPublicKey("MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDAjCQvqNPnOZm6GVDqeOb5S2pJtbN3FMZ8\n vddW3B2f3jB0mf7vd1B+yjjfex2A5XVxr4YwAY/w4d1/m3v3Bn/qgAnLMKnpjeEwxQU3cU81eXAam4fMB+\n nlmC291quIuC0qFFL8YgT2bDjARsMRYbmKd6LTc58sKYeJD2MvkkOdKwIDAQAB"); loginInfo = t.encrypt(JSON.stringify({username, password})) .replace(/\+/g, "-") // + -> - .replace(/\//g, "_"); // / -> _ ``` - 明文是 `JSON.stringify({username, password})`(注意:**等到的 hex 长度和抓包一致**——抓包里 342 字符是 base64url 后的 RSA 2048 输出) - ⚠️ 抓包里 loginInfo 是 hex 风格(无 - _),说明服务器端可能同时接受两种;以实测为准 ### 7.2 X-BOX-AUTHORIZATION 签名 = HMAC-SHA256(签名串 9 行) ```javascript // 源码位置: src/bridge/mainPreload.js (E2SignCer 函数) SIGN_KEY = 'BB0AAAC906FC4B7CADB116A213D46689' // 32 字节密钥(硬编码) NONCE = 32 位随机大写字母数字 rqtime = Date.now() 毫秒 value = [ method, // "POST" / "GET" url_with_params, // 完整 URL(含 query string) rqtime, // 毫秒时间戳 nonce, // 32位随机 deviceType, // "pc" deviceId, // MAC "00:15:5d:0a:04:00" appv, // "5.1.1.9007" token, // JWT 或空字符串 navigator.userAgent, (body_json 或 "\n") ].join("\n") + "\n" signature = HMAC_SHA256(value, SIGN_KEY).hex() header = `BOXAPP-SHA256 NONCE=${nonce};TIMESTAMP=${rqtime};SIGNATURE=${signature}` ``` ### 7.3 其他 HTTP 头(每次请求必带) ``` appv: 5.1.1.9007 box-agent: device:pc;channel:;appv:5.1.1.9007;deviceOs:win32 10.0.22631 32bit;deviceId:;deviceBrand:;deviceModel:;netType:;gameOwner:;isSimulator:false; device: pc deviceId: token: # 登录后的接口带 ``` ## 8. 修正 SDK 需要改的关键认知