"""用户体系:鉴权中间件、登录/会话、角色闸门、账号管理与审计。 conftest 默认 AUTH_ENABLED=false(既有出片链路不关心登录), 所以这里的用例会显式把 settings.auth_enabled 打开。 """ from __future__ import annotations import pytest from sqlalchemy import select from app.config import settings from app.db import SessionLocal from app.models import EventLog, User, UserSession from app.services import auth as auth_service # 口令不写死:播种用的是 settings.bootstrap_password,写死第二遍迟早对不上 ADMIN = {"username": settings.bootstrap_username, "password": settings.bootstrap_password} @pytest.fixture def secured(client, monkeypatch): """开启鉴权后的 TestClient(lifespan 已播种 settings 里那个初始管理员)。""" monkeypatch.setattr(settings, "auth_enabled", True) return client def login(client, username: str, password: str): return client.post("/api/auth/login", json={"username": username, "password": password}) def sign_in(client, username: str, password: str, **kw) -> str: """登录并返回 token(cookie 与 Bearer 用的是同一个值),便于再开独立会话。""" res = login(client, username, password, **kw) assert res.status_code == 200, res.text # 会话令牌只走 HttpOnly Cookie,前端拿不到,测试也从 cookie 里取 return res.cookies.get(settings.cookie_name) # ------------------------------------------------------------------ 状态与闸门 def test_state_is_reachable_even_when_anonymous(secured): res = secured.get("/api/auth/state") assert res.status_code == 200 body = res.json() assert body["auth_enabled"] is True and body["authenticated"] is False assert body["user"] is None assert body["login_hint"]["username"] == settings.bootstrap_username def test_business_api_and_media_require_login(secured): for url in ("/api/projects", "/api/projects/1/agent/runs", "/api/meta", "/media/whatever.png"): res = secured.get(url) assert res.status_code == 401, (url, res.status_code, res.text[:200]) assert res.headers.get("www-authenticate") == "Bearer" # 探针类路径必须一直放行,否则容器健康检查会把实例判定为不健康 assert secured.get("/health").status_code == 200 def test_login_rejects_bad_password_and_audits(secured, db): res = login(secured, "admin", "wrong-password") assert res.status_code == 401 assert res.json()["detail"] == "登录名或密码不正确" trail = db.scalars(select(EventLog).where(EventLog.action == "user.login_failed")).all() assert trail and "admin" in trail[0].message def test_login_logout_roundtrip(secured): token = sign_in(secured, **ADMIN) state = secured.get("/api/auth/state").json() assert state["authenticated"] is True assert state["user"]["role"] == "admin" assert state["user"]["must_change_password"] is True # 种子账号仍带着「请改密」标记 assert secured.post("/api/auth/logout").status_code == 200 assert secured.get("/api/auth/state").json()["authenticated"] is False # 登出后令牌必须真的作废,而不是只清前端状态 res = secured.get("/api/projects", headers={"Authorization": f"Bearer {token}"}) assert res.status_code == 401 def test_bearer_token_usable_by_scripts(secured): token = sign_in(secured, **ADMIN) assert secured.get("/api/projects", headers={"Authorization": f"Bearer {token}"}).status_code == 200 def test_unknown_or_tampered_token_is_401(secured): sign_in(secured, **ADMIN) secured.cookies.set(settings.cookie_name, "not-a-real-token") assert secured.get("/api/projects").status_code == 401 # ------------------------------------------------------------------ 改密 def test_password_change_returns_nested_result_and_kicks_other_devices(secured): """回归:/api/auth/password 的 revoked_sessions 必须在 result 里, 否则前端 api.unwrap() 会把它丢掉,界面永远提示「注销了 0 个会话」。""" other = sign_in(secured, **ADMIN) # 第一台设备 secured.cookies.clear() sign_in(secured, **ADMIN) # 第二台设备(当前) assert secured.get("/api/auth/me").json()["user"]["active_sessions"] == 2 res = secured.post("/api/auth/password", json={"current_password": ADMIN["password"], "new_password": "FreshPass2026"}) assert res.status_code == 200, res.text body = res.json() assert body["ok"] is True and set(body["result"]) == {"user", "revoked_sessions"} assert body["result"]["revoked_sessions"] == 1 assert body["result"]["user"]["must_change_password"] is False # 当前会话留着,旧设备的会话没了 assert secured.get("/api/auth/state").json()["authenticated"] is True assert secured.get("/api/projects", headers={"Authorization": f"Bearer {other}"}).status_code == 401 # 新密码生效 secured.cookies.clear() assert login(secured, "admin", "FreshPass2026").status_code == 200 def test_password_change_validates_current_password(secured): sign_in(secured, **ADMIN) assert secured.post("/api/auth/password", json={ "current_password": "nope-not-it", "new_password": "FreshPass2026"}).status_code == 400 assert secured.post("/api/auth/password", json={ "current_password": ADMIN["password"], "new_password": ADMIN["password"]}).status_code == 400 assert secured.post("/api/auth/password", json={ "current_password": ADMIN["password"], "new_password": "abc"}).status_code == 400 def test_disabled_account_cannot_log_in(secured): sign_in(secured, **ADMIN) made = secured.post("/api/users", json={"username": "watcher", "password": "Viewer#2026", "role": "viewer"}).json()["result"] secured.delete(f"/api/users/{made['id']}") secured.cookies.clear() res = login(secured, "watcher", "Viewer#2026") assert res.status_code == 403 and "停用" in res.json()["detail"] # ------------------------------------------------------------------ 角色闸门 @pytest.fixture def member(secured): """建一个非管理员账号并返回 (id, 登录函数)。""" def make(role: str, username: str) -> int: secured.cookies.clear() sign_in(secured, **ADMIN) body = secured.post("/api/users", json={"username": username, "password": f"{role}Pass#2026", "role": role}).json() return body["result"]["id"] return make def test_viewer_can_read_but_not_write(secured, member): member("viewer", "watcher") secured.cookies.clear() sign_in(secured, "watcher", "viewerPass#2026") assert secured.get("/api/projects").status_code == 200 res = secured.post("/api/projects", json={"name": "观摩生的尝试"}) assert res.status_code == 403 and "观摩" in res.json()["detail"] def test_editor_writes_projects_but_not_users_or_providers(secured, member): member("editor", "maker") secured.cookies.clear() sign_in(secured, "maker", "editorPass#2026") assert secured.post("/api/projects", json={"name": "制作建的项目"}).status_code == 200 assert secured.get("/api/users").status_code == 403 assert secured.post("/api/users", json={"username": "x2", "password": "Whatever#2026"}).status_code == 403 assert secured.patch("/api/providers/mock", json={}).status_code == 403 def test_non_admin_cannot_open_user_admin_api(secured, member): member("editor", "maker") secured.cookies.clear() sign_in(secured, "maker", "editorPass#2026") assert secured.get("/api/users/audit").status_code == 403 def test_api_key_reveal_is_admin_only_and_actually_returns_plaintext(secured, member, db): """模型列表只回掩码,所以页面上的「眼睛」图标必须真的能取回明文(否则点了像坏了): 只读、仅管理员可取,并且每次查看都留一条审计(谁看了哪条密钥)。""" def unwrap(res): body = res.json() assert res.status_code == 200, body return body["result"] if isinstance(body, dict) and "result" in body else body sign_in(secured, **ADMIN) secret = "sk-reveal-me-8899001122" spec_id = unwrap(secured.post("/api/providers", json={ "provider": "dashscope", "model": "reveal-test", "display_name": "密钥回显测试", "media_type": "llm", "adapter": "http_llm", "api_key": secret, }))["id"] listing = unwrap(secured.get("/api/providers")) row = next(x for x in listing["providers"] if x["id"] == spec_id) assert row["has_api_key"] is True and secret not in repr(row) # 列表只给掩码 assert row["api_key_masked"].endswith(secret[-4:]) plain = unwrap(secured.get(f"/api/providers/{spec_id}/api-key")) assert plain["api_key"] == secret and plain["set"] is True trail = db.scalars(select(EventLog).where(EventLog.action == "model.api_key_revealed")).all() assert trail and trail[-1].actor == "admin" and "reveal-test" in trail[-1].message # 没配密钥的模型要回空值而不是 500,前端据此提示「这条模型没有保存密钥」 bare_id = unwrap(secured.post("/api/providers", json={ "provider": "bare", "model": "bare-1", "media_type": "llm", "adapter": "http_llm"}))["id"] empty = unwrap(secured.get(f"/api/providers/{bare_id}/api-key")) assert empty["set"] is False and empty["api_key"] == "" member("editor", "maker") secured.cookies.clear() sign_in(secured, "maker", "editorPass#2026") assert secured.get(f"/api/providers/{spec_id}/api-key").status_code == 403 # ------------------------------------------------------------------ 账号管理守卫 def test_admin_can_create_search_and_update(secured, member): uid = member("editor", "maker") secured.cookies.clear() sign_in(secured, **ADMIN) listed = secured.get("/api/users", params={"q": "mak"}).json() assert [row["username"] for row in listed["items"]] == ["maker"] assert listed["counts"]["total"] == 2 and listed["counts"]["admins"] == 1 updated = secured.patch(f"/api/users/{uid}", json={"display_name": "阿做", "note": "内测"}).json()["result"] assert updated["display_name"] == "阿做" and updated["note"] == "内测" assert updated["created_by"] == "admin" # 归属要留痕 def test_admin_cannot_lock_itself_out(secured): sign_in(secured, **ADMIN) me = secured.get("/api/auth/me").json()["user"] assert secured.delete(f"/api/users/{me['id']}").status_code == 400 # 停用自己 assert secured.patch(f"/api/users/{me['id']}", json={"role": "editor"}).status_code == 400 # 造第二个管理员后,第一个才允许被调整,避免「最后一个管理员」误伤 second = secured.post("/api/users", json={"username": "admin2", "password": "AdminTwo#2026", "role": "admin"}).json()["result"] assert secured.patch(f"/api/users/{second['id']}", json={"role": "viewer"}).status_code == 200 assert secured.delete(f"/api/users/{second['id']}").status_code == 200 assert secured.get("/api/users", params={"role": "viewer"}).json()["items"][0]["username"] == "admin2" def test_user_list_filters_are_server_side(secured, member): """账号列表的三档状态筛选(页面顶部三张统计卡点的就是它们)与 q / role 可叠加。 口径:`items` 跟随筛选,`counts` 恒为全库数——否则统计卡一点就把自己的数字点没了。 """ watcher = member("viewer", "watcher") maker = member("editor", "maker") secured.cookies.clear() sign_in(secured, **ADMIN) def names(**params): return [row["username"] for row in secured.get("/api/users", params=params).json()["items"]] whole = secured.get("/api/users").json() assert [row["username"] for row in whole["items"]] == ["admin", "watcher", "maker"] assert whole["counts"]["total"] == 3 and whole["counts"]["disabled"] == 0 # 新建的账号一律先落在「待改初始密码」;播种出来的管理员用的还是默认口令, # 所以它自己也在这一档里——这一档数的是「还没改过自己密码且还能登录」的账号。 assert whole["counts"]["pending_password"] == 3 assert names(status="pending") == ["admin", "watcher", "maker"] assert names(status="active") == ["admin", "watcher", "maker"] assert names(status="disabled") == [] # 管理员代改密码并勾掉「下次登录改密」之后,该账号才离开 pending 这一档 secured.post(f"/api/users/{maker}/password", json={"new_password": "Rotated#2026", "must_change": False, "revoke_sessions": True}) assert names(status="pending") == ["admin", "watcher"] secured.delete(f"/api/users/{watcher}") assert names(status="disabled") == ["watcher"] assert names(status="active") == ["admin", "maker"] assert names(status="pending") == ["admin"] # 停用账号不再算待改口令 # 停用是「收回登录权」,不是从库里抹掉:全量列表与 counts 都还看得见它 disabled = secured.get("/api/users", params={"status": "disabled"}).json() assert disabled["counts"]["total"] == 3 and disabled["counts"]["disabled"] == 1 # 角色 + 状态 + 关键词三个条件叠加,与页面上「统计卡 + 两条下拉 + 搜索框」一一对应 assert names(role="viewer", status="disabled") == ["watcher"] assert names(q="wat", status="disabled") == ["watcher"] assert names(q="wat", status="active") == [] # 非法档位直接 400,不让前端把拼错的参数静默当成「没筛」 assert secured.get("/api/users", params={"status": "nope"}).status_code == 400 assert secured.get("/api/users", params={"role": "nope"}).status_code == 400 def test_duplicate_username_rejected(secured): sign_in(secured, **ADMIN) res = secured.post("/api/users", json={"username": "admin", "password": "Another#2026"}) assert res.status_code == 409 def test_weak_password_rejected(secured): sign_in(secured, **ADMIN) res = secured.post("/api/users", json={"username": "weaky", "password": "12345678"}) assert res.status_code == 400 and "常见" in res.json()["detail"] def test_admin_reset_password_revokes_sessions(secured, member): uid = member("editor", "maker") secured.cookies.clear() sign_in(secured, "maker", "editorPass#2026") mine = secured.get("/api/auth/me").json() assert secured.delete(f"/api/auth/sessions/{mine['sessions'][0]['id']}").status_code == 400 # 不能踢自己 secured.cookies.clear() sign_in(secured, **ADMIN) assert secured.post(f"/api/users/{uid}/password", json={ "new_password": "Rotated#2026", "must_change": True, "revoke_sessions": True}).status_code == 200 with SessionLocal() as session: assert session.scalar(select(UserSession).where(UserSession.user_id == uid, UserSession.revoked_at.is_(None))) is None secured.cookies.clear() assert login(secured, "maker", "Rotated#2026").json()["result"]["user"]["must_change_password"] is True def test_kick_sessions_keeps_account_usable(secured, member): uid = member("editor", "maker") secured.cookies.clear() sign_in(secured, "maker", "editorPass#2026") # 先让 TA 真的有一台在线设备 secured.cookies.clear() sign_in(secured, **ADMIN) assert secured.post(f"/api/users/{uid}/sessions/revoke").json()["result"]["revoked"] == 1 secured.cookies.clear() assert login(secured, "maker", "editorPass#2026").status_code == 200 # ------------------------------------------------------------------ 审计与归属 def test_audit_trail_records_who_did_what(secured, member): uid = member("editor", "maker") secured.cookies.clear() sign_in(secured, **ADMIN) secured.post("/api/projects", json={"name": "归属测试"}) secured.patch(f"/api/users/{uid}", json={"note": "补一条变更流水"}) secured.post(f"/api/users/{uid}/sessions/revoke") items = secured.get("/api/users/audit").json()["items"] secured.post("/api/auth/logout") # 退出之后审计接口必须锁上,不然任何人拿到 URL 就能翻全站账号流水 assert secured.get("/api/users/audit").status_code == 401 secured.cookies.clear() sign_in(secured, **ADMIN) items = secured.get("/api/users/audit").json()["items"] actions = {row["action"] for row in items} assert {"user.login", "user.logout", "user.created", "user.updated", "user.sessions_revoked"} <= actions # 审计里的操作人必须是登录名(显示名可重名、可修改,不能当身份用) assert all(row["actor"] == "admin" for row in items if row["action"] != "user.bootstrap") def test_project_events_carry_the_operator(secured): sign_in(secured, **ADMIN) pid = secured.post("/api/projects", json={"name": "谁改的"}).json()["result"]["id"] secured.patch(f"/api/projects/{pid}", json={"description": "带操作人"}) detail = secured.get(f"/api/projects/{pid}").json()["result"] assert detail["updated_by"] == "admin" and detail["created_by"] == "admin" rows = secured.get(f"/api/projects/{pid}/events").json()["events"] assert any(row.get("actor") == "admin" for row in rows), rows[:3] def test_session_list_exposes_device_labels(secured): sign_in(secured, **ADMIN) body = secured.get("/api/auth/me").json() assert len(body["sessions"]) == 1 current = body["sessions"][0] assert current["current"] is True and current["label"] # ------------------------------------------------------------------ 关掉鉴权 def test_auth_disabled_restores_open_access(client, monkeypatch): """部署时可以把整套登录关掉(局域网单机):此时不得有任何 401, 并且要有一个虚拟管理员让「谁做的」审计继续工作。""" monkeypatch.setattr(settings, "auth_enabled", False) assert client.get("/api/auth/state").json()["user"]["username"] == "local" pid = client.post("/api/projects", json={"name": "无登录模式"}).json()["result"]["id"] assert client.get(f"/api/projects/{pid}").status_code == 200 assert client.get("/api/users").status_code == 200