feat: 2FA, Passwortrichtlinie und wiederherstellbares JSON-Backup
Zwei-Faktor per TOTP mit zehn Einmal-Wiederherstellungscodes. Der Zwischenzustand "Passwort stimmt, Code fehlt" haengt an der vorhandenen Sitzungstabelle (pending_2fa, zehn Minuten Laufzeit) und gilt nirgends als angemeldet; nach dem Code wird das Cookie getauscht statt weiterverwendet. Der Wiederverwendungsschutz merkt sich das tatsaechlich getroffene Zeitfenster, nicht die aktuelle Uhrzeit - sonst liesse sich ein Code aus dem naechsten Fenster gleich darauf nochmal einloesen. Passwortrichtlinie (Laenge, Zeichenklassen, MFA-Pflicht) in der neuen globalen Tabelle app_settings, durchgesetzt beim Anlegen, Zuruecksetzen und Aendern von Passwoertern. Bestehende Passwoerter lassen sich nicht gegen eine neue Richtlinie pruefen - der Hash gibt nichts her. Beim Anmelden liegt das Passwort aber kurz im Klartext vor: dort wird geprueft und bei Verstoss ein Wechsel verlangt, mit passendem Grund fuer den Hinweistext. Nebenbei geschlossen: must_change_password war bisher nur im Frontend erzwungen, wer die API direkt ansprach kam vorbei. enforce_account_state haengt jetzt am /api-Sammelrouter und laesst nur noch durch, was man zum Erfuellen der Pflicht braucht. Das JSON-Backup liess sich bisher grundsaetzlich nicht zurueckladen: keine Version, Kategorien nur ueber mehrdeutige Namen, sieben Tabellen fehlten. Daneben steht nun ein Format v2, das Beziehungen ueber lokale IDs abbildet, je Benutzer oder systemweit. Zurueckgeladen wird nach einer Pruefansicht, wahlweise ersetzend oder ergaenzend; vor dem Ersetzen legt der Server einen Schnappschuss der Datenbank an. Der alte Ansichts-Export bleibt fuer Tabellenkalkulationen bestehen und wird beim Hochladen ausdruecklich abgewiesen, statt halb zu raten. Frontend: wiederverwendbares Passwortfeld mit Augensymbol, animierte Anforderungsliste, 2FA-Seite, Admin-Karte fuer die Richtlinie und Karte zum Zurueckladen. Neue Bewegung ist in prefers-reduced-motion hinterlegt; Secret und Codes sind markierbar, sonst verhinderte das globale user-select das Kopieren. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Scarriffle
co-authored by
Claude Opus 5
Claude Opus 5
parent
1d5b23c127
commit
7fc8763d57
@@ -0,0 +1,479 @@
|
||||
"""Voll-Backup als JSON: Export und Wiederherstellung.
|
||||
|
||||
Warum ein eigenes Format neben ``/export/all.json``: jener Export ist zum
|
||||
Ansehen gedacht und referenziert alles über Namen. Kategorienamen sind aber
|
||||
nicht eindeutig, mehrere Tabellen fehlen ganz, und eine Version steht auch nicht
|
||||
drin – zurückladen lässt sich das nicht verlustfrei.
|
||||
|
||||
Hier wird stattdessen tabellengetrieben gearbeitet: jede Zeile bringt ihre
|
||||
Quell-ID als ``local_id`` mit, Fremdschlüssel bleiben IDs. Beim Einspielen wird
|
||||
eine Abbildung ``local_id -> neue ID`` aufgebaut und jeder Verweis übersetzt.
|
||||
Das ist unabhängig von Namen und überlebt auch doppelte Bezeichnungen.
|
||||
|
||||
Zwei Reichweiten:
|
||||
|
||||
``user`` – die Daten eines Benutzers. Jeder kann sein eigenes Backup ziehen.
|
||||
``system`` – alle Benutzer inklusive Passwort-Hash und TOTP-Secret, dazu die
|
||||
globalen Tabellen. Nur für Admins; die Datei ist wie ein Passwort
|
||||
zu behandeln.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
from dataclasses import dataclass, field
|
||||
from datetime import date as date_t, datetime, time as time_t
|
||||
from decimal import Decimal
|
||||
from typing import Callable
|
||||
|
||||
from sqlalchemy import Boolean, Date, DateTime, Numeric, Time
|
||||
from sqlalchemy import Enum as SAEnum
|
||||
from sqlalchemy import inspect as sa_inspect
|
||||
from sqlalchemy.orm import Session
|
||||
|
||||
from ..branding import VERSION
|
||||
from ..models import (
|
||||
Account,
|
||||
AccountIdentifier,
|
||||
AppSetting,
|
||||
BudgetPeriod,
|
||||
BudgetPeriodLine,
|
||||
BudgetTemplateLine,
|
||||
Category,
|
||||
CategoryGroup,
|
||||
CategorizationRule,
|
||||
DashboardLayout,
|
||||
ExchangeRate,
|
||||
ImportBatch,
|
||||
ImportTemplate,
|
||||
PlannedIncomeLine,
|
||||
RecoveryCode,
|
||||
Transaction,
|
||||
User,
|
||||
UserSetting,
|
||||
)
|
||||
|
||||
FORMAT_NAME = "certain-finance-backup"
|
||||
SCHEMA_VERSION = 2
|
||||
ALEMBIC_REVISION = "0008"
|
||||
|
||||
|
||||
class BackupError(ValueError):
|
||||
"""Fachlicher Fehler beim Lesen oder Einspielen eines Backups."""
|
||||
|
||||
|
||||
# --- Tabellenbeschreibung ---------------------------------------------------
|
||||
|
||||
|
||||
@dataclass
|
||||
class TableSpec:
|
||||
key: str # Name im JSON
|
||||
model: type # ORM-Klasse
|
||||
scope: str # owner | user | account | period | global
|
||||
refs: dict[str, str] = field(default_factory=dict) # Spalte -> Tabellen-key
|
||||
has_id: bool = True # False bei Tabellen mit natürlichem Schlüssel
|
||||
label: str = "" # Anzeigename für die Prüfansicht
|
||||
|
||||
def __post_init__(self) -> None:
|
||||
if not self.label:
|
||||
self.label = self.key
|
||||
|
||||
|
||||
# Reihenfolge = Einfügereihenfolge. Verweise dürfen nur auf bereits
|
||||
# eingefügte Tabellen zeigen; gelöscht wird in umgekehrter Reihenfolge.
|
||||
USER_TABLES: list[TableSpec] = [
|
||||
TableSpec("accounts", Account, "owner", label="Konten"),
|
||||
TableSpec("account_identifiers", AccountIdentifier, "account",
|
||||
{"account_id": "accounts"}, label="Konto-Merkmale"),
|
||||
TableSpec("category_groups", CategoryGroup, "owner", label="Kategoriegruppen"),
|
||||
TableSpec("categories", Category, "owner",
|
||||
{"group_id": "category_groups"}, label="Kategorien"),
|
||||
TableSpec("import_templates", ImportTemplate, "owner", label="Import-Vorlagen"),
|
||||
TableSpec("import_batches", ImportBatch, "owner",
|
||||
{"account_id": "accounts", "template_id": "import_templates"},
|
||||
label="Import-Läufe"),
|
||||
TableSpec("transactions", Transaction, "owner", {
|
||||
"account_id": "accounts",
|
||||
"to_account_id": "accounts",
|
||||
"category_id": "categories",
|
||||
"budget_category_id": "categories",
|
||||
"import_batch_id": "import_batches",
|
||||
}, label="Buchungen"),
|
||||
TableSpec("budget_template_lines", BudgetTemplateLine, "owner",
|
||||
{"category_id": "categories"}, label="Budget-Vorlage"),
|
||||
TableSpec("planned_income_lines", PlannedIncomeLine, "owner",
|
||||
{"category_id": "categories", "target_account_id": "accounts"},
|
||||
label="Geplante Einnahmen"),
|
||||
TableSpec("budget_periods", BudgetPeriod, "owner", label="Budget-Monate"),
|
||||
TableSpec("budget_period_lines", BudgetPeriodLine, "period",
|
||||
{"budget_period_id": "budget_periods", "category_id": "categories"},
|
||||
label="Budget-Monatswerte"),
|
||||
TableSpec("dashboard_layouts", DashboardLayout, "owner", label="Dashboard-Layout"),
|
||||
TableSpec("categorization_rules", CategorizationRule, "owner",
|
||||
{"category_id": "categories"}, label="Schlagwortregeln"),
|
||||
TableSpec("user_settings", UserSetting, "user", has_id=False,
|
||||
label="Persönliche Einstellungen"),
|
||||
]
|
||||
|
||||
# Nur im systemweiten Backup, je Benutzer.
|
||||
SYSTEM_USER_TABLES: list[TableSpec] = [
|
||||
TableSpec("recovery_codes", RecoveryCode, "user", label="Wiederherstellungscodes"),
|
||||
]
|
||||
|
||||
# Globale Tabellen (nicht benutzergebunden), nur im systemweiten Backup.
|
||||
GLOBAL_TABLES: list[TableSpec] = [
|
||||
TableSpec("app_settings", AppSetting, "global", has_id=False, label="Globale Einstellungen"),
|
||||
TableSpec("exchange_rates", ExchangeRate, "global", has_id=False, label="Wechselkurse"),
|
||||
]
|
||||
|
||||
# Spalten, die nie exportiert werden: sie werden beim Einspielen neu gesetzt.
|
||||
_SKIP_COLUMNS = {"id", "owner_id", "user_id"}
|
||||
|
||||
|
||||
# --- Werte umwandeln --------------------------------------------------------
|
||||
|
||||
|
||||
def _dump_value(col, value):
|
||||
if value is None:
|
||||
return None
|
||||
if isinstance(col.type, SAEnum):
|
||||
return value.value if hasattr(value, "value") else str(value)
|
||||
if isinstance(col.type, DateTime) or isinstance(value, datetime):
|
||||
return value.isoformat()
|
||||
if isinstance(col.type, Date) or isinstance(value, date_t):
|
||||
return value.isoformat()
|
||||
if isinstance(col.type, Time) or isinstance(value, time_t):
|
||||
return value.isoformat()
|
||||
if isinstance(col.type, Numeric) or isinstance(value, Decimal):
|
||||
return str(value)
|
||||
if isinstance(col.type, Boolean):
|
||||
return bool(value)
|
||||
return value
|
||||
|
||||
|
||||
def _load_value(col, value):
|
||||
if value is None:
|
||||
return None
|
||||
try:
|
||||
if isinstance(col.type, SAEnum) and col.type.enum_class is not None:
|
||||
return col.type.enum_class(value)
|
||||
if isinstance(col.type, DateTime):
|
||||
return datetime.fromisoformat(value)
|
||||
if isinstance(col.type, Date):
|
||||
return date_t.fromisoformat(value)
|
||||
if isinstance(col.type, Time):
|
||||
return time_t.fromisoformat(value)
|
||||
if isinstance(col.type, Numeric):
|
||||
return Decimal(str(value))
|
||||
if isinstance(col.type, Boolean):
|
||||
return bool(value)
|
||||
except (ValueError, TypeError) as exc:
|
||||
raise BackupError(f"Unlesbarer Wert für '{col.key}': {value!r}") from exc
|
||||
return value
|
||||
|
||||
|
||||
def _columns(spec: TableSpec):
|
||||
"""Zu sichernde Spalten – ohne technische IDs, die neu vergeben werden."""
|
||||
return [c for c in sa_inspect(spec.model).columns if c.key not in _SKIP_COLUMNS]
|
||||
|
||||
|
||||
# --- Export -----------------------------------------------------------------
|
||||
|
||||
|
||||
def _query(db: Session, spec: TableSpec, user: User | None):
|
||||
q = db.query(spec.model)
|
||||
if spec.scope == "owner":
|
||||
q = q.filter(spec.model.owner_id == user.id)
|
||||
elif spec.scope == "user":
|
||||
q = q.filter(spec.model.user_id == user.id)
|
||||
elif spec.scope == "account":
|
||||
q = q.join(Account, spec.model.account_id == Account.id).filter(
|
||||
Account.owner_id == user.id
|
||||
)
|
||||
elif spec.scope == "period":
|
||||
q = q.join(BudgetPeriod, spec.model.budget_period_id == BudgetPeriod.id).filter(
|
||||
BudgetPeriod.owner_id == user.id
|
||||
)
|
||||
return q
|
||||
|
||||
|
||||
def _dump_table(db: Session, spec: TableSpec, user: User | None) -> list[dict]:
|
||||
cols = _columns(spec)
|
||||
rows = []
|
||||
for obj in _query(db, spec, user).all():
|
||||
row = {c.key: _dump_value(c, getattr(obj, c.key)) for c in cols}
|
||||
if spec.has_id:
|
||||
row["local_id"] = obj.id
|
||||
rows.append(row)
|
||||
return rows
|
||||
|
||||
|
||||
def _dump_user_data(db: Session, user: User, specs: list[TableSpec]) -> dict:
|
||||
return {spec.key: _dump_table(db, spec, user) for spec in specs}
|
||||
|
||||
|
||||
def _envelope(scope: str, payload: dict) -> dict:
|
||||
return {
|
||||
"format": FORMAT_NAME,
|
||||
"schema_version": SCHEMA_VERSION,
|
||||
"app_version": VERSION,
|
||||
"alembic_revision": ALEMBIC_REVISION,
|
||||
"exported_at": datetime.now().astimezone().isoformat(timespec="seconds"),
|
||||
"scope": scope,
|
||||
**payload,
|
||||
}
|
||||
|
||||
|
||||
def export_user(db: Session, user: User) -> dict:
|
||||
"""Backup der Daten eines Benutzers."""
|
||||
return _envelope("user", {
|
||||
"username": user.username,
|
||||
"data": _dump_user_data(db, user, USER_TABLES),
|
||||
})
|
||||
|
||||
|
||||
def export_system(db: Session) -> dict:
|
||||
"""Backup der ganzen Instanz inklusive Anmeldegeheimnissen (nur Admin)."""
|
||||
user_cols = _columns(TableSpec("users", User, "global"))
|
||||
benutzer = []
|
||||
for u in db.query(User).order_by(User.id).all():
|
||||
satz = {c.key: _dump_value(c, getattr(u, c.key)) for c in user_cols}
|
||||
satz["local_id"] = u.id
|
||||
satz["data"] = _dump_user_data(db, u, USER_TABLES + SYSTEM_USER_TABLES)
|
||||
benutzer.append(satz)
|
||||
return _envelope("system", {
|
||||
"users": benutzer,
|
||||
"global": {spec.key: _dump_table(db, spec, None) for spec in GLOBAL_TABLES},
|
||||
})
|
||||
|
||||
|
||||
def to_bytes(obj: dict) -> bytes:
|
||||
return json.dumps(obj, ensure_ascii=False, indent=2).encode("utf-8")
|
||||
|
||||
|
||||
# --- Umschlag prüfen --------------------------------------------------------
|
||||
|
||||
|
||||
def parse(raw: bytes) -> dict:
|
||||
"""Liest eine hochgeladene Datei und prüft den Umschlag."""
|
||||
try:
|
||||
data = json.loads(raw.decode("utf-8"))
|
||||
except (UnicodeDecodeError, json.JSONDecodeError) as exc:
|
||||
raise BackupError("Die Datei ist kein lesbares JSON.") from exc
|
||||
if not isinstance(data, dict):
|
||||
raise BackupError("Unerwarteter Dateiinhalt – erwartet wird ein JSON-Objekt.")
|
||||
if data.get("format") != FORMAT_NAME:
|
||||
# Der alte, nur zum Ansehen gedachte Export – klar benennen statt
|
||||
# halbherzig zu raten.
|
||||
if "accounts" in data and "category_groups" in data:
|
||||
raise BackupError(
|
||||
"Das ist der Ansichts-Export (all.json). Er lässt sich nicht "
|
||||
"wiederherstellen – bitte ein Backup über „Voll-Backup“ erzeugen."
|
||||
)
|
||||
raise BackupError("Das ist kein Backup von Certain Finance.")
|
||||
version = data.get("schema_version")
|
||||
if version != SCHEMA_VERSION:
|
||||
raise BackupError(
|
||||
f"Backup-Version {version} wird nicht unterstützt "
|
||||
f"(diese Fassung liest Version {SCHEMA_VERSION})."
|
||||
)
|
||||
if data.get("scope") not in ("user", "system"):
|
||||
raise BackupError("Unbekannte Reichweite im Backup.")
|
||||
return data
|
||||
|
||||
|
||||
def summarize(data: dict) -> list[dict]:
|
||||
"""Zählt je Tabelle, was in der Datei steckt – für die Prüfansicht."""
|
||||
if data["scope"] == "user":
|
||||
haeufen = [data.get("data", {})]
|
||||
else:
|
||||
haeufen = [u.get("data", {}) for u in data.get("users", [])]
|
||||
|
||||
zeilen = []
|
||||
for spec in USER_TABLES + SYSTEM_USER_TABLES:
|
||||
anzahl = sum(len(h.get(spec.key) or []) for h in haeufen)
|
||||
if anzahl:
|
||||
zeilen.append({"key": spec.key, "label": spec.label, "count": anzahl})
|
||||
if data["scope"] == "system":
|
||||
zeilen.insert(0, {"key": "users", "label": "Benutzer", "count": len(data.get("users", []))})
|
||||
for spec in GLOBAL_TABLES:
|
||||
anzahl = len(data.get("global", {}).get(spec.key) or [])
|
||||
if anzahl:
|
||||
zeilen.append({"key": spec.key, "label": spec.label, "count": anzahl})
|
||||
return zeilen
|
||||
|
||||
|
||||
# --- Einspielen -------------------------------------------------------------
|
||||
|
||||
# Wie im Modus „Ergänzen" entschieden wird, ob eine Zeile schon da ist.
|
||||
# Rückgabe: Schlüssel, unter dem verglichen wird – oder None für „immer neu".
|
||||
_MERGE_KEYS: dict[str, Callable[[dict], tuple | None]] = {
|
||||
"accounts": lambda r: ("name", (r.get("name") or "").strip().lower()),
|
||||
# Ohne diesen Eintrag würde ein zweiter Ergänzen-Lauf die Eindeutigkeit
|
||||
# (account_id, kind, value_norm) verletzen.
|
||||
"account_identifiers": lambda r: ("ident", r.get("account_id"), r.get("kind"),
|
||||
r.get("value_norm")),
|
||||
"category_groups": lambda r: ("name", (r.get("name") or "").strip().lower()),
|
||||
"categories": lambda r: ("group", r.get("group_id"), (r.get("name") or "").strip().lower()),
|
||||
"import_templates": lambda r: ("name", (r.get("name") or "").strip().lower()),
|
||||
"import_batches": lambda r: ("batch", r.get("account_id"), r.get("filename"),
|
||||
r.get("created_at")),
|
||||
"transactions": lambda r: (
|
||||
("hash", r["import_hash"]) if r.get("import_hash")
|
||||
else ("nat", r.get("date"), r.get("account_id"), r.get("amount_cents"),
|
||||
(r.get("payee") or "").strip().lower())
|
||||
),
|
||||
}
|
||||
|
||||
# Tabellen, die im Modus „Ergänzen" nur dann übernommen werden, wenn der
|
||||
# Benutzer davon noch gar nichts hat. Zeilenweise mischen ergäbe hier Unsinn
|
||||
# (halbe Budgets, doppelte Layouts).
|
||||
_ALL_OR_NOTHING = {
|
||||
"budget_template_lines",
|
||||
"planned_income_lines",
|
||||
"budget_periods",
|
||||
"budget_period_lines",
|
||||
"dashboard_layouts",
|
||||
"categorization_rules",
|
||||
"user_settings",
|
||||
}
|
||||
|
||||
|
||||
def _existing_keys(db: Session, spec: TableSpec, user: User) -> dict[tuple, int]:
|
||||
"""Vergleichsschlüssel der schon vorhandenen Zeilen -> deren ID."""
|
||||
schluessel = _MERGE_KEYS.get(spec.key)
|
||||
if schluessel is None:
|
||||
return {}
|
||||
cols = _columns(spec)
|
||||
treffer: dict[tuple, int] = {}
|
||||
for obj in _query(db, spec, user).all():
|
||||
roh = {c.key: _dump_value(c, getattr(obj, c.key)) for c in cols}
|
||||
k = schluessel(roh)
|
||||
if k is not None:
|
||||
treffer.setdefault(k, obj.id)
|
||||
return treffer
|
||||
|
||||
|
||||
def _delete_user_data(db: Session, user: User, specs: list[TableSpec]) -> None:
|
||||
"""Löscht die Daten eines Benutzers in fremdschlüsselsicherer Reihenfolge."""
|
||||
for spec in reversed(specs):
|
||||
for obj in _query(db, spec, user).all():
|
||||
db.delete(obj)
|
||||
db.flush()
|
||||
|
||||
|
||||
def _insert_rows(
|
||||
db: Session, spec: TableSpec, user: User, rows: list[dict], maps: dict[str, dict[int, int]],
|
||||
merge: bool,
|
||||
) -> int:
|
||||
cols = {c.key: c for c in _columns(spec)}
|
||||
id_map = maps.setdefault(spec.key, {})
|
||||
vorhanden = _existing_keys(db, spec, user) if merge else {}
|
||||
schluessel = _MERGE_KEYS.get(spec.key)
|
||||
neu = 0
|
||||
|
||||
for row in rows:
|
||||
# Verweise zuerst übersetzen – sie fließen auch in den Vergleichsschlüssel ein.
|
||||
aufgeloest = dict(row)
|
||||
for spalte, ziel in spec.refs.items():
|
||||
alt = row.get(spalte)
|
||||
aufgeloest[spalte] = maps.get(ziel, {}).get(alt) if alt is not None else None
|
||||
|
||||
if merge and schluessel is not None:
|
||||
k = schluessel(aufgeloest)
|
||||
if k is not None and k in vorhanden:
|
||||
# Nicht anlegen, aber den Verweis auf die bestehende Zeile merken.
|
||||
if spec.has_id and row.get("local_id") is not None:
|
||||
id_map[row["local_id"]] = vorhanden[k]
|
||||
continue
|
||||
|
||||
werte = {}
|
||||
for name, col in cols.items():
|
||||
if name in spec.refs:
|
||||
werte[name] = aufgeloest[name]
|
||||
else:
|
||||
werte[name] = _load_value(col, row.get(name))
|
||||
if spec.scope in ("owner",):
|
||||
werte["owner_id"] = user.id
|
||||
elif spec.scope == "user":
|
||||
werte["user_id"] = user.id
|
||||
|
||||
obj = spec.model(**werte)
|
||||
db.add(obj)
|
||||
db.flush()
|
||||
if spec.has_id and row.get("local_id") is not None:
|
||||
id_map[row["local_id"]] = obj.id
|
||||
if merge and schluessel is not None:
|
||||
k = schluessel(aufgeloest)
|
||||
if k is not None:
|
||||
vorhanden[k] = obj.id
|
||||
neu += 1
|
||||
return neu
|
||||
|
||||
|
||||
def restore_user_data(
|
||||
db: Session, user: User, data: dict, merge: bool, specs: list[TableSpec] | None = None
|
||||
) -> dict[str, int]:
|
||||
"""Spielt den Datenblock eines Benutzers ein. Ruft **kein** commit."""
|
||||
specs = specs or USER_TABLES
|
||||
if not merge:
|
||||
_delete_user_data(db, user, specs)
|
||||
|
||||
maps: dict[str, dict[int, int]] = {}
|
||||
bilanz: dict[str, int] = {}
|
||||
for spec in specs:
|
||||
rows = data.get(spec.key) or []
|
||||
if merge and spec.key in _ALL_OR_NOTHING:
|
||||
# Nur übernehmen, wenn dazu noch nichts existiert.
|
||||
if _query(db, spec, user).first() is not None:
|
||||
bilanz[spec.key] = 0
|
||||
continue
|
||||
bilanz[spec.key] = _insert_rows(db, spec, user, rows, maps, merge)
|
||||
return bilanz
|
||||
|
||||
|
||||
def restore_system(db: Session, data: dict) -> dict[str, int]:
|
||||
"""Baut die ganze Instanz aus einem systemweiten Backup neu auf.
|
||||
|
||||
Immer ersetzend – ein teilweises Verschmelzen fremder Benutzerkonten wäre
|
||||
nicht sinnvoll deutbar. Ruft **kein** commit; das übernimmt der Aufrufer,
|
||||
damit im Fehlerfall nichts halb eingespielt zurückbleibt."""
|
||||
benutzer = data.get("users") or []
|
||||
if not any(u.get("role") == "admin" for u in benutzer):
|
||||
raise BackupError(
|
||||
"Das Backup enthält keinen Administrator – damit käme niemand mehr hinein."
|
||||
)
|
||||
|
||||
# Benutzer weg: alles Benutzergebundene hängt per ON DELETE CASCADE daran.
|
||||
for u in db.query(User).all():
|
||||
db.delete(u)
|
||||
db.flush()
|
||||
for spec in GLOBAL_TABLES:
|
||||
for obj in db.query(spec.model).all():
|
||||
db.delete(obj)
|
||||
db.flush()
|
||||
|
||||
user_cols = {c.key: c for c in _columns(TableSpec("users", User, "global"))}
|
||||
bilanz: dict[str, int] = {"users": 0}
|
||||
for satz in benutzer:
|
||||
werte = {k: _load_value(col, satz.get(k)) for k, col in user_cols.items()}
|
||||
neuer = User(**werte)
|
||||
db.add(neuer)
|
||||
db.flush()
|
||||
bilanz["users"] += 1
|
||||
teil = restore_user_data(
|
||||
db, neuer, satz.get("data") or {}, merge=False,
|
||||
specs=USER_TABLES + SYSTEM_USER_TABLES,
|
||||
)
|
||||
for key, anzahl in teil.items():
|
||||
bilanz[key] = bilanz.get(key, 0) + anzahl
|
||||
|
||||
global_data = data.get("global") or {}
|
||||
for spec in GLOBAL_TABLES:
|
||||
cols = {c.key: c for c in _columns(spec)}
|
||||
rows = global_data.get(spec.key) or []
|
||||
for row in rows:
|
||||
db.add(spec.model(**{k: _load_value(col, row.get(k)) for k, col in cols.items()}))
|
||||
bilanz[spec.key] = len(rows)
|
||||
db.flush()
|
||||
return bilanz
|
||||
@@ -0,0 +1,134 @@
|
||||
"""Passwortrichtlinie: global vom Admin einstellbar, serverseitig durchgesetzt.
|
||||
|
||||
Die Werte liegen in ``app_settings`` (nicht in ``user_settings`` – die Richtlinie
|
||||
gilt für die ganze Instanz). Das Frontend wertet dieselben Regeln nochmal lokal
|
||||
aus, um beim Tippen eine Checkliste abzuhaken; verbindlich ist ausschließlich
|
||||
diese Datei.
|
||||
|
||||
Zur wiederkehrenden Frage „kann man bestehende Passwörter gegen eine neue
|
||||
Richtlinie prüfen?": nicht über den Hash – der gibt das Passwort nicht her. Wohl
|
||||
aber beim Anmelden, denn dort liegt das Klartext-Passwort für einen Moment vor.
|
||||
Genau das macht ``routers/auth.login``.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from dataclasses import asdict, dataclass
|
||||
|
||||
from fastapi import HTTPException, status
|
||||
from sqlalchemy.orm import Session
|
||||
|
||||
from ..models import AppSetting
|
||||
|
||||
# Grenzen für die Mindestlänge – nach unten, damit die Richtlinie nicht sinnlos
|
||||
# wird, nach oben, damit sich niemand selbst aussperrt.
|
||||
MIN_LENGTH_FLOOR = 8
|
||||
MIN_LENGTH_CEILING = 128
|
||||
|
||||
|
||||
def is_special(c: str) -> bool:
|
||||
"""Sonderzeichen = alles, was weder Buchstabe/Ziffer noch Leerraum ist.
|
||||
|
||||
Bewusst nicht über eine feste ASCII-Liste: „§" oder „€" sollen zählen,
|
||||
Umlaute wie „ü" dagegen nicht (die sind Buchstaben)."""
|
||||
return not c.isalnum() and not c.isspace()
|
||||
|
||||
|
||||
@dataclass
|
||||
class Policy:
|
||||
min_length: int = 10
|
||||
require_upper: bool = True
|
||||
require_lower: bool = True
|
||||
require_digit: bool = True
|
||||
require_special: bool = False
|
||||
mfa_required: bool = False
|
||||
|
||||
def as_dict(self) -> dict:
|
||||
return asdict(self)
|
||||
|
||||
|
||||
# Schlüssel in app_settings <-> Feldname im Datenobjekt.
|
||||
_KEYS = {
|
||||
"password_min_length": "min_length",
|
||||
"password_require_upper": "require_upper",
|
||||
"password_require_lower": "require_lower",
|
||||
"password_require_digit": "require_digit",
|
||||
"password_require_special": "require_special",
|
||||
"mfa_required": "mfa_required",
|
||||
}
|
||||
|
||||
# Menschenlesbare Begründung je Regel – wird bei Verstößen zusammengesetzt.
|
||||
RULE_TEXTS = {
|
||||
"length": "mindestens {n} Zeichen",
|
||||
"upper": "mindestens einen Grossbuchstaben",
|
||||
"lower": "mindestens einen Kleinbuchstaben",
|
||||
"digit": "mindestens eine Ziffer",
|
||||
"special": "mindestens ein Sonderzeichen",
|
||||
}
|
||||
|
||||
|
||||
def _clamp_length(value: int) -> int:
|
||||
return max(MIN_LENGTH_FLOOR, min(MIN_LENGTH_CEILING, value))
|
||||
|
||||
|
||||
def load(db: Session) -> Policy:
|
||||
"""Liest die Richtlinie; fehlende Schlüssel fallen auf die Vorgaben zurück."""
|
||||
stored = {row.key: row.value for row in db.query(AppSetting).all()}
|
||||
pol = Policy()
|
||||
for key, field in _KEYS.items():
|
||||
raw = stored.get(key)
|
||||
if raw is None:
|
||||
continue
|
||||
if field == "min_length":
|
||||
try:
|
||||
pol.min_length = _clamp_length(int(raw))
|
||||
except ValueError:
|
||||
pass
|
||||
else:
|
||||
setattr(pol, field, raw == "true")
|
||||
return pol
|
||||
|
||||
|
||||
def save(db: Session, pol: Policy) -> Policy:
|
||||
"""Schreibt die Richtlinie; die Mindestlänge wird auf den erlaubten Bereich begrenzt."""
|
||||
pol.min_length = _clamp_length(pol.min_length)
|
||||
values = pol.as_dict()
|
||||
for key, field in _KEYS.items():
|
||||
value = values[field]
|
||||
text = str(value) if field == "min_length" else ("true" if value else "false")
|
||||
row = db.get(AppSetting, key)
|
||||
if row is None:
|
||||
db.add(AppSetting(key=key, value=text))
|
||||
else:
|
||||
row.value = text
|
||||
db.commit()
|
||||
return pol
|
||||
|
||||
|
||||
def violations(password: str, pol: Policy) -> list[str]:
|
||||
"""Gibt die Kennungen der *nicht* erfüllten Regeln zurück (leer = in Ordnung)."""
|
||||
offen: list[str] = []
|
||||
if len(password) < pol.min_length:
|
||||
offen.append("length")
|
||||
if pol.require_upper and not any(c.isupper() for c in password):
|
||||
offen.append("upper")
|
||||
if pol.require_lower and not any(c.islower() for c in password):
|
||||
offen.append("lower")
|
||||
if pol.require_digit and not any(c.isdigit() for c in password):
|
||||
offen.append("digit")
|
||||
if pol.require_special and not any(is_special(c) for c in password):
|
||||
offen.append("special")
|
||||
return offen
|
||||
|
||||
|
||||
def assert_ok(db: Session, password: str) -> None:
|
||||
"""Wirft 400 mit einer Klartext-Begründung, wenn das Passwort nicht genügt."""
|
||||
pol = load(db)
|
||||
offen = violations(password, pol)
|
||||
if not offen:
|
||||
return
|
||||
teile = [RULE_TEXTS[r].format(n=pol.min_length) for r in offen]
|
||||
raise HTTPException(
|
||||
status_code=status.HTTP_400_BAD_REQUEST,
|
||||
detail="Das Passwort erfüllt die Richtlinie nicht: " + ", ".join(teile) + ".",
|
||||
)
|
||||
@@ -23,24 +23,39 @@ def _aware(dt: datetime) -> datetime:
|
||||
return dt if dt.tzinfo is not None else dt.replace(tzinfo=timezone.utc)
|
||||
|
||||
|
||||
def create_session(db: DBSession, user: User, user_agent: str | None = None) -> str:
|
||||
# Wie lange der Zwischenzustand „Passwort ok, Code fehlt" gilt. Kurz, weil in
|
||||
# dieser Zeit nur noch der zweite Faktor eingegeben werden soll.
|
||||
PENDING_TTL_MINUTES = 10
|
||||
# So viele Fehlversuche verträgt eine Pending-Sitzung, dann ist sie verbraucht.
|
||||
MAX_2FA_ATTEMPTS = 5
|
||||
|
||||
|
||||
def create_session(
|
||||
db: DBSession, user: User, user_agent: str | None = None, pending_2fa: bool = False
|
||||
) -> str:
|
||||
"""Legt eine Sitzung an und gibt das Klartext-Token zurück (nur hier sichtbar)."""
|
||||
settings = get_settings()
|
||||
gueltig_bis = (
|
||||
_now() + timedelta(minutes=PENDING_TTL_MINUTES)
|
||||
if pending_2fa
|
||||
else _now() + timedelta(days=settings.session_ttl_days)
|
||||
)
|
||||
raw = generate_session_token()
|
||||
entry = UserSession(
|
||||
user_id=user.id,
|
||||
token_hash=hash_session_token(raw),
|
||||
expires_at=_now() + timedelta(days=settings.session_ttl_days),
|
||||
expires_at=gueltig_bis,
|
||||
last_seen_at=_now(),
|
||||
user_agent=(user_agent or "")[:255] or None,
|
||||
pending_2fa=pending_2fa,
|
||||
)
|
||||
db.add(entry)
|
||||
db.commit()
|
||||
return raw
|
||||
|
||||
|
||||
def validate(db: DBSession, raw_token: str) -> User | None:
|
||||
"""Gibt den Benutzer zurück, wenn das Token gültig und nicht abgelaufen ist."""
|
||||
def _lookup(db: DBSession, raw_token: str) -> UserSession | None:
|
||||
"""Sucht die Sitzung und räumt sie weg, falls sie abgelaufen ist."""
|
||||
if not raw_token:
|
||||
return None
|
||||
entry = (
|
||||
@@ -54,6 +69,18 @@ def validate(db: DBSession, raw_token: str) -> User | None:
|
||||
db.delete(entry)
|
||||
db.commit()
|
||||
return None
|
||||
return entry
|
||||
|
||||
|
||||
def validate(db: DBSession, raw_token: str) -> User | None:
|
||||
"""Gibt den Benutzer zurück, wenn das Token gültig und nicht abgelaufen ist.
|
||||
|
||||
Sitzungen, bei denen der zweite Faktor noch aussteht, gelten hier bewusst
|
||||
als *nicht* angemeldet – sonst wäre das Zwischen-Cookie ein vollwertiger
|
||||
Zugang."""
|
||||
entry = _lookup(db, raw_token)
|
||||
if entry is None or entry.pending_2fa:
|
||||
return None
|
||||
user = db.get(User, entry.user_id)
|
||||
if user is None or not user.is_active:
|
||||
return None
|
||||
@@ -62,6 +89,27 @@ def validate(db: DBSession, raw_token: str) -> User | None:
|
||||
return user
|
||||
|
||||
|
||||
def validate_pending(db: DBSession, raw_token: str) -> tuple[UserSession, User] | None:
|
||||
"""Gegenstück zu ``validate`` für den Zwei-Faktor-Schritt."""
|
||||
entry = _lookup(db, raw_token)
|
||||
if entry is None or not entry.pending_2fa:
|
||||
return None
|
||||
user = db.get(User, entry.user_id)
|
||||
if user is None or not user.is_active:
|
||||
return None
|
||||
return entry, user
|
||||
|
||||
|
||||
def note_failed_2fa(db: DBSession, entry: UserSession) -> bool:
|
||||
"""Zählt einen Fehlversuch. Gibt ``True`` zurück, wenn die Sitzung verfällt."""
|
||||
entry.failed_2fa += 1
|
||||
verbraucht = entry.failed_2fa >= MAX_2FA_ATTEMPTS
|
||||
if verbraucht:
|
||||
db.delete(entry)
|
||||
db.commit()
|
||||
return verbraucht
|
||||
|
||||
|
||||
def revoke(db: DBSession, raw_token: str) -> None:
|
||||
entry = (
|
||||
db.query(UserSession)
|
||||
@@ -76,3 +124,10 @@ def revoke(db: DBSession, raw_token: str) -> None:
|
||||
def revoke_all(db: DBSession, user: User) -> None:
|
||||
db.query(UserSession).filter(UserSession.user_id == user.id).delete()
|
||||
db.commit()
|
||||
|
||||
|
||||
def revoke_all_everywhere(db: DBSession) -> None:
|
||||
"""Beendet sämtliche Sitzungen – nach einer systemweiten Wiederherstellung,
|
||||
bei der die Benutzertabelle komplett ausgetauscht wurde."""
|
||||
db.query(UserSession).delete()
|
||||
db.commit()
|
||||
|
||||
@@ -0,0 +1,144 @@
|
||||
"""Zwei-Faktor per TOTP (Authenticator-App) plus Einmal-Wiederherstellungscodes.
|
||||
|
||||
Der QR-Code wird hier serverseitig als PNG-Data-URI erzeugt. Das spart eine
|
||||
JavaScript-Abhängigkeit im Frontend und erspart es, fremdes SVG ins DOM zu
|
||||
schreiben – das Bild landet einfach in einem ``<img src=…>``.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import base64
|
||||
import io
|
||||
import secrets
|
||||
import time
|
||||
from datetime import datetime, timezone
|
||||
|
||||
import pyotp
|
||||
import qrcode
|
||||
from sqlalchemy.orm import Session
|
||||
|
||||
from ..branding import APP_NAME
|
||||
from ..models import RecoveryCode, User
|
||||
from ..security import hash_session_token
|
||||
|
||||
STEP_SECONDS = 30
|
||||
# Ein Schritt Toleranz nach vorn und hinten – deckt übliche Uhrendrift ab,
|
||||
# ohne das Zeitfenster unnötig aufzuweiten.
|
||||
VALID_WINDOW = 1
|
||||
|
||||
RECOVERY_CODE_COUNT = 10
|
||||
RECOVERY_CODE_LENGTH = 10
|
||||
# Ohne 0/O/1/I/L – abgeschriebene Codes sollen nicht an Verwechslungen scheitern.
|
||||
_ALPHABET = "ABCDEFGHJKMNPQRSTUVWXYZ23456789"
|
||||
|
||||
|
||||
def new_secret() -> str:
|
||||
return pyotp.random_base32()
|
||||
|
||||
|
||||
def otpauth_uri(user: User, secret: str) -> str:
|
||||
return pyotp.TOTP(secret).provisioning_uri(name=user.username, issuer_name=APP_NAME)
|
||||
|
||||
|
||||
def qr_data_uri(uri: str) -> str:
|
||||
"""QR-Code als ``data:image/png;base64,…``."""
|
||||
img = qrcode.make(uri)
|
||||
puffer = io.BytesIO()
|
||||
img.save(puffer, format="PNG")
|
||||
return "data:image/png;base64," + base64.b64encode(puffer.getvalue()).decode("ascii")
|
||||
|
||||
|
||||
def matching_step(secret: str, code: str) -> int | None:
|
||||
"""Zu welchem 30-Sekunden-Fenster gehört dieser Code? ``None`` = zu keinem.
|
||||
|
||||
Nicht ``TOTP.verify`` benutzt, weil das nur ja/nein sagt. Für den
|
||||
Wiederverwendungsschutz muss aber feststehen, *welches* Fenster verbraucht
|
||||
wurde – sonst liesse sich ein Code aus dem nächsten Fenster im nächsten
|
||||
Moment erneut einlösen."""
|
||||
code = (code or "").strip().replace(" ", "")
|
||||
if not code.isdigit():
|
||||
return None
|
||||
totp = pyotp.TOTP(secret)
|
||||
jetzt = int(time.time()) // STEP_SECONDS
|
||||
for versatz in range(-VALID_WINDOW, VALID_WINDOW + 1):
|
||||
schritt = jetzt + versatz
|
||||
if secrets.compare_digest(totp.at(schritt * STEP_SECONDS), code):
|
||||
return schritt
|
||||
return None
|
||||
|
||||
|
||||
def consume_code(db: Session, user: User, code: str) -> bool:
|
||||
"""Prüft den Code und verbraucht sein Zeitfenster.
|
||||
|
||||
Ein einmal benutzter Code bleibt zwar bis zu 30 Sekunden rechnerisch gültig,
|
||||
darf aber kein zweites Mal zählen – sonst könnte ein abgefangener Code sofort
|
||||
nachgespielt werden."""
|
||||
if not user.totp_secret:
|
||||
return False
|
||||
schritt = matching_step(user.totp_secret, code)
|
||||
if schritt is None:
|
||||
return False
|
||||
if user.totp_last_step is not None and schritt <= user.totp_last_step:
|
||||
return False
|
||||
user.totp_last_step = schritt
|
||||
db.commit()
|
||||
return True
|
||||
|
||||
|
||||
def _format_code(raw: str) -> str:
|
||||
"""Fünfergruppen mit Bindestrich – deutlich leichter abzuschreiben."""
|
||||
return f"{raw[:5]}-{raw[5:]}"
|
||||
|
||||
|
||||
def generate_recovery_codes(db: Session, user: User) -> list[str]:
|
||||
"""Erzeugt einen frischen Satz Codes; alte werden dabei ungültig.
|
||||
|
||||
Die Klartext-Codes gibt es nur dieses eine Mal – in der Datenbank steht
|
||||
ausschliesslich ihr Hash."""
|
||||
db.query(RecoveryCode).filter(RecoveryCode.user_id == user.id).delete()
|
||||
codes: list[str] = []
|
||||
for _ in range(RECOVERY_CODE_COUNT):
|
||||
roh = "".join(secrets.choice(_ALPHABET) for _ in range(RECOVERY_CODE_LENGTH))
|
||||
codes.append(_format_code(roh))
|
||||
db.add(RecoveryCode(user_id=user.id, code_hash=hash_session_token(roh)))
|
||||
db.commit()
|
||||
return codes
|
||||
|
||||
|
||||
def consume_recovery_code(db: Session, user: User, code: str) -> bool:
|
||||
"""Setzt einen Wiederherstellungscode ein. Jeder Code zählt genau einmal."""
|
||||
roh = (code or "").strip().upper().replace("-", "").replace(" ", "")
|
||||
if not roh:
|
||||
return False
|
||||
treffer = (
|
||||
db.query(RecoveryCode)
|
||||
.filter(
|
||||
RecoveryCode.user_id == user.id,
|
||||
RecoveryCode.code_hash == hash_session_token(roh),
|
||||
RecoveryCode.used_at.is_(None),
|
||||
)
|
||||
.first()
|
||||
)
|
||||
if treffer is None:
|
||||
return False
|
||||
treffer.used_at = datetime.now(timezone.utc)
|
||||
db.commit()
|
||||
return True
|
||||
|
||||
|
||||
def codes_left(db: Session, user: User) -> int:
|
||||
return (
|
||||
db.query(RecoveryCode)
|
||||
.filter(RecoveryCode.user_id == user.id, RecoveryCode.used_at.is_(None))
|
||||
.count()
|
||||
)
|
||||
|
||||
|
||||
def disable(db: Session, user: User) -> None:
|
||||
"""Schaltet 2FA ab und räumt Secret sowie Wiederherstellungscodes weg."""
|
||||
db.query(RecoveryCode).filter(RecoveryCode.user_id == user.id).delete()
|
||||
user.totp_secret = None
|
||||
user.totp_enabled = False
|
||||
user.totp_confirmed_at = None
|
||||
user.totp_last_step = None
|
||||
db.commit()
|
||||
Reference in New Issue
Block a user