Initial commit
This commit is contained in:
commit
57fc3525eb
7311 files changed
+1291398
No files matched your search
@@ -0,0 +1,188 @@
|
||||
"""Local integration endpoints for the project-controlled browser."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import ipaddress
|
||||
from typing import Any, Dict
|
||||
from urllib.parse import urlparse
|
||||
|
||||
from typing import Optional
|
||||
|
||||
from fastapi import APIRouter, Header, HTTPException, Request
|
||||
from pydantic import BaseModel, Field
|
||||
|
||||
from app.core import get_browser
|
||||
from app.core.config import AppConfig, get_logger
|
||||
from app.core.http_security import is_trusted_local_request
|
||||
from app.utils.browser_profile_identity import resolve_tab_browser_profile
|
||||
from app.core.driver import browser_driver, driver_for_tab
|
||||
|
||||
|
||||
logger = get_logger("API.BROWSER")
|
||||
router = APIRouter(prefix="/api/browser", tags=["browser"])
|
||||
|
||||
|
||||
class OpenProfileUrlRequest(BaseModel):
|
||||
url: str = Field(min_length=1, max_length=8192)
|
||||
profile: Dict[str, Any] = Field(default_factory=dict)
|
||||
|
||||
|
||||
def _is_loopback(host: str) -> bool:
|
||||
try:
|
||||
return ipaddress.ip_address(str(host or "").split("%", 1)[0]).is_loopback
|
||||
except ValueError:
|
||||
return str(host or "").casefold() == "localhost"
|
||||
|
||||
|
||||
_INTERNAL_HOST_SUFFIXES = (
|
||||
"localhost",
|
||||
".localhost",
|
||||
".local",
|
||||
".internal",
|
||||
".lan",
|
||||
".home.arpa",
|
||||
)
|
||||
_METADATA_HOSTS = frozenset({"metadata.google.internal", "metadata", "instance-data"})
|
||||
|
||||
|
||||
def _valid_web_url(url: str) -> str:
|
||||
value = str(url or "").strip()
|
||||
parsed = urlparse(value)
|
||||
if parsed.scheme not in {"http", "https"} or not parsed.netloc:
|
||||
raise HTTPException(status_code=400, detail="只允许打开 http/https 链接")
|
||||
# S4:受控浏览器带着用户登录态,不替调用方打开本机/内网地址或带凭据的 URL
|
||||
if parsed.username is not None or parsed.password is not None:
|
||||
raise HTTPException(status_code=400, detail="链接不能包含用户名/密码")
|
||||
host = str(parsed.hostname or "").strip().rstrip(".").casefold()
|
||||
if not host or host in _METADATA_HOSTS or any(
|
||||
host == suffix.lstrip(".") or host.endswith(suffix)
|
||||
for suffix in _INTERNAL_HOST_SUFFIXES
|
||||
):
|
||||
raise HTTPException(status_code=400, detail="不允许打开本机/内部地址")
|
||||
try:
|
||||
literal = ipaddress.ip_address(host.split("%", 1)[0])
|
||||
except ValueError:
|
||||
literal = None
|
||||
if literal is not None and not literal.is_global:
|
||||
raise HTTPException(status_code=400, detail="不允许打开本机/内网 IP 地址")
|
||||
return value
|
||||
|
||||
|
||||
def verify_open_profile_url_auth(
|
||||
request: Request,
|
||||
authorization: Optional[str] = Header(None),
|
||||
) -> bool:
|
||||
"""S4:打开受控浏览器链接的鉴权。
|
||||
|
||||
- 带了 Authorization 且控制面板认证已启用:按管理令牌校验(错误令牌 401);
|
||||
- 否则仅接受「直接来自本机回环、没有任何反代/隧道转发头」的请求
|
||||
(经 start.py handoff 代理时以其注入的真实客户端地址为准)——
|
||||
Link Drawer 不保存面板密钥,仍可在本机使用;
|
||||
- 其余:认证已启用 → 401,未启用 → 403。
|
||||
"""
|
||||
from app.api.deps import verify_dashboard_token
|
||||
|
||||
dashboard_auth = AppConfig.is_dashboard_auth_enabled()
|
||||
if dashboard_auth and str(authorization or "").strip():
|
||||
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
|
||||
if dashboard_auth:
|
||||
raise HTTPException(
|
||||
status_code=401,
|
||||
detail="需要控制面板认证令牌",
|
||||
headers={"WWW-Authenticate": "Bearer"},
|
||||
)
|
||||
raise HTTPException(status_code=403, detail="此接口仅允许本机直接调用")
|
||||
|
||||
|
||||
def _target_info(tab: Any) -> Dict[str, Any]:
|
||||
try:
|
||||
result = driver_for_tab(tab).run_cdp("Target.getTargetInfo") or {}
|
||||
info = result.get("targetInfo") if isinstance(result, dict) else {}
|
||||
return info if isinstance(info, dict) else {}
|
||||
except Exception:
|
||||
return {}
|
||||
|
||||
|
||||
def _identity_matches(actual: Dict[str, Any], expected: Dict[str, Any]) -> bool:
|
||||
for key in ("profile_directory", "profile_path"):
|
||||
wanted = str(expected.get(key) or "").strip().casefold()
|
||||
if wanted:
|
||||
return str(actual.get(key) or "").strip().casefold() == wanted
|
||||
wanted_name = str(expected.get("name") or "").strip().casefold()
|
||||
return bool(wanted_name and str(actual.get("name") or "").strip().casefold() == wanted_name)
|
||||
|
||||
|
||||
def _find_profile_tab(browser: Any, profile: Dict[str, Any]) -> tuple[Any, str]:
|
||||
tabs = list(browser.get_tabs() or [])
|
||||
source_tab_id = str(profile.get("source_tab_id") or "").strip()
|
||||
expected_context = str(profile.get("browser_context_id") or "").strip()
|
||||
|
||||
for tab in tabs:
|
||||
info = _target_info(tab)
|
||||
tab_id = str(info.get("targetId") or getattr(tab, "tab_id", "") or "").strip()
|
||||
context_id = str(info.get("browserContextId") or "").strip()
|
||||
if source_tab_id and tab_id == source_tab_id:
|
||||
return tab, context_id
|
||||
if expected_context and context_id == expected_context:
|
||||
return tab, context_id
|
||||
|
||||
for tab in tabs:
|
||||
identity = resolve_tab_browser_profile(tab)
|
||||
if _identity_matches(identity, profile):
|
||||
info = _target_info(tab)
|
||||
return tab, str(info.get("browserContextId") or identity.get("browser_context_id") or "").strip()
|
||||
raise HTTPException(status_code=404, detail="受控浏览器中未找到对应用户目录")
|
||||
|
||||
|
||||
def open_url_in_profile(url: str, profile: Dict[str, Any]) -> Dict[str, Any]:
|
||||
if not isinstance(profile, dict) or not any(
|
||||
str(profile.get(key) or "").strip()
|
||||
for key in ("profile_directory", "profile_path", "name", "browser_context_id")
|
||||
):
|
||||
raise HTTPException(status_code=400, detail="缺少浏览器用户目录标识")
|
||||
|
||||
browser = get_browser(auto_connect=False)
|
||||
health = browser.health_check()
|
||||
if not isinstance(health, dict) or not health.get("connected"):
|
||||
raise HTTPException(status_code=503, detail="项目受控浏览器未连接")
|
||||
|
||||
source_tab, context_id = _find_profile_tab(browser, profile)
|
||||
handle = browser.get_browser_handle()
|
||||
try:
|
||||
kwargs: Dict[str, Any] = {"url": url}
|
||||
if context_id:
|
||||
kwargs["browserContextId"] = context_id
|
||||
created = browser_driver(handle).run_cdp("Target.createTarget", **kwargs) or {}
|
||||
target_id = str(created.get("targetId") or "").strip() if isinstance(created, dict) else ""
|
||||
if target_id:
|
||||
try:
|
||||
browser_driver(handle).run_cdp("Target.activateTarget", targetId=target_id)
|
||||
except Exception:
|
||||
pass
|
||||
return {"success": True, "targetId": target_id, "browserContextId": context_id}
|
||||
except Exception as error:
|
||||
# The default Chrome profile may not expose a context id. Opening from one
|
||||
# of its own pages keeps the new tab in that exact profile.
|
||||
try:
|
||||
script = "window.open(arguments[0], '_blank'); return true;"
|
||||
driver_for_tab(source_tab).run_js(script, url)
|
||||
return {"success": True, "targetId": "", "browserContextId": context_id}
|
||||
except Exception as fallback_error:
|
||||
logger.warning(f"打开用户目录链接失败: {error}; fallback={fallback_error}")
|
||||
raise HTTPException(status_code=502, detail="无法在对应用户目录中打开链接") from fallback_error
|
||||
|
||||
|
||||
# Link Drawer stores only routing metadata, not the dashboard secret. Without a
|
||||
# token only direct (non-proxied, non-tunneled) loopback callers are accepted.
|
||||
@router.post("/open-profile-url")
|
||||
def open_profile_url(
|
||||
payload: OpenProfileUrlRequest,
|
||||
request: Request,
|
||||
authorization: Optional[str] = Header(None),
|
||||
):
|
||||
verify_open_profile_url_auth(request, authorization)
|
||||
return open_url_in_profile(_valid_web_url(payload.url), payload.profile)
|
||||
Reference in new issue
Block a user