Integrate Antirion admin with FastAPI and htmx
Add the shared document API, constructor and expert editors, isolated preview, and fragment catalog metadata with typed block IDs. Include design references, specification 001, QA scripts, project guidance, and cached Docker dependency installation. Leave example sites for a separate commit.
This commit is contained in:
@@ -0,0 +1,189 @@
|
||||
"""Preview tokens, origins, protected assets and public-build separation."""
|
||||
|
||||
import os
|
||||
from unittest.mock import patch
|
||||
from urllib.parse import urlsplit
|
||||
|
||||
from fastapi.testclient import TestClient
|
||||
from helpers import SiteTestCase
|
||||
|
||||
from site_engine.build.pipeline import build_site
|
||||
from site_engine.errors import UnsafePathError
|
||||
from site_engine.services.auth import Principal
|
||||
from site_engine.services.pages import PageService
|
||||
from site_engine.services.preview import PreviewConfig, PreviewStore, asset_path
|
||||
from site_engine.web.preview_app import create_preview_app
|
||||
|
||||
|
||||
class PreviewTests(SiteTestCase):
|
||||
def setUp(self):
|
||||
super().setUp()
|
||||
self.state = self.tmp / "state"
|
||||
self.config = PreviewConfig("http://127.0.0.1:9100", "http://127.0.0.1:9101")
|
||||
self.time = [1000.0]
|
||||
self.store = PreviewStore(
|
||||
self.state, b"secret-" * 8, self.config, clock=lambda: self.time[0]
|
||||
)
|
||||
self.svc = PageService(self.site)
|
||||
self.principal = Principal("admin", "session")
|
||||
self.s = self.svc.get("index")
|
||||
|
||||
def preview(self):
|
||||
return self.store.render(self.svc, "index", self.s.source, self.s.etag, 4, self.principal)
|
||||
|
||||
def token(self, p):
|
||||
return urlsplit(p["url"]).query.removeprefix("token=")
|
||||
|
||||
def test_token_identity_expiry_epoch_and_cleanup(self):
|
||||
p = self.preview()
|
||||
token = self.token(p)
|
||||
folder, data = self.store.authorize(p["snapshot"], token)
|
||||
self.assertEqual(data["revision"], 4)
|
||||
for snapshot, tok in ((p["snapshot"], token + "bad"), ("a" * 32, token)):
|
||||
with self.assertRaises(PermissionError):
|
||||
self.store.authorize(snapshot, tok)
|
||||
self.time[0] += 601
|
||||
with self.assertRaises(PermissionError):
|
||||
self.store.authorize(p["snapshot"], token)
|
||||
self.time[0] = 1000
|
||||
self.state.joinpath("auth_epoch").write_text("1")
|
||||
with self.assertRaises(PermissionError):
|
||||
self.store.authorize(p["snapshot"], token)
|
||||
self.preview()
|
||||
self.assertFalse(folder.exists())
|
||||
|
||||
def test_last_twenty_snapshots_per_session_document(self):
|
||||
first = self.preview()
|
||||
for i in range(21):
|
||||
self.time[0] += 1
|
||||
self.preview()
|
||||
self.assertEqual(len(list(self.store.directory.iterdir())), 20)
|
||||
with self.assertRaises(PermissionError):
|
||||
self.store.authorize(first["snapshot"], self.token(first))
|
||||
|
||||
def test_immutable_assets_unsaved_source_and_no_canonical_write(self):
|
||||
self.write("assets/new.svg", '<svg xmlns="http://www.w3.org/2000/svg"/>')
|
||||
original = (self.site / self.s.path).read_bytes()
|
||||
source = self.s.source.replace("title: Главная", "title: Unsaved preview")
|
||||
p = self.store.render(self.svc, "index", source, self.s.etag, 5, self.principal)
|
||||
folder, _ = self.store.authorize(p["snapshot"], self.token(p))
|
||||
html = (folder / "index.html").read_text()
|
||||
self.assertIn("Unsaved preview", html)
|
||||
self.assertIn('data-preview-scope="page"', html)
|
||||
self.assertIn('data-preview-scope="layout"', html)
|
||||
self.assertIn("preview:ready", html)
|
||||
self.assertEqual(
|
||||
(folder / "assets/new.svg").read_bytes(), (self.site / "assets/new.svg").read_bytes()
|
||||
)
|
||||
self.write("assets/new.svg", "changed")
|
||||
self.assertIn("<svg", (folder / "assets/new.svg").read_text())
|
||||
self.assertEqual((self.site / self.s.path).read_bytes(), original)
|
||||
self.assertFalse((self.out / "current").exists())
|
||||
|
||||
def test_scriptless_preview_has_selection_markers_without_enabling_scripts(self):
|
||||
from site_engine.web.preview_app import snapshot_response
|
||||
|
||||
with patch.object(self.store, "config", None):
|
||||
preview = self.preview()
|
||||
folder, _ = self.store.authorize(preview["snapshot"], self.token(preview))
|
||||
html = (folder / "index.html").read_text()
|
||||
self.assertIn('data-preview-scope="page"', html)
|
||||
self.assertIn('data-preview-scope="layout"', html)
|
||||
self.assertIn("data-preview-selected", html)
|
||||
self.assertNotIn("preview:ready", html)
|
||||
self.assertFalse(preview["interactive"])
|
||||
response = snapshot_response(self.store, preview["snapshot"], self.token(preview))
|
||||
self.assertIn("script-src 'none'", response.headers["content-security-policy"])
|
||||
self.assertEqual(response.headers["x-frame-options"], "SAMEORIGIN")
|
||||
|
||||
def test_symlink_and_traversal_rejected(self):
|
||||
self.write("assets/real.txt", "inside")
|
||||
(self.site / "assets/link.txt").symlink_to(self.site / "assets/real.txt")
|
||||
for rel in ("../site.yaml", "link.txt", "a/../real.txt", "/etc/passwd"):
|
||||
with self.assertRaises((UnsafePathError, FileNotFoundError)):
|
||||
asset_path(self.site / "assets", rel)
|
||||
with self.assertRaises(UnsafePathError):
|
||||
self.preview()
|
||||
|
||||
def test_separate_app_has_no_admin_and_checks_every_resource(self):
|
||||
p = self.preview()
|
||||
env = {
|
||||
"SITE_ADMIN_ORIGIN": self.config.admin,
|
||||
"SITE_PREVIEW_ORIGIN": self.config.preview,
|
||||
"SITE_STATE_DIR": str(self.state),
|
||||
"SITE_SECRET_KEY": ("secret-" * 8),
|
||||
}
|
||||
with patch.dict(os.environ, env):
|
||||
app = create_preview_app()
|
||||
# Factory uses wall clock: use a live-clock snapshot for actual ASGI requests.
|
||||
store = PreviewStore(self.state, b"secret-" * 8, self.config)
|
||||
self.write("assets/new.svg", '<svg xmlns="http://www.w3.org/2000/svg"/>')
|
||||
p = store.render(self.svc, "index", self.s.source, self.s.etag, 4, self.principal)
|
||||
parsed = urlsplit(p["url"])
|
||||
with TestClient(app) as client:
|
||||
self.assertEqual(client.get("/admin/login").status_code, 404)
|
||||
self.assertEqual(client.get("/admin/api/v1/site").status_code, 404)
|
||||
self.assertEqual(client.get(parsed.path).status_code, 403)
|
||||
response = client.get(parsed.path + "?" + parsed.query)
|
||||
self.assertEqual(response.status_code, 200)
|
||||
self.assertNotIn("x-frame-options", response.headers)
|
||||
self.assertIn(
|
||||
"frame-ancestors " + self.config.admin, response.headers["content-security-policy"]
|
||||
)
|
||||
self.assertNotIn("script-src 'self'", response.headers["content-security-policy"])
|
||||
asset = f"/s/{p['snapshot']}/assets/new.svg"
|
||||
self.assertEqual(client.get(asset).status_code, 403)
|
||||
self.assertEqual(client.get(asset + "?" + parsed.query).status_code, 200)
|
||||
self.state.joinpath("auth_epoch").write_text("1")
|
||||
self.assertEqual(client.get(asset + "?" + parsed.query).status_code, 403)
|
||||
|
||||
def test_display_markers_and_public_build_no_bridge(self):
|
||||
from site_engine.services.entries import EntryService
|
||||
|
||||
svc = EntryService(self.site, collection="services")
|
||||
s = svc.get("bots")
|
||||
p = self.store.render(svc, "bots", s.source, s.etag, 1, self.principal)
|
||||
folder, _ = self.store.authorize(p["snapshot"], self.token(p))
|
||||
self.assertIn('data-preview-scope="display"', (folder / "index.html").read_text())
|
||||
build_site(self.site, self.out)
|
||||
html = "".join(p.read_text() for p in (self.out / "current").rglob("*.html"))
|
||||
self.assertNotIn("data-preview-", html)
|
||||
self.assertNotIn("preview:ready", html)
|
||||
|
||||
def test_origin_validation(self):
|
||||
invalid = [
|
||||
("https://cms.example", "https://cms.example"),
|
||||
("http://cms.example", "https://p.example"),
|
||||
("https://cms.example/", "https://p.example"),
|
||||
("https://cms.example", ""),
|
||||
("https://CMS.example", "https://cms.example:443"),
|
||||
]
|
||||
for a, p in invalid:
|
||||
with (
|
||||
patch.dict(os.environ, {"SITE_ADMIN_ORIGIN": a, "SITE_PREVIEW_ORIGIN": p}),
|
||||
self.assertRaises(ValueError),
|
||||
):
|
||||
PreviewConfig.from_env()
|
||||
|
||||
def test_css_dependencies_have_tokens_and_normalized_paths(self):
|
||||
from site_engine.services.preview import rewrite_css
|
||||
|
||||
text = rewrite_css(
|
||||
'@import "other.css";a{background:url(../image.svg?v=1)}',
|
||||
"css/main.css",
|
||||
"/s/snapshot/assets/",
|
||||
"TOKEN",
|
||||
)
|
||||
self.assertIn("/s/snapshot/assets/css/other.css?token=TOKEN", text)
|
||||
self.assertIn("/s/snapshot/assets/image.svg?v=1&token=TOKEN", text)
|
||||
|
||||
def test_markers_do_not_add_wrappers_or_confuse_scopes(self):
|
||||
from site_engine.core.preview_marks import mark_roots
|
||||
|
||||
html = '<section><img src="x"><p>Text</p></section><aside>Other</aside>'
|
||||
page = mark_roots(html, "page", "index", "same")
|
||||
layout = mark_roots(html, "layout", "default", "same")
|
||||
self.assertEqual(page.count('data-preview-id="same"'), 2)
|
||||
self.assertEqual(page.count("<section"), 1)
|
||||
self.assertIn('data-preview-scope="layout"', layout)
|
||||
self.assertIn('data-preview-owner="default"', layout)
|
||||
Reference in New Issue
Block a user