Files
tsumugu/backend/app/auth/security.py
T
LarsandClaude Sonnet 5.5 037c0724a8
Deploy Development / deploy (push) Successful in 42s
Test Suite / pytest-backend (push) Successful in 3m28s
Test Suite / smoke-dev (push) Successful in 0s
Test Suite / frontend-build (push) Successful in 20s
Ergänze die Benutzerverwaltung, damit der Betreiber Konten, Rollen und Zugänge verwalten kann.
Der Betreiber legt Konten mit Einmal-Passwort an, deaktiviert und aktiviert sie, setzt Passwörter zurück, beendet Sitzungen und vergibt die Betreiberrolle; der letzte Betreiber und das eigene Konto sind geschützt. Nutzer ändern ihr Passwort und sehen ihre Geräte. Räume kennen neben Mitglied und Verwalter die Rolle Leser, die nichts anlegt und keine Bearbeiten- oder Freigeben-Grants erhält. Verwalter pflegen Mitglieder, Rollen und Einladungen mit Rolle; der Betreiber sieht Räume ohne Inhalte und liest das Verwaltungsprotokoll. Die Login-Begrenzung steht in der Datenbank, unbekannte Konten laufen durch einen Zeitausgleich.

Die lokale Suite läuft mit 116 Tests grün, der Frontend-Build und 16 Node-Tests ebenfalls. Die Oberfläche wurde noch nicht im Browser bedient.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-20 12:49:23 +02:00

103 lines
3.4 KiB
Python

"""Password hashing, session cookies and CSRF."""
from __future__ import annotations
import hashlib
import secrets
from datetime import timedelta
from functools import lru_cache
import bcrypt
from fastapi import Request, Response
from app.core.settings import Settings
from app.core.timeutil import utcnow
HOST_COOKIE = "__Host-jinkendo-session"
PLAIN_COOKIE = "jinkendo-session"
def hash_password(password: str) -> str:
return bcrypt.hashpw(password.encode("utf-8"), bcrypt.gensalt(rounds=12)).decode("utf-8")
def verify_password(password: str, password_hash: str) -> bool:
try:
return bcrypt.checkpw(password.encode("utf-8"), password_hash.encode("utf-8"))
except ValueError:
return False
@lru_cache
def _dummy_hash() -> str:
return hash_password("kein-konto-nur-zeitausgleich")
def verify_unknown_account(password: str) -> None:
"""Spend the same time as a real check so the answer time does not reveal an account."""
verify_password(password, _dummy_hash())
def login_bucket(host: str, email: str) -> str:
"""Rate-limit key. The address is never stored in the clear."""
return hashlib.sha256(f"{host}|{email}".encode("utf-8")).hexdigest()
_BROWSERS = (("Edg/", "Edge"), ("OPR/", "Opera"), ("Firefox/", "Firefox"), ("Chrome/", "Chrome"), ("Safari/", "Safari"))
_SYSTEMS = (("Windows", "Windows"), ("iPhone", "iPhone"), ("iPad", "iPad"), ("Android", "Android"), ("Mac OS", "macOS"), ("Linux", "Linux"))
def device_label(user_agent: str | None) -> str:
"""A short, readable hint for the session list. The full user agent is not kept."""
agent = user_agent or ""
browser = next((name for marker, name in _BROWSERS if marker in agent), "Browser")
system = next((name for marker, name in _SYSTEMS if marker in agent), "")
return f"{browser} auf {system}" if system else browser
def new_secret() -> str:
return secrets.token_urlsafe(32)
def hash_secret(secret: str) -> str:
return hashlib.sha256(secret.encode("utf-8")).hexdigest()
def cookie_name_and_secure(request: Request, settings: Settings) -> tuple[str, bool]:
# __Host- cookies require Secure. Production is only published behind HTTPS.
# Development also serves the documented plain HTTP LAN addresses, which cannot store them.
if settings.tsumugu_env == "production":
return HOST_COOKIE, True
forwarded = request.headers.get("x-forwarded-proto", request.url.scheme)
if forwarded == "https":
return HOST_COOKIE, True
return PLAIN_COOKIE, False
def read_session_token(request: Request) -> str | None:
return request.cookies.get(HOST_COOKIE) or request.cookies.get(PLAIN_COOKIE)
def set_session_cookie(response: Response, request: Request, settings: Settings, token: str) -> None:
name, secure = cookie_name_and_secure(request, settings)
response.set_cookie(
key=name,
value=token,
httponly=True,
secure=secure,
samesite="lax",
path="/",
max_age=settings.session_ttl_hours * 3600,
)
def clear_session_cookie(response: Response, request: Request, settings: Settings) -> None:
name, secure = cookie_name_and_secure(request, settings)
response.delete_cookie(key=name, path="/", secure=secure, httponly=True, samesite="lax")
if name != PLAIN_COOKIE:
response.delete_cookie(key=PLAIN_COOKIE, path="/", httponly=True, samesite="lax")
def session_expiry(settings: Settings):
return utcnow() + timedelta(hours=settings.session_ttl_hours)