- COOKIE_SECURE env now accepts: 'true' (secure), 'false' (memory-only), 'single_user' (no cookie) - config.parse_cookie_mode() returns (COOKIE_SECURE, SINGLE_USER) tuple for routing - single_user_owner() returns oldest Owner for test/local deployments - session cookie respects mode: Max-Age only in secure mode, dropped for memory-only - base.html renders ephemeral-session and single-user banners per mode - Tests: comprehensive coverage for all three modes with monkeypatch configs - CLAUDE.md + README docs updated Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
81 lines
2.7 KiB
Python
81 lines
2.7 KiB
Python
"""Owner session routes — backup-key download and restore-on-new-browser."""
|
|
from __future__ import annotations
|
|
|
|
from pathlib import Path
|
|
|
|
from fastapi import APIRouter, Form, HTTPException, Request
|
|
from fastapi.responses import HTMLResponse, PlainTextResponse, RedirectResponse
|
|
from fastapi.templating import Jinja2Templates
|
|
|
|
import imptune.config as cfg
|
|
from imptune.db.models import Owner
|
|
from imptune.services.session import COOKIE_NAME, cookie_kwargs, is_same_origin
|
|
|
|
router = APIRouter(prefix="/session")
|
|
|
|
templates = Jinja2Templates(
|
|
directory=str(Path(__file__).parent.parent / "templates")
|
|
)
|
|
|
|
|
|
def _require_cookie_sessions() -> None:
|
|
"""404 these routes in single-user mode — keys have no meaning without a cookie.
|
|
|
|
Restoring one could not re-point anything, and downloading one would hand
|
|
out the shared owner's bearer key, which turns into a live credential the
|
|
moment the deployment is switched back to a cookie-scoped mode.
|
|
"""
|
|
if cfg.SINGLE_USER:
|
|
raise HTTPException(status_code=404, detail="Session keys are disabled in single-user mode")
|
|
|
|
|
|
@router.get("/key/download")
|
|
def download_key(request: Request) -> PlainTextResponse:
|
|
"""Mark the current owner permanent and hand back its key as a backup file."""
|
|
_require_cookie_sessions()
|
|
owner: Owner = request.state.owner
|
|
if not owner.is_permanent:
|
|
owner.is_permanent = True
|
|
owner.save()
|
|
|
|
return PlainTextResponse(
|
|
content=owner.key,
|
|
headers={"Content-Disposition": 'attachment; filename="imptune-backup-key.txt"'},
|
|
)
|
|
|
|
|
|
@router.get("/restore", response_class=HTMLResponse)
|
|
def restore_page(request: Request, error: str = "") -> HTMLResponse:
|
|
_require_cookie_sessions()
|
|
return templates.TemplateResponse(
|
|
request=request,
|
|
name="session_restore.html",
|
|
context={"error": error},
|
|
)
|
|
|
|
|
|
@router.post("/restore")
|
|
def restore_session(request: Request, key: str = Form(...)):
|
|
"""Re-associate this browser with a previously downloaded backup key."""
|
|
_require_cookie_sessions()
|
|
if not is_same_origin(request):
|
|
return templates.TemplateResponse(
|
|
request=request,
|
|
name="session_restore.html",
|
|
context={"error": "Request rejected — please submit this form directly from this site."},
|
|
status_code=403,
|
|
)
|
|
|
|
owner = Owner.get_or_none(Owner.key == key.strip())
|
|
if owner is None:
|
|
return templates.TemplateResponse(
|
|
request=request,
|
|
name="session_restore.html",
|
|
context={"error": "Key not found."},
|
|
status_code=404,
|
|
)
|
|
|
|
response = RedirectResponse(url="/", status_code=303)
|
|
response.set_cookie(COOKIE_NAME, owner.key, **cookie_kwargs())
|
|
return response
|