379 lines
18 KiB
Python
379 lines
18 KiB
Python
"""用户体系:鉴权中间件、登录/会话、角色闸门、账号管理与审计。
|
||
|
||
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
|