nex_animation/backend/tests/test_auth.py

379 lines
18 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

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