Add explicit legacy/broker configuration. Broker mode requires a protected keyring, product-approved permission profiles and enabled platform OAuth; production requires PostgreSQL. Default legacy behavior stays unchanged. Wire the broker to v2 signed device status, authorization start/status and access-token issuance routes. Bind proofs to protocol, environment, app, method/path and complete payload; verify nonce, certificate, owner and binding generation. Add an additive generation migration and return the current generation in binding receipts or authenticated bootstrap status. Persist encrypted OAuth state and atomically claim callbacks. Verify the actual consenting user, supersede older pending authorization intents and recheck bindings/transactions before credential writes and issuance. Preserve rotated credentials if unbind occurs mid-refresh, but deny issuance. Return an explicit access-only response and record metadata-only audit. Extract shared legacy device authentication so notifications do not depend on the business proxy module. Broker mode omits legacy refresh/claim/start and /work/api routes; authorization cards reference server-owned v2 transactions. Document signatures, configuration and migration boundaries. Validation: 185 passed, 3 skipped (real PostgreSQL not configured), with 15 existing dependency deprecation warnings. New API coverage: 38 passed, 1 real PostgreSQL case skipped. AST, docs and staged diff checks pass. No production deployment, key generation, client upgrade or real Work API calls were performed. Compose/mount configuration, full unbind/connection compensation and durable message-task lifecycle remain later stages.
88 lines
4.7 KiB
Python
88 lines
4.7 KiB
Python
from pathlib import Path
|
|
import re
|
|
from urllib.parse import urlsplit
|
|
from pydantic import model_validator
|
|
from pydantic_settings import BaseSettings, SettingsConfigDict
|
|
|
|
|
|
class Settings(BaseSettings):
|
|
model_config = SettingsConfigDict(env_prefix="HN_", extra="ignore", hide_input_in_errors=True)
|
|
environment: str = "production"
|
|
role: str = "connector"
|
|
redis_url: str = "redis://127.0.0.1:6379/0"
|
|
data_dir: Path = Path("runtime/connector")
|
|
database_url: str = ""
|
|
admin_secret: str = ""
|
|
internal_secret: str = ""
|
|
ca_cert: Path = Path("runtime/pki/ca.pem")
|
|
connector_key: Path = Path("runtime/pki/connector.key")
|
|
connector_public_key: Path = Path("runtime/pki/connector.pub")
|
|
public_url: str = "https://relay.example.invalid"
|
|
router_url: str = "wss://relay.example.invalid/device/ws"
|
|
device_domain: str = ""
|
|
feishu_api_base: str = "https://open.feishu.cn"
|
|
feishu_authorize_url: str = "https://open.feishu.cn/open-apis/authen/v1/authorize"
|
|
feishu_oauth_scopes: str = ""
|
|
feishu_app_id: str = ""
|
|
feishu_app_secret: str = ""
|
|
feishu_encrypt_key: str = ""
|
|
feishu_verification_token: str = ""
|
|
feishu_enabled: bool = False
|
|
oauth_enabled: bool = True
|
|
feishu_event_source: str = "longconn"
|
|
proxy_enabled: bool = False
|
|
# A fixed allowlist, never a user supplied upstream URL.
|
|
proxy_paths: str = "/open-apis/drive/v1/files,/open-apis/docx/v1/documents"
|
|
request_timeout: int = 45
|
|
max_body: int = 262144
|
|
max_pending: int = 1000
|
|
max_devices: int = 1000
|
|
max_connections: int = 1000
|
|
max_result: int = 16000
|
|
allow_insecure_local: bool = False
|
|
enrollment_signer_url: str = ""
|
|
credential_mode: str = "legacy"
|
|
credential_keyring_file: Path | None = None
|
|
credential_permission_profiles: dict[str, list[str]] = {}
|
|
|
|
@model_validator(mode="after")
|
|
def validate_runtime(self):
|
|
if self.credential_mode not in {"legacy", "broker"}:
|
|
raise ValueError("invalid credential mode")
|
|
for profile, scopes in self.credential_permission_profiles.items():
|
|
if (not re.fullmatch(r"[A-Za-z0-9_-]{1,64}", profile) or not scopes or len(scopes) > 128
|
|
or any(not re.fullmatch(r"[A-Za-z0-9_:.-]{1,256}", scope) for scope in scopes)):
|
|
raise ValueError("invalid credential permission profile")
|
|
if self.credential_mode == "broker" and self.role == "connector":
|
|
if self.environment == "production" and not self.database_url:
|
|
raise ValueError("production broker mode requires PostgreSQL")
|
|
if (not self.credential_keyring_file or not self.credential_permission_profiles
|
|
or not self.feishu_enabled or not self.oauth_enabled):
|
|
raise ValueError("broker mode requires keyring, product permissions and enabled platform OAuth")
|
|
authorize = urlsplit(self.feishu_authorize_url)
|
|
if (authorize.scheme != "https" or not authorize.hostname or authorize.username or authorize.password
|
|
or authorize.query or authorize.fragment):
|
|
raise ValueError("broker mode requires a fixed HTTPS authorization endpoint")
|
|
if self.environment not in {"production", "test", "development"}:
|
|
raise ValueError("invalid environment")
|
|
if self.role == "connector" and min(len(self.admin_secret), len(self.internal_secret)) < 32:
|
|
raise ValueError("admin/internal secrets must each be at least 32 characters")
|
|
if self.role == "longconn" and len(self.internal_secret) < 32:
|
|
raise ValueError("internal credential must be at least 32 characters")
|
|
if self.role == "connector" and self.admin_secret == self.internal_secret:
|
|
raise ValueError("admin and internal credentials must be different")
|
|
if self.environment == "production":
|
|
if self.allow_insecure_local or not self.public_url.startswith("https://"):
|
|
raise ValueError("production requires HTTPS")
|
|
if not self.router_url.startswith("wss://"):
|
|
raise ValueError("production requires WSS")
|
|
if not self.feishu_api_base.startswith("https://"):
|
|
raise ValueError("platform API requires HTTPS")
|
|
if self.feishu_event_source not in {"longconn", "webhook"}:
|
|
raise ValueError("invalid platform event source")
|
|
if self.feishu_enabled and not all((self.feishu_app_id, self.feishu_app_secret)):
|
|
raise ValueError("platform app ID and secret are required")
|
|
if self.feishu_enabled and self.feishu_event_source == "webhook" and not all((self.feishu_encrypt_key, self.feishu_verification_token)):
|
|
raise ValueError("webhook requires encryption key and verification token")
|
|
return self
|