Files
2026-11-02 22:54:14 +08:00

132 lines
4.3 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""
app/api/deps.py - API 共享依赖
"""
import hmac
from typing import Iterable, Optional
from fastapi import Header, HTTPException, Request
from app.core.config import AppConfig
from app.core.http_security import is_trusted_local_request
def extract_authorization_token(authorization: Optional[str]) -> str:
"""Extract a token from Authorization, accepting raw tokens and Bearer schemes."""
raw = str(authorization or "").strip()
if raw.lower().startswith("bearer "):
return raw[7:].strip()
return raw
def _auth_candidates(
authorization: Optional[str],
x_api_key: Optional[str] = None,
) -> list[str]:
candidates: list[str] = []
if isinstance(authorization, str) and authorization.strip():
raw = authorization.strip()
candidates.append(raw)
extracted = extract_authorization_token(raw)
if extracted and extracted != raw:
candidates.append(extracted)
if isinstance(x_api_key, str) and x_api_key.strip():
candidates.append(x_api_key.strip())
return candidates
def _verify_token_candidates(
*,
enabled: bool,
token_value: str,
candidates: Iterable[str],
) -> None:
if not enabled:
return
expected = str(token_value or "").strip()
if not expected:
raise HTTPException(status_code=500, detail="服务配置错误")
normalized = [str(item or "").strip() for item in candidates if str(item or "").strip()]
if not normalized:
raise HTTPException(
status_code=401,
detail="未提供认证令牌",
headers={"WWW-Authenticate": "Bearer"},
)
# 修复6: str 版 compare_digest 遇到非 ASCII 令牌会抛 TypeError 导致 500,统一按 UTF-8 编码后比较
expected_bytes = expected.encode("utf-8")
if not any(
hmac.compare_digest(expected_bytes, candidate.encode("utf-8"))
for candidate in normalized
):
raise HTTPException(
status_code=401,
detail="认证令牌无效",
headers={"WWW-Authenticate": "Bearer"},
)
def verify_service_token(
authorization: Optional[str] = None,
x_api_key: Optional[str] = None,
) -> None:
_verify_token_candidates(
enabled=AppConfig.is_auth_enabled(),
token_value=AppConfig.get_auth_token(),
candidates=_auth_candidates(authorization, x_api_key),
)
def verify_dashboard_token(authorization: Optional[str] = None) -> None:
_verify_token_candidates(
enabled=AppConfig.is_dashboard_auth_enabled(),
token_value=AppConfig.get_dashboard_auth_token(),
candidates=_auth_candidates(authorization),
)
async def verify_service_auth(
authorization: Optional[str] = Header(None),
x_api_key: Optional[str] = Header(None, alias="X-API-Key"),
) -> bool:
"""验证对外服务 API 的 Bearer Token 或 X-API-Key。"""
verify_service_token(authorization=authorization, x_api_key=x_api_key)
return True
async def verify_dashboard_auth(authorization: Optional[str] = Header(None)) -> bool:
"""验证控制面板管理接口的访问密钥。"""
verify_dashboard_token(authorization=authorization)
return True
async def verify_auth(authorization: Optional[str] = Header(None)) -> bool:
"""向后兼容:默认用于控制面板管理接口。"""
return await verify_dashboard_auth(authorization)
async def verify_sensitive_admin_auth(
request: Request,
authorization: Optional[str] = Header(None),
) -> bool:
"""高敏感管理接口(完整备份导出/导入、打开受控浏览器等)的鉴权。
- 控制面板认证已启用:必须提供有效令牌(与 verify_dashboard_auth 相同);
- 未启用:不再无条件放行,只接受「直接来自本机回环、未经反代/隧道转发」的请求,
其余一律 403,并提示启用 DASHBOARD_AUTH_*。(审查条目 S13 / S4)
"""
if AppConfig.is_dashboard_auth_enabled():
verify_dashboard_token(authorization=authorization)
return True
client_host = request.client.host if request.client else None
if is_trusted_local_request(client_host, request.headers):
return True
raise HTTPException(
status_code=403,
detail="该接口仅允许本机直接访问;远程访问请先启用控制面板认证(DASHBOARD_AUTH_ENABLED / DASHBOARD_AUTH_TOKEN)",
)