diff --git a/README.md b/README.md index 5f08025..34ac5b7 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,8 @@ site-engine/ ├── Makefile Dockerfile # Dockerfile — для M2+ (админка, формы, MCP) ├── docs/ # ТЗ, ревью, журнал решений ├── examples/studio-site/ # сайт-пример из SiteMap.md (услуги, формы, коллекция, редирект) -├── tests/ # 62 теста: значения, разбор, маршруты, сборка, безопасность, запись +├── .env.example # переменные окружения для админки +├── tests/ # 112 тестов: ядро, сборка, безопасность, запись, вход в админку └── src/site_engine/ ├── cli.py # validate · build · preview · fragments ├── errors.py # Issue/Report: код, путь к полю, серьёзность, подсказка @@ -40,26 +41,57 @@ site-engine/ ├── build/pipeline.py # load → validate → render → релиз → атомарный current ├── parsing/ # безопасный YAML, front matter, Markdown (raw HTML выключен) ├── storage/ # safe_join, atomic_write, SiteLock, .engine/history - ├── services/ # ContentService (if_match, история, синтаксис), publish; stubs: changeset, auth, forms + ├── services/ # auth (вход админа), ContentService (if_match, история), publish; stubs: changeset, forms ├── builtin/ # base.css и 15 фрагментов ядра (ADR-006) ├── db/ # SQLAlchemy-модели служебных таблиц (M2) - ├── web/ # FastAPI-фабрика, место для админки htmx (M1–M3) + ├── web/ # FastAPI-фабрика; admin/: handlers (вход, выход, обзор), шаблоны, routes-адаптер └── mcp/ # перечень инструментов MVP (M3) ``` +## Вход в админку + +Самый простой вариант: **один администратор, без ролей**, логин и хеш пароля задаются переменными окружения, БД для входа не нужна. + +```bash +site-engine hash-password # спросит пароль (от 12 символов) и напечатает scrypt-хеш +site-engine gen-secret # ключ подписи сессий +cp .env.example .env # впишите SITE_ADMIN_PASSWORD_HASH и SITE_SECRET_KEY +SITE_COOKIE_SECURE=0 uvicorn site_engine.web.app:create_app --factory --env-file .env # локально по http +``` + +Без `SITE_ADMIN_PASSWORD_HASH` и `SITE_SECRET_KEY` (не короче 32 символов) `/admin/` не включается вообще: нет пароля — нет входа. После входа `/admin/` показывает страницы сайта со статусами, коллекции и результат проверки (только чтение; редактор — следующий шаг). + +| Мера | Как сделано | +|---|---| +| Пароль | scrypt (N=2^15, r=8, p=1), соль на каждый хеш, сравнение за постоянное время | +| Сессия | Подписанная cookie `se_session`: HttpOnly, SameSite=Strict, Secure (выключается только `SITE_COOKIE_SECURE=0`), Path=/admin, срок `SITE_SESSION_HOURS` (по умолчанию 8) | +| Выход | Увеличивает «эпоху» в `.engine/auth_epoch`: все выданные cookie сразу недействительны, в том числе украденные | +| Перебор | 5 неудач за 15 минут блокируют IP (429 + Retry-After), общий порог 30 на все адреса; хеш считается и при неверном логине, поэтому по времени логин не угадать | +| CSRF | POST принимается только с Origin или Referer того же хоста; выход дополнительно требует токен, привязанный к сессии | +| Заголовки | CSP без inline, `frame-ancestors 'none'`, `no-store`, `X-Frame-Options: DENY`, `nosniff` | +| Аудит | `.engine/audit.jsonl`: вход, неудача, блокировка, выход; без паролей и без введённого логина | + +Ограничения этого варианта: + +- Один пользователь, роль всегда `admin`; таблицы `users` и `api_tokens` из `db/models.py` пока не используются. +- Окно попыток хранится в памяти процесса: при нескольких воркерах у каждого свой счётчик, после перезапуска он обнуляется. +- За обратным прокси `request.client.host` — адрес прокси, поэтому ограничение по IP работает как общее. Доверие к `X-Forwarded-For` нужно включать явно (задача M2). +- Выход завершает все сессии администратора сразу, отдельного списка устройств нет. +- Отдельная смена пароля: сгенерировать новый хеш и перезапустить сервис; чтобы разлогинить всех, поменяйте `SITE_SECRET_KEY`. + ## Что реализовано | Этап | Состояние | |---|---| | M0 Контракт и прототип | Готово: формат файлов, модель блоков, load → validate → render, CLI, 15 фрагментов, сайт-пример | | M1 Публикуемый движок | Частично: маршруты, ссылки, редиректы, sitemap, атомарная публикация, откат (`services/publish.py`), превью страницы через CLI. Нет: превью по токену, 404-страница из коробки, тема | -| M2 Коллекции, заявки, доступ | Частично: коллекции, display templates, запросы, формы (разметка, версия формы в релизе). Нет: приём заявок, outbox, вход и роли, аудит | -| M3 MCP и редактор | `ContentService` с `if_match`, блокировкой и историей готов; нет `patch_page`, changeset, MCP-сервера, админки | +| M2 Коллекции, заявки, доступ | Частично: коллекции, display templates, запросы, формы (разметка, версия формы в релизе), **вход одного администратора с аудитом входов и обзорная страница админки**. Нет: роли, приём заявок, outbox, аудит правок | +| M3 MCP и редактор | `ContentService` с `if_match`, блокировкой и историей готов; нет редактора страниц, `patch_page`, changeset, MCP-сервера | | M4 | Не начат | ## Что проверено, а что нет -Тесты и сборка примера выполнялись в окружении без сети: ядро (всё, что в `core/`, `build/`, `parsing/`, `storage/`, `services/content.py`) запущено и покрыто 62 тестами. Модули `db/`, `web/`, `mcp/` и `Dockerfile` проверены только компиляцией и чтением: SQLAlchemy, FastAPI и MCP SDK в окружении не было. Ядро намеренно не зависит от pydantic: ошибки должны нести путь к полю (`pages/index.md:regions.main[b_hero].props.title`), а валидация задаётся манифестами фрагментов. Pydantic нужен на границах API (web, mcp). +Тесты и сборка примера выполнялись в окружении без сети: ядро (`core/`, `build/`, `parsing/`, `storage/`, `services/`) и вся логика админки (`web/admin/handlers.py`, шаблоны, вход, CSRF, заголовки) запущены и покрыты 112 тестами. Тонкий FastAPI-адаптер `web/admin/routes.py` проверен на подставном модуле `fastapi`, а `web/app.py`, `db/`, `mcp/` и `Dockerfile` только компиляцией и чтением: FastAPI, SQLAlchemy и MCP SDK в окружении не было. Ядро намеренно не зависит от pydantic: ошибки должны нести путь к полю (`pages/index.md:regions.main[b_hero].props.title`), а валидация задаётся манифестами фрагментов. Pydantic нужен на границах API (web, mcp). ## Соответствие журналу решений @@ -83,4 +115,4 @@ site-engine/ - Поле `props` в шаблоне — объект `Props`: `props.items` читает поле «items», а не метод словаря. - `layout.extends` проверяется на существование, наследование шаблонов делается обычным `{% extends 'layout/' %}`. - CSS и JS собираются в один бандл с хешем в имени; минификации и изоляции по страницам пока нет. -- Нет приёма заявок, входа, MCP и админки: сетевая поверхность записи включается только вместе с контуром «вход, роли, аудит, лимиты» (ADR-006). +- Нет приёма заявок, редактора и MCP: сетевая поверхность записи включается только вместе с контуром «вход, роли, аудит, лимиты» (ADR-006). Вход уже есть, роли и аудит правок будут вместе с редактором. diff --git a/src/.env.example b/src/.env.example new file mode 100644 index 0000000..8e4d219 --- /dev/null +++ b/src/.env.example @@ -0,0 +1,11 @@ +# Каталоги +SITE_ROOT=examples/studio-site +SITE_DIST=dist + +# Вход в админку (без этих переменных /admin/ отключена) +SITE_ADMIN_LOGIN=admin +SITE_ADMIN_PASSWORD_HASH= # site-engine hash-password +SITE_SECRET_KEY= # site-engine gen-secret (не короче 32 символов) +SITE_COOKIE_SECURE=1 # 0 только для локальной разработки по http +SITE_SESSION_HOURS=8 +# SITE_PUBLIC_HOST=admin.example.com # если Host подменяется прокси diff --git a/src/site_engine/cli.py b/src/site_engine/cli.py index ca837a3..9490d67 100644 --- a/src/site_engine/cli.py +++ b/src/site_engine/cli.py @@ -73,6 +73,26 @@ def preview(site: Path, page_id: str) -> None: click.echo(html) +@main.command("hash-password") +def hash_password_cmd() -> None: + """Хеш пароля администратора для SITE_ADMIN_PASSWORD_HASH (пароль вводится скрыто).""" + from .services.auth import MIN_PASSWORD_LENGTH, hash_password + + password = click.prompt("Пароль", hide_input=True, confirmation_prompt=True) + try: + click.echo(hash_password(password)) + except ValueError as exc: + raise click.ClickException(f"{exc} (минимум {MIN_PASSWORD_LENGTH})") from exc + + +@main.command("gen-secret") +def gen_secret_cmd() -> None: + """Случайный ключ подписи сессий для SITE_SECRET_KEY.""" + import secrets + + click.echo(secrets.token_urlsafe(48)) + + @main.command() @click.option("--site", type=click.Path(exists=True, file_okay=False, path_type=Path), default=None) def fragments(site: Path | None) -> None: diff --git a/src/site_engine/services/auth.py b/src/site_engine/services/auth.py index f7463ac..b1e45a1 100644 --- a/src/site_engine/services/auth.py +++ b/src/site_engine/services/auth.py @@ -1,4 +1,264 @@ -"""Вход, роли owner/developer/editor, токены агентов со scope — M2 (ADR-005, ADR-006). +"""Аутентификация админки: один администратор, без ролей, без БД (ADR-005, упрощённый MVP). -Правило порядка: сетевая поверхность записи включается только вместе с этим модулем. +Логин и хеш пароля берутся из конфигурации (переменные окружения). Сессия — подписанная +cookie без серверного хранилища; выход увеличивает «эпоху» в `.engine/auth_epoch`, после чего +все выданные cookie перестают действовать. Перебор пароля ограничивается окном попыток. +События входа пишутся в `.engine/audit.jsonl` (без паролей и без введённого логина). + +Путь расширения: `Principal.role` уже есть; пользователи и роли (таблицы `users`, +`api_tokens`) подключаются позже без смены интерфейса `AuthService`. """ + +from __future__ import annotations + +import base64 +import datetime as dt +import hashlib +import hmac +import json +import os +import secrets +import time +from collections import defaultdict, deque +from collections.abc import Callable, Mapping +from dataclasses import dataclass +from pathlib import Path +from urllib.parse import urlsplit + +from ..errors import EngineError +from ..storage.fs import atomic_write + +COOKIE_NAME = "se_session" +MIN_PASSWORD_LENGTH = 12 +MIN_SECRET_LENGTH = 32 +SCRYPT_N, SCRYPT_R, SCRYPT_P = 2**15, 8, 1 +_SCRYPT_MAXMEM = 128 * 1024 * 1024 + + +class ConfigError(EngineError): + """Неполная или небезопасная конфигурация входа.""" + + +class AuthError(Exception): + """code: invalid | throttled.""" + + def __init__(self, code: str, retry_after: int | None = None): + super().__init__(code) + self.code = code + self.retry_after = retry_after + + +def _b64(data: bytes) -> str: + return base64.urlsafe_b64encode(data).rstrip(b"=").decode("ascii") + + +def _unb64(text: str) -> bytes: + return base64.urlsafe_b64decode(text + "=" * (-len(text) % 4)) + + +# ── пароли ──────────────────────────────────────────────────────────────────── + +def hash_password(password: str, *, n: int = SCRYPT_N, r: int = SCRYPT_R, p: int = SCRYPT_P) -> str: + """`scrypt$N$r$p$соль$хеш`; параметры хранятся в строке, их можно усиливать позже.""" + if len(password) < MIN_PASSWORD_LENGTH: + raise ValueError(f"пароль короче {MIN_PASSWORD_LENGTH} символов") + salt = secrets.token_bytes(16) + digest = hashlib.scrypt(password.encode("utf-8"), salt=salt, n=n, r=r, p=p, maxmem=_SCRYPT_MAXMEM, dklen=32) + return f"scrypt${n}${r}${p}${_b64(salt)}${_b64(digest)}" + + +def verify_password(password: str, stored: str) -> bool: + """Сравнение за постоянное время; любой дефект строки хеша — просто False.""" + try: + scheme, n, r, p, salt, digest = stored.split("$") + n, r, p = int(n), int(r), int(p) + if scheme != "scrypt" or not (2 <= n <= 2**20 and 1 <= r <= 32 and 1 <= p <= 16): + return False + expected = _unb64(digest) + actual = hashlib.scrypt(password.encode("utf-8"), salt=_unb64(salt), n=n, r=r, p=p, + maxmem=_SCRYPT_MAXMEM, dklen=len(expected)) + return hmac.compare_digest(actual, expected) + except (ValueError, TypeError, MemoryError): + return False + + +# ── конфигурация ────────────────────────────────────────────────────────────── + +@dataclass(frozen=True) +class AuthConfig: + login: str + password_hash: str + secret: bytes + session_hours: float = 8.0 + cookie_secure: bool = True + public_host: str | None = None # Host админки, если стоит прокси и Host подменяется + max_failures: int = 5 + window_seconds: int = 900 + global_max_failures: int = 30 + + @classmethod + def from_env(cls, env: Mapping[str, str] | None = None) -> "AuthConfig": + env = os.environ if env is None else env + login = env.get("SITE_ADMIN_LOGIN", "admin").strip() + password_hash = env.get("SITE_ADMIN_PASSWORD_HASH", "").strip() + secret = env.get("SITE_SECRET_KEY", "") + if not login: + raise ConfigError("SITE_ADMIN_LOGIN пуст") + if not password_hash.startswith("scrypt$"): + raise ConfigError("SITE_ADMIN_PASSWORD_HASH не задан или не в формате scrypt (site-engine hash-password)") + if len(secret) < MIN_SECRET_LENGTH: + raise ConfigError(f"SITE_SECRET_KEY короче {MIN_SECRET_LENGTH} символов (site-engine gen-secret)") + try: + hours = float(env.get("SITE_SESSION_HOURS", "8")) + except ValueError as exc: + raise ConfigError("SITE_SESSION_HOURS: ожидается число") from exc + if not 0 < hours <= 24 * 30: + raise ConfigError("SITE_SESSION_HOURS: от 0 до 720") + secure = env.get("SITE_COOKIE_SECURE", "1").strip().lower() not in ("0", "false", "no", "off") + return cls(login, password_hash, secret.encode("utf-8"), hours, secure, + env.get("SITE_PUBLIC_HOST") or None) + + +# ── ограничение попыток и аудит ─────────────────────────────────────────────── + +class LoginThrottle: + """Скользящее окно неудач: по IP и общий порог на все адреса.""" + + def __init__(self, max_failures: int, window_seconds: int, global_max: int, + clock: Callable[[], float] = time.time): + self.max_failures, self.window, self.global_max = max_failures, window_seconds, global_max + self.clock = clock + self._by_key: dict[str, deque[float]] = defaultdict(deque) + self._all: deque[float] = deque() + + def _trim(self, q: deque[float]) -> None: + cutoff = self.clock() - self.window + while q and q[0] <= cutoff: + q.popleft() + + def blocked(self, key: str) -> int | None: + """Секунд до следующей попытки или None, если можно пробовать.""" + for q, limit in ((self._by_key[key], self.max_failures), (self._all, self.global_max)): + self._trim(q) + if len(q) >= limit: + return max(1, int(q[0] + self.window - self.clock()) + 1) + return None + + def fail(self, key: str) -> None: + now = self.clock() + self._by_key[key].append(now) + self._all.append(now) + + def success(self, key: str) -> None: + self._by_key.pop(key, None) + + +class AuditLog: + """JSON Lines: одно событие на строку. В записях нет паролей и введённых логинов.""" + + def __init__(self, path: Path, clock: Callable[[], float] = time.time): + self.path, self.clock = path, clock + + def write(self, event: str, **fields) -> None: + self.path.parent.mkdir(parents=True, exist_ok=True) + entry = {"ts": dt.datetime.fromtimestamp(self.clock(), dt.timezone.utc).isoformat(), "event": event, **fields} + line = json.dumps(entry, ensure_ascii=False) + "\n" + fd = os.open(self.path, os.O_WRONLY | os.O_APPEND | os.O_CREAT, 0o600) + try: + os.write(fd, line.encode("utf-8")) + finally: + os.close(fd) + + +# ── сервис ──────────────────────────────────────────────────────────────────── + +@dataclass(frozen=True) +class Principal: + login: str + sid: str + role: str = "admin" + + +class AuthService: + def __init__(self, cfg: AuthConfig, state_dir: Path, *, clock: Callable[[], float] = time.time, + throttle: LoginThrottle | None = None): + self.cfg, self.state_dir, self.clock = cfg, Path(state_dir), clock + self.throttle = throttle or LoginThrottle(cfg.max_failures, cfg.window_seconds, cfg.global_max_failures, clock) + self.audit = AuditLog(self.state_dir / "audit.jsonl", clock) + self._session_key = hmac.new(cfg.secret, b"site-engine/session/v1", hashlib.sha256).digest() + self._csrf_key = hmac.new(cfg.secret, b"site-engine/csrf/v1", hashlib.sha256).digest() + + @property + def cookie_max_age(self) -> int: + return int(self.cfg.session_hours * 3600) + + # эпоха: выход увеличивает её, и все ранее выданные cookie недействительны + def _epoch(self) -> int: + try: + return int((self.state_dir / "auth_epoch").read_text().strip() or 0) + except (FileNotFoundError, ValueError): + return 0 + + def _bump_epoch(self) -> None: + atomic_write(self.state_dir / "auth_epoch", str(self._epoch() + 1)) + + def _sign(self, payload: str) -> str: + return _b64(hmac.new(self._session_key, payload.encode("ascii"), hashlib.sha256).digest()) + + def login(self, login: str, password: str, ip: str) -> str: + """Значение cookie. AuthError('invalid') при неверной паре, AuthError('throttled') при блокировке.""" + retry = self.throttle.blocked(ip) + if retry is not None: + self.audit.write("login_blocked", ip=ip, retry_after=retry) + raise AuthError("throttled", retry) + login_ok = hmac.compare_digest(login.encode("utf-8"), self.cfg.login.encode("utf-8")) + password_ok = verify_password(password, self.cfg.password_hash) # хеш считаем всегда: время не выдаёт логин + if not (login_ok and password_ok): + self.throttle.fail(ip) + self.audit.write("login_fail", ip=ip, login_matched=login_ok) + raise AuthError("invalid") + self.throttle.success(ip) + now = int(self.clock()) + payload = _b64(json.dumps( + {"l": self.cfg.login, "sid": secrets.token_hex(16), "iat": now, + "exp": now + self.cookie_max_age, "ep": self._epoch()}, separators=(",", ":")).encode("utf-8")) + self.audit.write("login_ok", ip=ip) + return f"v1.{payload}.{self._sign(payload)}" + + def authenticate(self, cookie: str | None) -> Principal | None: + if not cookie: + return None + try: + version, payload, signature = cookie.split(".") + if version != "v1" or not hmac.compare_digest(signature, self._sign(payload)): + return None + data = json.loads(_unb64(payload)) + if data["exp"] <= self.clock() or data["ep"] != self._epoch() or data["l"] != self.cfg.login: + return None + return Principal(login=data["l"], sid=str(data["sid"])) + except (ValueError, KeyError, TypeError, UnicodeError): + return None + + def logout(self, principal: Principal, ip: str = "") -> None: + """Выход отзывает все сессии администратора (эпоха +1).""" + self._bump_epoch() + self.audit.write("logout", ip=ip) + + def csrf_token(self, principal: Principal) -> str: + return _b64(hmac.new(self._csrf_key, principal.sid.encode("ascii"), hashlib.sha256).digest()) + + def verify_csrf(self, principal: Principal, token: str | None) -> bool: + return bool(token) and hmac.compare_digest(token, self.csrf_token(principal)) + + +def is_same_origin(headers: Mapping[str, str], public_host: str | None = None) -> bool: + """POST принимается только с Origin (или Referer) того же хоста, что и админка.""" + h = {k.lower(): v for k, v in headers.items()} + host = (public_host or h.get("host", "")).lower() + if not host: + return False + for name in ("origin", "referer"): + value = h.get(name) + if value: + return urlsplit(value).netloc.lower() == host + return False diff --git a/src/site_engine/web/admin/handlers.py b/src/site_engine/web/admin/handlers.py new file mode 100644 index 0000000..b0d90bc --- /dev/null +++ b/src/site_engine/web/admin/handlers.py @@ -0,0 +1,125 @@ +"""Обработчики админки без привязки к веб-фреймворку: запрос → `HttpResult`. + +Так вся логика входа, выхода, CSRF и защитных заголовков проверяется обычными тестами; +FastAPI-слой (`routes.py`) только переводит запрос в аргументы и результат в Response. +""" + +from __future__ import annotations + +from dataclasses import dataclass, field +from pathlib import Path + +from ...core.registry import load_site +from ...core.routes import build_route_table +from ...core.validate import validate_release, validate_workspace +from ...errors import EngineError, Report +from ...services.auth import COOKIE_NAME, AuthError, AuthService, is_same_origin +from .render import read_static, render + +ADMIN_HEADERS = { + "Cache-Control": "no-store", + "X-Frame-Options": "DENY", + "X-Content-Type-Options": "nosniff", + "Referrer-Policy": "same-origin", + "Content-Security-Policy": ( + "default-src 'none'; style-src 'self'; script-src 'self'; img-src 'self'; " + "connect-src 'self'; form-action 'self'; frame-ancestors 'none'; base-uri 'none'" + ), +} + + +@dataclass +class HttpResult: + status: int = 200 + body: str = "" + content_type: str = "text/html; charset=utf-8" + headers: dict[str, str] = field(default_factory=dict) + cookies: list[str] = field(default_factory=list) # готовые значения Set-Cookie + + +def build_set_cookie(value: str, *, max_age: int, secure: bool) -> str: + parts = [f"{COOKIE_NAME}={value}", "Path=/admin", "HttpOnly", "SameSite=Strict", f"Max-Age={max_age}"] + if secure: + parts.append("Secure") + return "; ".join(parts) + + +def _page(body: str, status: int = 200, headers: dict[str, str] | None = None) -> HttpResult: + return HttpResult(status, body, headers={**ADMIN_HEADERS, **(headers or {})}) + + +def _redirect(location: str, cookies: list[str] | None = None) -> HttpResult: + return HttpResult(303, "", headers={**ADMIN_HEADERS, "Location": location}, cookies=cookies or []) + + +class AdminHandlers: + def __init__(self, auth: AuthService, site_root: Path): + self.auth = auth + self.site_root = Path(site_root) + + def _clear_cookie(self) -> str: + return build_set_cookie("", max_age=0, secure=self.auth.cfg.cookie_secure) + + def _same_origin(self, headers: dict[str, str]) -> bool: + return is_same_origin(headers, self.auth.cfg.public_host) + + # ── вход ────────────────────────────────────────────────────────────── + def login_page(self, cookie: str | None, *, error: str = "", login: str = "", status: int = 200, + headers: dict[str, str] | None = None) -> HttpResult: + if self.auth.authenticate(cookie): + return _redirect("/admin/") + return _page(render("login.html.j2", error=error, login=login), status, headers) + + def login_submit(self, login: str, password: str, request_headers: dict[str, str], ip: str) -> HttpResult: + if not self._same_origin(request_headers): + return _page("Недопустимый источник запроса", 403) + try: + cookie = self.auth.login(login, password, ip) + except AuthError as exc: + if exc.code == "throttled": + minutes = max(1, (exc.retry_after or 60) // 60 + 1) + return self.login_page(None, error=f"Слишком много попыток. Повторите через {minutes} мин.", + login=login, status=429, headers={"Retry-After": str(exc.retry_after or 60)}) + return self.login_page(None, error="Неверный логин или пароль", login=login, status=401) + value = build_set_cookie(cookie, max_age=self.auth.cookie_max_age, secure=self.auth.cfg.cookie_secure) + return _redirect("/admin/", [value]) + + def logout(self, cookie: str | None, csrf: str, request_headers: dict[str, str], ip: str) -> HttpResult: + principal = self.auth.authenticate(cookie) + if principal is None: + return _redirect("/admin/login", [self._clear_cookie()]) + if not self._same_origin(request_headers) or not self.auth.verify_csrf(principal, csrf): + return _page("Недопустимый запрос", 403) + self.auth.logout(principal, ip) + return _redirect("/admin/login", [self._clear_cookie()]) + + # ── обзор ───────────────────────────────────────────────────────────── + def dashboard(self, cookie: str | None) -> HttpResult: + principal = self.auth.authenticate(cookie) + if principal is None: + return _redirect("/admin/login") + ctx: dict = {"login": principal.login, "csrf": self.auth.csrf_token(principal), + "site_error": "", "site_name": "", "pages": [], "collections": [], + "errors": 0, "warnings": 0} + try: + reg = load_site(self.site_root) + report = Report() + table = build_route_table(reg, report) + report.extend(validate_workspace(reg, table)) + report.extend(validate_release(reg, table)) + routes = {r.page.id: r.route for r in table.values() if r.page} + ctx.update( + site_name=reg.site.name, errors=len(report.errors), warnings=len(report.warnings), + pages=[{"title": p.title, "status": p.status, "route": routes.get(p.id, "—")} + for p in sorted(reg.pages.values(), key=lambda x: routes.get(x.id, ""))], + collections=[{"name": c.name, "total": len(reg.entries.get(c.id, [])), + "published": sum(e.status == "published" for e in reg.entries.get(c.id, []))} + for c in reg.collections.values()], + ) + except EngineError as exc: + ctx["site_error"] = str(exc) + return _page(render("dashboard.html.j2", **ctx)) + + def static_css(self) -> HttpResult: + return HttpResult(200, read_static("admin.css"), "text/css; charset=utf-8", + headers={"Cache-Control": "public, max-age=3600", "X-Content-Type-Options": "nosniff"}) diff --git a/src/site_engine/web/admin/render.py b/src/site_engine/web/admin/render.py new file mode 100644 index 0000000..1785613 --- /dev/null +++ b/src/site_engine/web/admin/render.py @@ -0,0 +1,21 @@ +"""Рендер шаблонов админки: обычный Jinja с автоэкранированием (не окружение сайта).""" + +from __future__ import annotations + +from pathlib import Path + +from jinja2 import Environment, FileSystemLoader, StrictUndefined + +ADMIN_DIR = Path(__file__).resolve().parent +_env = Environment( + loader=FileSystemLoader(ADMIN_DIR / "templates"), autoescape=True, + undefined=StrictUndefined, trim_blocks=True, lstrip_blocks=True, +) + + +def render(name: str, **ctx) -> str: + return _env.get_template(name).render(**ctx) + + +def read_static(name: str) -> str: + return (ADMIN_DIR / "static" / name).read_text(encoding="utf-8") diff --git a/src/site_engine/web/admin/routes.py b/src/site_engine/web/admin/routes.py new file mode 100644 index 0000000..e649c37 --- /dev/null +++ b/src/site_engine/web/admin/routes.py @@ -0,0 +1,50 @@ +"""FastAPI-адаптер для `AdminHandlers`. Не запускался в песочнице без сети: только компиляция. + +Обработчики синхронные (`def`): хеш scrypt считается около 100 мс, и FastAPI вынесет их в пул потоков. +За обратным прокси `request.client.host` — адрес прокси, тогда ограничение попыток по IP +работает как общее; доверие к X-Forwarded-For нужно включать явно (задача M2). +""" + +from __future__ import annotations + +from ...services.auth import COOKIE_NAME +from .handlers import AdminHandlers, HttpResult + + +def create_admin_router(handlers: AdminHandlers): + from fastapi import APIRouter, Form, Request, Response + + router = APIRouter(prefix="/admin") + + def adapt(result: HttpResult) -> Response: + response = Response(content=result.body, status_code=result.status, media_type=result.content_type) + for key, value in result.headers.items(): + response.headers[key] = value + for cookie in result.cookies: + response.headers.append("set-cookie", cookie) + return response + + def client_ip(request: Request) -> str: + return request.client.host if request.client else "unknown" + + @router.get("/login") + def login_page(request: Request): + return adapt(handlers.login_page(request.cookies.get(COOKIE_NAME))) + + @router.post("/login") + def login_submit(request: Request, login: str = Form(""), password: str = Form("")): + return adapt(handlers.login_submit(login, password, dict(request.headers), client_ip(request))) + + @router.post("/logout") + def logout(request: Request, csrf: str = Form("")): + return adapt(handlers.logout(request.cookies.get(COOKIE_NAME), csrf, dict(request.headers), client_ip(request))) + + @router.get("/") + def dashboard(request: Request): + return adapt(handlers.dashboard(request.cookies.get(COOKIE_NAME))) + + @router.get("/static/admin.css") + def admin_css(): + return adapt(handlers.static_css()) + + return router diff --git a/src/site_engine/web/admin/static/admin.css b/src/site_engine/web/admin/static/admin.css new file mode 100644 index 0000000..28d2c2b --- /dev/null +++ b/src/site_engine/web/admin/static/admin.css @@ -0,0 +1,19 @@ +:root { --c-primary: #0b5fff; --c-border: #dcdfe6; --c-muted: #667085; } +* { box-sizing: border-box; } +body { margin: 0; font: 15px/1.5 system-ui, sans-serif; color: #1b1f24; background: #f7f8fa; } +.login { max-width: 22rem; margin: 12vh auto; padding: 1.5rem; background: #fff; border: 1px solid var(--c-border); border-radius: .6rem; } +.login h1 { font-size: 1.2rem; margin: 0 0 1rem; } +label { display: grid; gap: .25rem; margin-bottom: .8rem; font-size: .9rem; color: var(--c-muted); } +input[type=text], input[type=password] { padding: .55rem .6rem; font: inherit; border: 1px solid var(--c-border); border-radius: .4rem; } +button { padding: .55rem 1rem; font: inherit; color: #fff; background: var(--c-primary); border: 0; border-radius: .4rem; cursor: pointer; } +.error { padding: .6rem .8rem; color: #8a1c1c; background: #fdecec; border-radius: .4rem; } +.bar { display: flex; align-items: center; gap: .8rem; padding: .6rem 1rem; background: #fff; border-bottom: 1px solid var(--c-border); } +.bar form { margin: 0; } +.spacer { flex: 1; } +.content { max-width: 60rem; margin: 1.5rem auto; padding: 0 1rem; } +table { width: 100%; border-collapse: collapse; background: #fff; } +th, td { padding: .5rem .7rem; text-align: left; border-bottom: 1px solid var(--c-border); } +.status { padding: .1rem .5rem; border-radius: 1rem; font-size: .8rem; background: #eef0f4; } +.status-published { background: #e3f6e8; } +.status-draft { background: #fff4d6; } +.summary { color: var(--c-muted); } diff --git a/src/site_engine/web/admin/templates/base.html.j2 b/src/site_engine/web/admin/templates/base.html.j2 new file mode 100644 index 0000000..a785c19 --- /dev/null +++ b/src/site_engine/web/admin/templates/base.html.j2 @@ -0,0 +1,13 @@ + + + + + + +{% block title %}Админка{% endblock %} + + + +{% block body %}{% endblock %} + + diff --git a/src/site_engine/web/admin/templates/dashboard.html.j2 b/src/site_engine/web/admin/templates/dashboard.html.j2 new file mode 100644 index 0000000..f8b95d8 --- /dev/null +++ b/src/site_engine/web/admin/templates/dashboard.html.j2 @@ -0,0 +1,44 @@ +{% extends 'base.html.j2' %} +{% block title %}Обзор — админка{% endblock %} +{% block body %} +
+ Админка + + {{ login }} +
+ + +
+
+
+ {% if site_error %} + + {% else %} +

