Replace manual .env configuration with a browser-based setup wizard. New users deploy with `docker compose up` and configure Forgejo OAuth credentials through /setup on first visit. Existing users can reconfigure via the same page (auth-gated post-setup). Key changes: Rename (Myst → Firebreak): - Config fields, env vars, session cookie, templates, docker-compose, README all renamed from Myst to Firebreak Setup wizard (/setup): - New AppSettings single-row DB table stores Forgejo config - Auto-generates Fernet encryption key on first setup - SetupRequiredMiddleware redirects all routes to /setup pre-config - Reconfigure mode pre-fills existing values, requires auth - Landing page links to /setup for recovery if OAuth breaks Settings page (/settings): - PAT registration moved out of dashboard into dedicated page - Token card with registration date, delete, and update actions - Dashboard shows CTA linking to settings when no PAT registered Auth updates: - Routes use AppSettings from DB instead of env-based Settings - OAuth callback redirects new users to /settings for PAT setup - Forgejo API errors no longer leak upstream response bodies - Decrypt failures return actionable 503 instead of unhandled 500 Code quality: - Extracted templating.py to eliminate circular import hacks - AppSettings.get_fernet() caches Fernet cipher instance - User.has_pat property replaces scattered None checks - lookup_session promoted to public API - Dead code removed, return type annotations added - PAT input fields use type="password" - CSRF gap documented in agents.md for future addressing Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
38 lines
1.5 KiB
Python
38 lines
1.5 KiB
Python
from __future__ import annotations
|
|
|
|
import datetime
|
|
|
|
from cryptography.fernet import Fernet
|
|
from pydantic import SecretStr
|
|
from sqlalchemy import CheckConstraint, DateTime, String, Text, func
|
|
from sqlalchemy.orm import Mapped, mapped_column
|
|
|
|
from app.auth.crypto import fernet_from_encryption_key
|
|
from app.database import Base
|
|
|
|
|
|
class AppSettings(Base):
|
|
__tablename__ = "app_settings"
|
|
__table_args__ = (CheckConstraint("id = 1", name="single_row"),)
|
|
|
|
id: Mapped[int] = mapped_column(primary_key=True, default=1)
|
|
forgejo_base_url: Mapped[str] = mapped_column(String, nullable=False)
|
|
forgejo_oauth_client_id: Mapped[str] = mapped_column(String, nullable=False)
|
|
forgejo_oauth_client_secret_encrypted: Mapped[str] = mapped_column(Text, nullable=False)
|
|
firebreak_public_base_url: Mapped[str] = mapped_column(String, nullable=False, default="")
|
|
token_encryption_key: Mapped[str] = mapped_column(Text, nullable=False)
|
|
setup_completed_at: Mapped[datetime.datetime] = mapped_column(
|
|
DateTime(timezone=True), server_default=func.now()
|
|
)
|
|
|
|
__allow_unmapped__ = True
|
|
_fernet: Fernet | None = None
|
|
|
|
def get_fernet(self) -> Fernet:
|
|
"""Return a cached Fernet cipher from the stored encryption key."""
|
|
if self._fernet is None:
|
|
fernet = fernet_from_encryption_key(SecretStr(self.token_encryption_key))
|
|
if fernet is None:
|
|
raise ValueError("Token encryption key is missing or empty in app settings.")
|
|
self._fernet = fernet
|
|
return self._fernet
|