feat(huya): 零设备 dfpReport 注册链迁入 core/huya 并接入生产登录

- 新增 core/huya/dfp_register: 随机 4146B cw 生成 + 注册响应解析 (t1/t2/t5),
  修复 JSON 模板 %s 数不匹配的 TypeError bug
- app_login 每次 WUP 登录前执行注册链取新 safedeviceid/device_id,
  不再读取画像旧固定值; 注册失败抛 HuyaAppLoginError 终止, 不静默回退旧链
- device_profile 移除固定 SAFEDEVICEID_DEFAULT, 画像只承载 soft 字段
- tools/huya_device_register 同步零设备生成链路 (--gen/--gen-login)
- 新增 tests/test_huya_dfp_register (9 项), 扩展 test_huya_app_login 注册接线 (4 项)
This commit is contained in:
yml2213
2026-08-27 17:47:53 +08:00
parent 36325cf639
commit 0c86e182b0
6 changed files with 520 additions and 37 deletions
+65 -1
View File
@@ -19,8 +19,14 @@ from core.huya import (
login_huya_app_password,
login_huya_password,
)
from core.huya.app_login import (
DEFAULT_GOLDEN_DEV,
login_cred_with_flow,
wup_password_login_raw,
)
from core.huya.cert_forge import build_p1, decrypt_cert, forge_cert, parse_p1
from core.huya.device_profile import generate_profile, get_profile
from core.huya.dfp_register import DfpRegistrationError
from core.huya.envelope_forge import Envelope
from core.huya.login import HuyaLoginResult
from core.huya.nonce_forge import K1_DEFAULT, gen_nonce
@@ -97,6 +103,9 @@ class TestHuyaAppLogin(unittest.TestCase):
self.assertEqual(len(p1["fingerprint"]), 40)
self.assertEqual(len(p1["device_id"]), 40)
self.assertEqual(p1["hdid"], "ed0db8334cadd236c00cadf7e11ab5a5")
# 画像不再承载 safedeviceid:该令牌由 dfp_register 注册链每次登录前签发
self.assertNotIn("safedeviceid", p1)
self.assertNotIn("safedeviceid", DEFAULT_GOLDEN_DEV)
p2 = get_profile("test_user_account_123")
p3 = get_profile("test_user_account_123")
@@ -107,7 +116,8 @@ class TestHuyaAppLogin(unittest.TestCase):
pkt = build_password_login_wup(
uid_str="300023887",
sha1_password="772ed992b0e161276f44ec63671e60155c506294",
safedeviceid=dev["safedeviceid"],
# 注册链签发格式: 180B base64 action 令牌
safedeviceid="A" * 180,
hdid=dev["hdid"],
session=3251699,
trace_id="test-trace-id",
@@ -118,6 +128,60 @@ class TestHuyaAppLogin(unittest.TestCase):
total_len = struct.unpack(">I", pkt[:4])[0]
self.assertEqual(total_len, len(pkt))
# ---- 新设备注册链 (core/huya/dfp_register) 生产接入测试 ----
def test_wup_login_skips_registration_when_safedeviceid_given(self):
"""显式传入 safedeviceid 时不再触发注册链(风控重试复用同一注册结果)。"""
with patch("core.huya.app_login.register_device") as m_reg, \
patch("core.huya.app_login.build_password_login_wup", return_value=b"pkt"), \
patch("core.huya.app_login.requests.post",
return_value=MagicMock(status_code=200, content=b"")):
wup_password_login_raw("300023887", "pw", safedeviceid="A" * 180)
m_reg.assert_not_called()
def test_wup_login_registers_fresh_device_when_safedeviceid_missing(self):
"""未传 safedeviceid 时先注册,注册签发的 action/device_id 进 WUP 帧。"""
new_action = "B" * 180
new_device_id = "c" * 40
captured = {}
def fake_build(*args, **kwargs):
captured["args"] = args
return b"pkt"
with patch("core.huya.app_login.register_device",
return_value=("a" * 32, new_action, new_device_id)) as m_reg, \
patch("core.huya.app_login.build_password_login_wup", side_effect=fake_build), \
patch("core.huya.app_login.requests.post",
return_value=MagicMock(status_code=200, content=b"")):
wup_password_login_raw("300023887", "pw")
m_reg.assert_called_once()
# args: uid_str, sha1, safedeviceid, hdid, session, traceId, ua, dev
self.assertEqual(captured["args"][2], new_action)
self.assertEqual(captured["args"][7]["device_id"], new_device_id)
# 画像默认值里的旧 device_id 被注册结果覆盖,而非沿用
self.assertNotEqual(
captured["args"][7]["device_id"],
DEFAULT_GOLDEN_DEV["device_id"],
)
def test_wup_login_registration_failure_is_explicit(self):
"""注册失败必须抛错终止,禁止静默回退旧链(不发任何登录请求)。"""
with patch("core.huya.app_login.register_device",
side_effect=DfpRegistrationError("注册链超时")) as m_reg, \
patch("core.huya.app_login.requests.post") as m_post:
with self.assertRaises(HuyaAppLoginError):
wup_password_login_raw("300023887", "pw")
m_reg.assert_called_once()
m_post.assert_not_called()
def test_login_cred_flow_registration_failure_is_explicit(self):
"""login_cred_with_flow 注册失败同样包装为 HuyaAppLoginError 显式失败。"""
with patch("core.huya.app_login.register_device",
side_effect=DfpRegistrationError("注册链 HTTP 500")):
with self.assertRaisesRegex(HuyaAppLoginError, "注册失败"):
login_cred_with_flow("300023887", "pw")
def test_router_functions(self):
mock_res = HuyaLoginResult(
success=True,
+152
View File
@@ -0,0 +1,152 @@
"""虎牙新设备注册链 (core/huya/dfp_register) 测试。
覆盖:
* 随机 dfpReport body/cw 结构 (4226B / 4146B / 固定10B尾);
* dfpReport 响应解析 (t1/t2/t5) 及缺字段失败;
* register_device 全流程: 三步 POST 顺序与 content-type、fingerprint 注入、
注册结果三元组返回;
* 失败语义: 模板缺失/HTTP 异常 -> DfpRegistrationError (不静默、不发登录帧)。
"""
import base64
import json
import unittest
from pathlib import Path
from unittest.mock import patch
import requests
from core.huya.dfp_register import (
CHAIN_FILE,
CW_LEN,
DfpRegistrationError,
_build_random_dfp_body,
_parse_response,
register_device,
)
TAIL = bytes.fromhex("3600400c0b8c980ca80c")
def _fake_resp() -> bytes:
"""合成 dfpReport 响应: t1(32hex) + t2(180B base64 action) + t5(40hex)。"""
return (b"\x16\x20" + b"a" * 32
+ b"\x26\xb4" + b"A" * 180
+ b"\x56\x28" + b"b" * 40)
_GOLDEN_FP = b"02df398797432eadefcc12767119ad5e80999389"
def _dummy_chain() -> dict:
# selectOperator 请求体包含金样本 fingerprint, 供替换注入测试
return {
"getDfpConfig": (b"cfg-req", b"cfg-resp"),
"selectOperator": (b"sel-hdr" + _GOLDEN_FP + b"sel-tail", b"sel-resp"),
"dfpReport": (b"dfp-req", b"dfp-resp"),
}
class TestRandomDfpBody(unittest.TestCase):
def test_body_shape(self):
body = _build_random_dfp_body()
self.assertEqual(len(body), 4226)
cw = body[-CW_LEN:]
self.assertEqual(len(cw), CW_LEN) # 4146
self.assertTrue(cw.endswith(TAIL), "cw 尾部应为固定 10B")
def test_body_is_randomized(self):
b1 = _build_random_dfp_body()
b2 = _build_random_dfp_body()
self.assertNotEqual(b1, b2, "每次注册应生成不同的随机 cw")
class TestParseResponse(unittest.TestCase):
def test_parse_ok(self):
t1, t2, t5 = _parse_response(_fake_resp())
self.assertEqual(t1, "a" * 32)
self.assertEqual(t2, "A" * 180)
self.assertEqual(t5, "b" * 40)
def test_parse_golden_evidence(self):
"""真实抓包模板响应必须可解析 (证据: evidence/dfp_chain_golden.json)。"""
if not CHAIN_FILE.exists():
self.skipTest("缺失 golden 注册链模板")
data = json.loads(CHAIN_FILE.read_text(encoding="utf-8"))
resp = base64.b64decode(data["dfpReport"]["resp_b64"])
t1, t2, t5 = _parse_response(resp)
self.assertEqual(len(t1), 32)
self.assertEqual(len(t2), 180)
self.assertEqual(len(t5), 40)
def test_parse_missing_fields_raises(self):
with self.assertRaises(DfpRegistrationError):
_parse_response(b"\x16\x20" + b"a" * 32) # 缺 t2/t5
with self.assertRaises(DfpRegistrationError):
_parse_response(b"\x26\xb4" + b"A" * 180) # 缺 t1/t5
with self.assertRaises(DfpRegistrationError):
_parse_response(b"\x56\x28" + b"b" * 40) # 缺 t1/t2
class TestRegisterDevice(unittest.TestCase):
def test_flow_three_steps_and_returns_triple(self):
calls = []
def spy_post(body, content_type="application/octet-stream",
timeout=20, proxies=None):
calls.append(content_type)
return _fake_resp()
with patch("core.huya.dfp_register._load_chain", return_value=_dummy_chain()), \
patch("core.huya.dfp_register._post", side_effect=spy_post):
t1, t2, t5 = register_device(fingerprint=None)
self.assertEqual((t1, t2, t5), ("a" * 32, "A" * 180, "b" * 40))
# getDfpConfig -> selectOperator -> dfpReport 的 content-type 序列
self.assertEqual(
calls,
["application/octet-stream", "application/x-wup", "application/octet-stream"],
)
def test_select_operator_injects_fingerprint(self):
captured = []
def spy_post(body, content_type="application/octet-stream",
timeout=20, proxies=None):
captured.append((body, content_type))
return _fake_resp()
new_fp = b"0" * 20 + b"f" * 20
with patch("core.huya.dfp_register._load_chain", return_value=_dummy_chain()), \
patch("core.huya.dfp_register._post", side_effect=spy_post):
register_device(fingerprint=new_fp.decode("ascii"))
sel_body, sel_ct = captured[1]
self.assertEqual(sel_ct, "application/x-wup")
self.assertIn(new_fp, sel_body, "selectOperator 应注入当前账号画像 fingerprint")
self.assertNotIn(_GOLDEN_FP, sel_body)
# dfpReport 请求体为随机 cw 结构 (零设备生成)
dfp_body, dfp_ct = captured[2]
self.assertEqual(len(dfp_body), 4226)
self.assertEqual(dfp_ct, "application/octet-stream")
def test_chain_template_missing_raises(self):
"""模板缺失 -> 注册链直接报错, 不应发起任何网络请求。"""
with patch("core.huya.dfp_register.CHAIN_FILE",
Path("/tmp/definitely_missing_chain.json")), \
patch("core.huya.dfp_register._post") as m_post:
with self.assertRaises(DfpRegistrationError):
register_device()
m_post.assert_not_called()
def test_http_failure_raises(self):
"""HTTP 层异常由 _post 转换为 DfpRegistrationError 后向上传播 (不静默)。"""
with patch("core.huya.dfp_register._load_chain", return_value=_dummy_chain()), \
patch("core.huya.dfp_register.requests.post",
side_effect=requests.RequestException("connection reset")):
with self.assertRaises(DfpRegistrationError):
register_device()
if __name__ == "__main__":
unittest.main()