diff --git a/backend/app/api/v1/endpoints/auth.py b/backend/app/api/v1/endpoints/auth.py index da1e198..20e42de 100644 --- a/backend/app/api/v1/endpoints/auth.py +++ b/backend/app/api/v1/endpoints/auth.py @@ -7,6 +7,7 @@ from app.schemas.user import ( RefreshResponse, UserResponse, ) +from app.core.security import peek_token_identity from app.services.auth_service import login, refresh_access_token, get_current_user router = APIRouter(prefix="/auth", tags=["认证"]) @@ -34,8 +35,19 @@ def login_endpoint(data: LoginRequest, request: Request): @router.post("/refresh", response_model=RefreshResponse) -def refresh_endpoint(data: RefreshRequest): +def refresh_endpoint(data: RefreshRequest, request: Request): """刷新 Access Token — 使用 Refresh Token 换取新的 Access Token""" + # 本接口刻意不挂 get_current_user:能用到这里,正是因为 access token 已经 + # 过期/缺失,请求里没有 Authorization 头,JWT 依赖不会执行 → 审计拿不到操作人, + # 记录只能显示「未认证」。 + # 但 refresh token 里本来就带着完整身份(sub/username/display_name/role), + # 解出来写进 state,审计才能记到人 —— 而"谁在何时尝试刷新"正是要留痕的。 + # 注意 peek 只用于审计标注,鉴权判断一律走 get_current_user。 + identity = peek_token_identity(data.refresh_token) + if identity: + request.state.audit_user = identity.get("username") or identity.get("sub") + request.state.audit_display_name = identity.get("display_name") or "" + request.state.audit_role = identity.get("role") or "" return refresh_access_token(data.refresh_token) diff --git a/backend/app/core/security.py b/backend/app/core/security.py index a080707..aa3fbd0 100644 --- a/backend/app/core/security.py +++ b/backend/app/core/security.py @@ -39,6 +39,28 @@ def decode_token(token: str) -> dict: return jwt.decode(token, settings.SECRET_KEY, algorithms=[ALGORITHM]) +def peek_token_identity(token: str) -> dict | None: + """读出令牌里的用户身份 —— **仅供审计标注,绝不可用于授权**。 + + 与 decode_token 的唯一区别:**关闭过期校验**。 + + 为什么需要它:刷新令牌接口正是"access token 过期了才来"的场景, + 请求里不带 Authorization 头,JWT 依赖根本不执行,审计只能记成 + 「未认证」—— 而"谁在什么时候尝试刷新"恰恰是该留痕的信息。 + 签名校验照常进行,伪造的令牌解不出任何东西。 + + ⚠️ 返回值只允许写进 request.state 的审计字段; + 任何鉴权判断一律走 get_current_user,不要用本函数。 + """ + try: + return jwt.decode( + token, settings.SECRET_KEY, algorithms=[ALGORITHM], + options={"verify_exp": False}, + ) + except JWTError: + return None + + def verify_password(plain_password: str, hashed_password: str) -> bool: """验证明文密码 vs 哈希密码""" return pwd_context.verify(plain_password, hashed_password)