Initial commit
This commit is contained in:
commit
57fc3525eb
7311 files changed
+1291398
No files matched your search
+131
@@ -0,0 +1,131 @@
|
||||
"""
|
||||
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)",
|
||||
)
|
||||
Reference in new issue
Block a user