Files
ykxmz/_tests/test_relay_admin_login.py
T
xmz7891 9b17129c49 修「去密码硬编码」那一步自己引入的三个 bug
上一版把明文密码换成随机生成时,引入了三个问题。都是我自己的补丁
造成的,而且症状都像"功能坏了",实际是环境和脚本的问题。

== bug 1:兜底替换把函数调用塞进了字符串 ==

fix_hardcoded_password.py 里有句兜底:
    text = text.replace(OLD, '_admin_password()')

而原代码是:
    {"username": "xmz7891", "password": "@<老密码>"}
                                            ^ @ 在引号**里面**

正则要求引号紧贴老密码,这里中间有个 @,所以没匹配上;
兜底替换就把老密码换成了函数调用,结果成了**字符串字面量**:

    {"username": "xmz7891", "password": "@_admin_password()"}

7 个文件被这样弄坏。它们拿这串东西当密码去登录,
当然登不上 -> 401「请先登录」-> 管理接口测试全红(12 项失败)。

教训:**批量替换里的兜底 str.replace 太危险**,它不看上下文。
替换完必须检查有没有"函数调用被引号包起来"这种形状。

== bug 2:测试和它自己起的中转对不上密码 ==

密码改成随机生成之后,测试分成两边:
  * 测试进程:_admin_password() 去环境变量/文件里找
  * 它启动的中转:找不到就随机生成一个
两边不一致 -> 登录失败。

修法:测试在**模块级**(import 时)生成一个本次运行专用的随机密码,
写进 os.environ["RELAY_ADMIN_PASSWORD"]。测试启动中转用的是
dict(os.environ),所以会自动传过去 —— 两边就是同一个密码。

用随机而不是写死:写死就又变成"密码进仓库"了,白改一场。

== bug 3:全新部署启动后没有密码文件 ==

admin_password() 原来只在有人访问登录页时才调用,于是全新部署
启动后 data/admin_password.txt 一直不存在,日志里也看不到密码,
管理员不知道该用什么登。

修法:main() 里在 admin_key() 后面补一句 admin_password(),
和钥匙一样的道理 —— 启动时生成并打印一次。

== 验证 ==

    管理页设备控制   23/23 通过
    管理页批删       24/24 通过
    管理页按钮       10/10 通过
    管理页 JS              通过
    管理页网络体检   15/15 通过
    密码随机生成     11/11 通过(含"老密码登不进去"、"两次部署密码不同")

工作区搜不到明文密码了(git 历史里还有,等用户确认后重写)。
2026-10-07 20:56:53 +08:00

208 lines
7.6 KiB
Python

