unis_manager/app/security.py

272 lines
12 KiB
Python
Executable File
Raw 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.

"""登录与权限(RBAC)。
三层模型:**用户 ←(多对多)→ 角色 ←(一对多)→ 菜单授权**
· `role_menus` 存授权矩阵:一行 = 一个菜单一个级别,`rw` 可编辑 / `ro` 只读,
表里没有这一行就是看不到该菜单;
· 一个用户可以挂多个角色,最终权限取并集(同一菜单取更高级别);
· 菜单权限同时管两端:前端按 `/auth/me` 返回的 menus 过滤侧栏与写操作按钮,
后端 `guard` 按「请求路径 → 菜单 → 级别」二次校验,直接调接口也绕不过去;
· 所有写操作与登录行为写进 `audit_logs`,在「权限管理 → 操作日志」里查。
会话是服务端 token(HttpOnly Cookie),退出登录 / 停用 / 改密 / 强制下线都是删 token,立即失效。
密码只存 pbkdf2 派生值,用标准库,不引额外依赖。
"""
from __future__ import annotations
import hashlib
import hmac
import secrets
from datetime import timedelta
from fastapi import Depends, HTTPException, Request
from sqlalchemy.orm import Session
from . import config
from .constants import (
LEVEL_LABELS,
LEVEL_RANK,
LEVELS,
MENU_KEYS,
MENU_LABELS,
)
from .db import get_db
from .models import Role, RoleMenu, User, UserRole, UserSession, now
SESSION_COOKIE = "unis_session"
PBKDF2_ROUNDS = 120_000
__all__ = [
"MENU_KEYS", "MENU_LABELS", "LEVELS", "LEVEL_LABELS",
"SESSION_COOKIE", "normalize_menus", "hash_password", "verify_password",
"start_session", "revoke_all", "user_from_token", "current_user", "guard",
"resolve_rule", "ensure_seed",
]
# 接口路径首段 -> 菜单。没列出来的(/meta 等)只要求登录,不看菜单。
SEGMENT_MENU = {
"focus": "focus",
"weekly": "board",
"projects": "projects",
"categories": "projects",
"updates": "projects",
"custom": "custom",
"staff": "staff",
"ai": "intake",
"settings": "settings",
"rbac": "rbac",
"periods": "settings",
}
# /export/xxx 跟着对应页面走
EXPORT_MENU = {
"custom": "custom",
"custom-updates": "custom",
"projects": "projects",
"updates": "projects",
"staff": "staff",
"focus": "focus",
}
# ------------------------------------------------------------------ 权限表
def normalize_menus(raw) -> dict:
"""清洗前端传来的权限表:只留已知菜单 + 合法级别。"""
out: dict[str, str] = {}
for key, value in (raw or {}).items():
if key in MENU_LABELS and value in LEVELS:
out[key] = value
return out
# ------------------------------------------------------------------ 密码
def hash_password(password: str) -> tuple[str, str]:
salt = secrets.token_hex(16)
digest = hashlib.pbkdf2_hmac("sha256", password.encode(), bytes.fromhex(salt), PBKDF2_ROUNDS)
return digest.hex(), salt
def verify_password(password: str, password_hash: str, salt: str) -> bool:
try:
digest = hashlib.pbkdf2_hmac(
"sha256", (password or "").encode(), bytes.fromhex(salt), PBKDF2_ROUNDS
)
except ValueError:
return False
return hmac.compare_digest(digest.hex(), password_hash)
# ------------------------------------------------------------------ 会话
def _clip(value: str | None, size: int) -> str | None:
return value[:size] if value else None
def start_session(db: Session, user: User, ip: str | None = None,
user_agent: str | None = None) -> str:
token = secrets.token_urlsafe(32)
db.add(UserSession(token=token, user_id=user.id,
expires_at=now() + timedelta(days=config.SESSION_DAYS),
ip=_clip(ip, 64), user_agent=_clip(user_agent, 128)))
user.last_login_at = now()
db.commit()
return token
def revoke_all(db: Session, user_id: int, keep_token: str | None = None) -> None:
q = db.query(UserSession).filter(UserSession.user_id == user_id)
if keep_token:
q = q.filter(UserSession.token != keep_token)
q.delete(synchronize_session=False)
db.commit()
def purge_expired_sessions(db: Session) -> int:
q = db.query(UserSession).filter(UserSession.expires_at < now())
n = q.count()
if n:
q.delete(synchronize_session=False)
db.commit()
return n
def user_from_token(db: Session, token: str | None) -> User | None:
if not token:
return None
sess = db.get(UserSession, token)
if sess is None or sess.expires_at < now():
return None
user = db.get(User, sess.user_id)
if user is None or not user.active:
return None
return user
# ------------------------------------------------------------------ 内置数据
BUILTIN_ROLES = [
("管理员", "全部菜单可编辑,含设置与权限管理", {k: "rw" for k in MENU_KEYS}, True),
("部门成员", "业务菜单可编辑,不能改设置与权限",
{k: "rw" for k in MENU_KEYS if k not in ("settings", "rbac")}, True),
("只读访客", "只能查看,不能修改任何数据",
{k: "ro" for k in MENU_KEYS if k != "rbac"}, True),
]
def ensure_seed(db: Session) -> list[str]:
"""首次启动(或升级后)补内置角色与管理员账号,返回新建的提示项。"""
notes: list[str] = []
for name, desc, menus, builtin in BUILTIN_ROLES:
role = db.query(Role).filter(Role.name == name).one_or_none()
if role is None:
role = Role(name=name, description=desc, is_builtin=builtin)
db.add(role)
db.flush()
notes.append(f"已创建内置角色「{name}」")
if not db.query(RoleMenu).filter(RoleMenu.role_id == role.id).count():
for menu, level in normalize_menus(menus).items():
db.add(RoleMenu(role_id=role.id, menu=menu, level=level))
admin_role = db.query(Role).filter(Role.name == "管理员").one()
if not db.query(User).count():
pw_hash, salt = hash_password(config.ADMIN_PASSWORD)
user = User(name=config.ADMIN_USERNAME, username=config.ADMIN_USERNAME,
password_hash=pw_hash, password_salt=salt, active=True)
db.add(user)
db.flush()
db.add(UserRole(user_id=user.id, role_id=admin_role.id))
notes.append(f"已创建管理员账号 {config.ADMIN_USERNAME}(请尽快在用户设置里改密码)")
else:
# 保证系统里至少有一个「启用 + 能管权限」的账号,不会把自己锁在门外。
# 兜底顺序:启但没挂管理员的最早账号 → 全员停用时启用最早账号;插入前先查重,避免撞 user_roles 唯一键。
guarded = [u for u in db.query(User).filter(User.active.is_(True)).all()
if u.menus.get("rbac") == "rw"]
if not guarded:
active = db.query(User).filter(User.active.is_(True)).order_by(User.id).all()
target = active[0] if active else db.query(User).order_by(User.id).first()
if target is not None:
dup = db.query(UserRole).filter_by(user_id=target.id, role_id=admin_role.id).first()
if not dup:
db.add(UserRole(user_id=target.id, role_id=admin_role.id))
revived = ""
if not target.active:
target.active = True
revived = "并重新启用"
notes.append(f"已把「管理员」角色{revived}补给 {target.username},避免没人能管权限")
db.commit()
return notes
# ------------------------------------------------------------------ 依赖
READ_METHODS = ("GET", "HEAD", "OPTIONS")
def resolve_rule(path: str, method: str):
"""请求 -> (菜单, 是否写操作);菜单为 None 表示只要登录就能访问。"""
parts = [x for x in path.split("/") if x] # /api/custom/projects -> [...]
if len(parts) >= 2 and parts[0] == "api" and parts[1] == "export":
name = parts[2] if len(parts) > 2 else ""
menu = EXPORT_MENU.get(name)
if menu is None:
# fail-closed:新增 /export/* 必须先在 EXPORT_MENU 登记归属菜单,否则一律 403,
# 不会出现「忘了挂权限、任何登录用户都能下载」的窗口。
raise HTTPException(status_code=403, detail=f"导出接口「{name}」未登记权限归属,禁止访问")
elif len(parts) >= 2 and parts[0] == "api":
menu = SEGMENT_MENU.get(parts[1])
else:
menu = None
if menu is None:
return None
# 周期表:所有页面顶栏都要读,只有新建/删除算设置页的写操作
if len(parts) >= 2 and parts[1] == "periods" and method in READ_METHODS:
return None
return menu, method not in READ_METHODS
def guard(request: Request, db: Session = Depends(get_db)) -> User | None:
"""挂在 /api 子应用上的总闸:先验登录,再按菜单权限放行。"""
path = request.url.path
if path.rstrip("/") == "/api/auth/login":
return None
user = user_from_token(db, request.cookies.get(SESSION_COOKIE))
request.state.user = user
if user is None:
raise HTTPException(status_code=401, detail="登录已失效,请重新登录")
if path.startswith("/api/rbac/"):
# 权限管理自身必须显式授权,普通用户即使能读别的菜单也不能碰
if "rbac" not in user.menus:
raise HTTPException(status_code=403, detail=f"没有「{MENU_LABELS['rbac']}」的访问权限")
if request.method not in READ_METHODS and user.menus.get("rbac") != "rw":
raise HTTPException(status_code=403, detail=f"「{MENU_LABELS['rbac']}」是只读权限,不能修改")
return user
# 录入页跨菜单依赖:录入定制项目必须能读定制元数据 / 项目清单,并写交付记录(含 AI 整理 / AI 落库)。
# 只给「更新录入」权限的账号也要能完成录入,这几个接口按 custom / intake 两者中较高的级别放行;
# 定制项目其余接口(详情、修改、归档……)仍严格走 custom 菜单。
assist_reads = ("/api/custom/meta", "/api/custom/projects")
assist_writes = ("/api/custom/updates", "/api/custom/ai/parse", "/api/custom/ai/commit")
assist = ((request.method in READ_METHODS and path in assist_reads)
or (request.method == "POST" and path in assist_writes))
if assist:
need_write = request.method not in READ_METHODS
have = max((user.menus.get(m, "") for m in ("custom", "intake")),
key=lambda x: LEVEL_RANK.get(x, 0))
if have and (not need_write or have == "rw"):
return user
pair = f"「{MENU_LABELS['intake']}」或「{MENU_LABELS['custom']}」"
raise HTTPException(status_code=403, detail=(
f"操作定制项目需要{pair}的可编辑权限" if need_write
else f"查看定制项目需要{pair}的查看权限"))
rule = resolve_rule(path, request.method)
if rule is None:
return user
menu, need_write = rule
level = user.menus.get(menu)
if not level:
raise HTTPException(status_code=403, detail=f"没有「{MENU_LABELS.get(menu, menu)}」的访问权限")
if need_write and level != "rw":
raise HTTPException(status_code=403, detail=f"「{MENU_LABELS.get(menu, menu)}」是只读权限,不能修改")
return user
def current_user(request: Request, db: Session = Depends(get_db)) -> User:
user = user_from_token(db, request.cookies.get(SESSION_COOKIE))
if user is None:
raise HTTPException(status_code=401, detail="请先登录")
request.state.user = user
return user