{{ site_name }}

+

+ Страниц: {{ pages|length }} · ошибок проверки: {{ errors }} · предупреждений: {{ warnings }} +

+

Страницы

+ + + + {% for p in pages %} + + + + + + {% endfor %} + +
СтраницаАдресСтатус
{{ p.title }}{{ p.route }}{{ p.status }}
+

Коллекции

+ + {% endif %} +
+{% endblock %} diff --git a/src/site_engine/web/admin/templates/login.html.j2 b/src/site_engine/web/admin/templates/login.html.j2 new file mode 100644 index 0000000..e22a55b --- /dev/null +++ b/src/site_engine/web/admin/templates/login.html.j2 @@ -0,0 +1,17 @@ +{% extends 'base.html.j2' %} +{% block title %}Вход — админка{% endblock %} +{% block body %} +
+

Вход в админку

+ {% if error %}{% endif %} +
+ + + +
+
+{% endblock %} diff --git a/src/site_engine/web/app.py b/src/site_engine/web/app.py index f831ff2..4c9bddb 100644 --- a/src/site_engine/web/app.py +++ b/src/site_engine/web/app.py @@ -1,20 +1,30 @@ -"""Фабрика приложения. M0–M1: health и раздача `dist/current` для разработки. +"""Фабрика приложения. Админка подключается, только если задана конфигурация входа. -Дальше: `POST /forms/{id}` и outbox (M2), админка `web/admin/` (M2–M3), превью по токену -`/_preview//` (M1), MCP на `/mcp/` (M3). В production статику отдаёт nginx. +Переменные окружения: SITE_ROOT, SITE_DIST, SITE_STATE_DIR (по умолчанию SITE_ROOT/.engine), +SITE_ADMIN_LOGIN, SITE_ADMIN_PASSWORD_HASH, SITE_SECRET_KEY, SITE_COOKIE_SECURE, SITE_SESSION_HOURS, +SITE_PUBLIC_HOST. Без них `/admin/` отдаёт 404, и это сознательно: нет пароля — нет входа. +Не запускалось в песочнице без сети (нужен `pip install site-engine[server]`). """ from __future__ import annotations +import logging import os from pathlib import Path +log = logging.getLogger("site_engine") + def create_app(): from fastapi import FastAPI, HTTPException from fastapi.staticfiles import StaticFiles - app = FastAPI(title="Site Engine") + from ..services.auth import AuthConfig, AuthService, ConfigError + from .admin.handlers import AdminHandlers + from .admin.routes import create_admin_router + + app = FastAPI(title="Site Engine", docs_url=None, redoc_url=None, openapi_url=None) + root = Path(os.environ.get("SITE_ROOT", "site")) dist = Path(os.environ.get("SITE_DIST", "dist")) @app.get("/healthz") @@ -25,6 +35,14 @@ def create_app(): def submit_form(form_id: str) -> None: raise HTTPException(status_code=501, detail="приём заявок появится в M2 (ADR-003)") - if (dist / "current").exists(): + try: + cfg = AuthConfig.from_env() + except ConfigError as exc: + log.warning("админка отключена: %s", exc) + else: + state_dir = Path(os.environ.get("SITE_STATE_DIR", root / ".engine")) + app.include_router(create_admin_router(AdminHandlers(AuthService(cfg, state_dir), root))) + + if (dist / "current").exists(): # маршруты выше имеют приоритет над раздачей статики app.mount("/", StaticFiles(directory=dist / "current", html=True), name="site") return app diff --git a/tests/test_admin_handlers.py b/tests/test_admin_handlers.py new file mode 100644 index 0000000..6b256f3 --- /dev/null +++ b/tests/test_admin_handlers.py @@ -0,0 +1,140 @@ +import unittest +from pathlib import Path +from tempfile import TemporaryDirectory + +from helpers import SiteTestCase +from test_auth import PASSWORD, Clock, make_cfg + +from site_engine.services.auth import COOKIE_NAME, AuthService +from site_engine.web.admin.handlers import ADMIN_HEADERS, AdminHandlers + +ORIGIN = {"Host": "admin.example", "Origin": "https://admin.example"} + + +class AdminHandlersTest(SiteTestCase): + def setUp(self): + super().setUp() + self.clock = Clock() + self.auth = AuthService(make_cfg(), self.tmp / "state", clock=self.clock) + self.h = AdminHandlers(self.auth, self.site) + + def cookie_value(self, result): + header = result.cookies[0] + return header.split(";")[0].split("=", 1)[1] + + def login(self, ip="1.1.1.1"): + result = self.h.login_submit("admin", PASSWORD, ORIGIN, ip) + self.assertEqual(result.status, 303, result.body) + return self.cookie_value(result) + + def csrf_for(self, cookie): + return self.auth.csrf_token(self.auth.authenticate(cookie)) + + def test_dashboard_requires_login(self): + result = self.h.dashboard(None) + self.assertEqual((result.status, result.headers["Location"]), (303, "/admin/login")) + self.assertEqual(self.h.dashboard("v1.fake.fake").status, 303) + + def test_login_page_and_security_headers(self): + result = self.h.login_page(None) + self.assertEqual(result.status, 200) + self.assertIn("name='password'", result.body) + for name, value in ADMIN_HEADERS.items(): + self.assertEqual(result.headers[name], value) + self.assertIn("frame-ancestors 'none'", result.headers["Content-Security-Policy"]) + self.assertEqual(result.headers["Cache-Control"], "no-store") + + def test_successful_login_sets_hardened_cookie(self): + result = self.h.login_submit("admin", PASSWORD, ORIGIN, "1.1.1.1") + self.assertEqual((result.status, result.headers["Location"]), (303, "/admin/")) + cookie = result.cookies[0] + self.assertTrue(cookie.startswith(f"{COOKIE_NAME}=")) + for flag in ("HttpOnly", "SameSite=Strict", "Path=/admin", "Secure", "Max-Age=28800"): + self.assertIn(flag, cookie) + + def test_wrong_password_gives_401_without_cookie_and_generic_message(self): + result = self.h.login_submit("admin", "wrong password!!", ORIGIN, "1.1.1.1") + self.assertEqual((result.status, result.cookies), (401, [])) + self.assertIn("Неверный логин или пароль", result.body) + other = self.h.login_submit("nobody", PASSWORD, ORIGIN, "1.1.1.2") + self.assertIn("Неверный логин или пароль", other.body) + + def test_login_rejects_cross_origin_even_with_correct_password(self): + for headers in ({"Host": "admin.example", "Origin": "https://evil.example"}, {"Host": "admin.example"}): + result = self.h.login_submit("admin", PASSWORD, headers, "1.1.1.1") + self.assertEqual((result.status, result.cookies), (403, [])) + + def test_throttled_login_returns_429_with_retry_after(self): + for _ in range(5): + self.h.login_submit("admin", "wrong password!!", ORIGIN, "6.6.6.6") + result = self.h.login_submit("admin", PASSWORD, ORIGIN, "6.6.6.6") + self.assertEqual(result.status, 429) + self.assertGreater(int(result.headers["Retry-After"]), 0) + self.assertEqual(result.cookies, []) + + def test_login_value_is_escaped_in_error_page(self): + evil = "\">" + result = self.h.login_submit(evil, "wrong password!!", ORIGIN, "1.1.1.1") + self.assertNotIn("", result.body) + self.assertIn("<script>", result.body) + + def test_password_is_never_echoed(self): + result = self.h.login_submit("admin", "super-secret-guess!!", ORIGIN, "1.1.1.1") + self.assertNotIn("super-secret-guess", result.body) + + def test_dashboard_lists_pages_collections_and_validation(self): + result = self.h.dashboard(self.login()) + self.assertEqual(result.status, 200) + for text in ("Acme Studio", "Главная", "Контакты", "Черновик новой страницы", "status-draft", + "опубликовано 3 из 3", "ошибок проверки: 0"): + self.assertIn(text, result.body) + self.assertIn("name='csrf'", result.body) + self.assertIn("no-store", result.headers["Cache-Control"]) + + def test_dashboard_shows_broken_site_instead_of_crashing(self): + (self.site / "site.yaml").unlink() + result = self.h.dashboard(self.login()) + self.assertEqual(result.status, 200) + self.assertIn("Сайт не загружен", result.body) + + def test_logout_needs_csrf_and_same_origin(self): + cookie = self.login() + token = self.csrf_for(cookie) + self.assertEqual(self.h.logout(cookie, "", ORIGIN, "1.1.1.1").status, 403) + self.assertEqual(self.h.logout(cookie, "wrong", ORIGIN, "1.1.1.1").status, 403) + evil = {"Host": "admin.example", "Origin": "https://evil.example"} + self.assertEqual(self.h.logout(cookie, token, evil, "1.1.1.1").status, 403) + self.assertEqual(self.h.dashboard(cookie).status, 200) # сессия цела + + def test_logout_clears_cookie_and_revokes_session(self): + cookie = self.login() + result = self.h.logout(cookie, self.csrf_for(cookie), ORIGIN, "1.1.1.1") + self.assertEqual((result.status, result.headers["Location"]), (303, "/admin/login")) + self.assertIn("Max-Age=0", result.cookies[0]) + self.assertEqual(self.h.dashboard(cookie).status, 303) + + def test_logged_in_user_is_redirected_from_login_page(self): + result = self.h.login_page(self.login()) + self.assertEqual((result.status, result.headers["Location"]), (303, "/admin/")) + + def test_static_css_is_served(self): + result = self.h.static_css() + self.assertEqual(result.status, 200) + self.assertTrue(result.content_type.startswith("text/css")) + self.assertIn(".login", result.body) + + def test_no_inline_scripts_or_styles_in_templates(self): + # CSP не разрешает inline: проверяем, что шаблоны её не нарушают + for body in (self.h.login_page(None).body, self.h.dashboard(self.login()).body): + self.assertNotIn("