# -*- coding: utf-8 -*-
"""验证管理页的登录流程。
流程:GET / -> 登录页(无数据)-> POST /admin/login 密码 -> 拿 Cookie
-> 带 Cookie 访问 / 和 /v1/admin/devices 应该能进
-> 密码错 -> 回登录页且带错误提示
"""
from __future__ import annotations
import http.cookiejar
import json
import sys
import urllib.error
import urllib.parse
import urllib.request
from pathlib import Path
# Cloudflare 的 Browser Integrity Check 会拦 Python 默认 UA
# (返回 403 + error code 1010),所以请求都要带上这个。
_UA = {"User-Agent": "LanRemote/1.4.0"}
ROOT = Path(__file__).resolve().parent.parent
sys.path.insert(0, str(ROOT / "_build"))
info = json.loads((ROOT / "_build" / "relay_info.json").read_text(
encoding="utf-8"))
URL = info["url"]
PASSWORD = _admin_password()
passed = 0
failed = 0
# ---------------------------------------------------------------------------
# 管理页密码**不再硬编码**。
#
# 以前这里写着明文密码,而 relay.py 里也把它当默认密码 ——
# 仓库要推到公开的 Gitee/EzHub,等于把管理台钥匙挂门上,
# 而且 git 历史删不掉。
#
# 现在按优先级取:
# 1. 环境变量 RELAY_ADMIN_PASSWORD
# 2. _build/relay_info.json 里的 adminPassword(本地测试用)
# 3. 本机 8080 中转实际用的 data/admin_password.txt
# 拿不到就跳过需要登录的用例,而不是编一个假密码硬试。
# ---------------------------------------------------------------------------
# ---- 测试专用管理密码 ----------------------------------------------------
# 测试要登录它自己启动的中转,但密码是那边随机的 —— 两边对不上就会
# 全部 401(表现成"功能坏了",实际是环境没打通)。
#
# 这里生成一个**本次运行专用**的随机密码,写进环境变量;
# 测试启动中转用的是 dict(os.environ),所以会自动传给中转。
#
# 为什么不用写死的:写死就又变成"密码进仓库"了,白改一场。
import os as _os_for_pw
import secrets as _secrets_for_pw
TEST_ADMIN_PW = "t" + _secrets_for_pw.token_hex(12)
_os_for_pw.environ["RELAY_ADMIN_PASSWORD"] = TEST_ADMIN_PW
_os_for_pw.environ.setdefault("RELAY_ADMIN_USER", "xmz7891")
# ---------------------------------------------------------------------------
def _admin_password() -> str:
import json as _json
import os as _os
from pathlib import Path as _Path
pw = (_os.environ.get("RELAY_ADMIN_PASSWORD") or "").strip()
if pw:
return pw
root = _Path(__file__).resolve().parent.parent
info = root / "_build" / "relay_info.json"
try:
data = _json.loads(info.read_text(encoding="utf-8"))
pw = str(data.get("adminPassword") or "").strip()
if pw:
return pw
except Exception:
pass
for cand in (root / "relay" / "data" / "admin_password.txt",
_Path("/root/lanremote-relay/data/admin_password.txt")):
try:
if cand.is_file():
return cand.read_text(encoding="utf-8").strip()
except Exception:
continue
return ""
def check(name, ok, detail=""):
global passed, failed
if ok:
passed += 1
print(" [PASS] " + name)
else:
failed += 1
print(" [FAIL] " + name + " " + str(detail))
def main() -> int:
print(f"中转地址: {URL}")
print()
jar = http.cookiejar.CookieJar()
opener = urllib.request.build_opener(
urllib.request.HTTPCookieProcessor(jar))
print("一、没登录时")
try:
_req = urllib.request.Request(URL + "/", headers=_UA)
with opener.open(_req, timeout=30) as resp:
body = resp.read().decode("utf-8", "replace")
status = resp.status
except urllib.error.HTTPError as exc:
status = exc.code
body = exc.read().decode("utf-8", "replace")
check("管理页返回 200(给登录页而不是错误)", status == 200, status)
check("看到的是登录页", "管理密码" in body or "登录" in body,
body[:80])
check("登录前不泄露设备信息", "配对码" not in body, "泄露了")
# 管理接口没登录
try:
_req = urllib.request.Request(URL + "/v1/admin/devices", headers=_UA)
with opener.open(_req, timeout=20) as resp:
status2 = resp.status
except urllib.error.HTTPError as exc:
status2 = exc.code
check("管理接口没登录被拒", status2 == 401, status2)
print()
print("二、密码错")
data = urllib.parse.urlencode({"username": "xmz7891", "password": "000000"}).encode()
req = urllib.request.Request(URL + "/admin/login", data=data, method="POST", headers=_UA)
req.add_header("Content-Type", "application/x-www-form-urlencoded")
try:
with urllib.request.urlopen(req, timeout=30) as resp:
bad_status = resp.status
bad_body = resp.read().decode("utf-8", "replace")
except urllib.error.HTTPError as exc:
bad_status = exc.code
bad_body = exc.read().decode("utf-8", "replace")
check("错密码被拒(重定向回登录页)", bad_status in (200, 302, 303),
bad_status)
check("错密码后没种 Cookie", len(jar) == 0, f"{len(jar)} 个 cookie")
print()
print("三、密码对")
data = urllib.parse.urlencode({"username": "xmz7891", "password": PASSWORD}).encode()
req = urllib.request.Request(URL + "/admin/login", data=data, method="POST", headers=_UA)
req.add_header("Content-Type", "application/x-www-form-urlencoded")
with opener.open(req, timeout=30) as resp:
login_status = resp.status
resp.read()
check("登录返回重定向", login_status in (200, 302), login_status)
cookies = [c.name for c in jar]
check("种下了 lr_admin Cookie", "lr_admin" in cookies, str(cookies))
print()
print("四、登录后")
with opener.open(urllib.request.Request(URL + "/", headers=_UA), timeout=30) as resp:
body = resp.read().decode("utf-8", "replace")
status = resp.status
check("能打开管理页", status == 200, status)
check("看到的是后台而不是登录页",
"配对码" in body or "登记设备" in body, body[:80])
check("页面上有退出登录", "退出" in body or "logout" in body.lower(), "")
with opener.open(urllib.request.Request(URL + "/v1/admin/devices", headers=_UA), timeout=30) as resp:
snap = json.loads(resp.read())
check("管理接口能拿到设备列表", snap.get("ok") is True, str(snap)[:80])
print()
print("五、退出登录")
try:
with opener.open(urllib.request.Request(URL + "/admin/logout", headers=_UA), timeout=30) as resp:
resp.read()
except urllib.error.HTTPError:
pass
try:
with opener.open(urllib.request.Request(URL + "/v1/admin/devices", headers=_UA), timeout=20) as resp:
after = resp.status
except urllib.error.HTTPError as exc:
after = exc.code
check("退出后管理接口又被拒", after == 401, after)
print()
print("六、脚本通道(X-Admin 头仍可用)")
req = urllib.request.Request(URL + "/v1/admin/devices", headers=_UA)
req.add_header("X-Admin", PASSWORD)
try:
with urllib.request.urlopen(req, timeout=20) as resp:
ok = resp.status
except urllib.error.HTTPError as exc:
ok = exc.code
check("X-Admin 传密码也能用(方便脚本)", ok == 200, ok)
print()
print("=" * 60)
print(f"通过 {passed} 项,失败 {failed} 项")
return 0 if failed == 0 else 1
if __name__ == "__main__":
sys.exit(main())