diff --git a/.env.example b/.env.example index ba139b4..f05c026 100644 --- a/.env.example +++ b/.env.example @@ -6,6 +6,14 @@ GITEA_TOKEN= KANBANTE_AUTH_USER= KANBANTE_AUTH_PASSWORD= KANBANTE_REQUIRE_AUTH=0 +# Porte centrale unique (désactivée par défaut ; activable aussi au +# panneau d'administration, réglage « porte_centrale ») +KANBANTE_PORTE_CENTRALE=0 +# Porte de secours administrateur (chemin discret /login/secours, +# jamais proposé sur l'écran principal) — compte administrateur +# local désigné, identifiants d'environnement uniquement : +# KANBANTE_PORTE_SECOURS_USER= +# KANBANTE_PORTE_SECOURS_PASSWORD= # Noms publics dracodev — défauts = noms OFFICIELS (prod). # Environnement dev : déclarer ici les noms en -dev, sans toucher au code. KANBANTE_PUBLIC_URL=https://kanbante.dracodev.net diff --git a/CHANGELOG.md b/CHANGELOG.md index cf00d2d..073102c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,13 @@ +## 0.46.6 — 2026-11-06 — Porte centrale unique (programme « compte partout », phase 2 — basée sur la 0.46.5) + +Version **fonctionnelle** dans la série 0.46.x (base : branche 0.46.5, fusion #145/#144 ; la 0.47.0 de la PR #87 reste indépendante et non touchée). **Désactivée par défaut à la livraison** : sans activation explicite d'un administrateur, le comportement est exactement celui de la 0.46.5. + +- **Nouveau réglage `porte_centrale`** (booléen, `app/config.py`) : amorçable par l'environnement (`KANBANTE_PORTE_CENTRALE=1`) et **surchargeable au panneau d'administration** (Administration → Paramètres, patron « l'environnement amorce, le panneau gouverne »). Un compte créé au Hub n'a pas de mot de passe local (il vit chez ObsiGate) : la porte centrale fait de la voie SSO le parcours normal au lieu d'un formulaire voué à échouer pour ces comptes. +- **Mode actif** : l'écran de connexion ne présente **que l'entrée centrale** — le lien « Se connecter avec ObsiGate (SSO) », bien visible, avec l'explication qu'il n'y a pas de mot de passe local ; aucun champ local n'est rendu, et `POST /login` refuse toute tentative (403), identifiants de base comme repli d'environnement. **Sessions déjà établies : aucun impact** (contrôle de session inchangé). Non touchés : Basic d'environnement (voie scripts), jetons `kbt_`, pont `/auth/draco`, `/api/search`. +- **Porte de secours administrateur** : un seul compte désigné, par l'environnement uniquement — `KANBANTE_PORTE_SECOURS_USER` / `KANBANTE_PORTE_SECOURS_PASSWORD` (secrets, jamais en base ni dans le panneau ni en dur) — joignable par le **chemin discret `/login/secours`**, jamais proposé ni lié sur l'écran principal ; sans les deux variables, le chemin répond 404. Gardes : le compte désigné doit être un administrateur local **actif** (ou l'opérateur d'environnement) — un membre désigné par erreur est refusé ; le geste est journalisé (`login.porte_secours`). Fiche complète : `docs/porte-centrale.md` (dont la fiche d'activation opérateur). +- **Correctif au passage (panneau des paramètres)** : la conversion des réglages booléens à l'enregistrement est désormais explicite (`true`/`false` lus en toutes lettres) — auparavant `bool("false")` valait `True`, donc un booléen du panneau (dont `porte_centrale`, mais aussi `sync_*`, `briefing_include_standup`) ne pouvait pas se désactiver en saisissant `false`. +- **Tests** : nouveau `tests/test_porte_centrale.py` (7) — mode inactif par défaut = comportement actuel ; activation puis désactivation par le panneau ; mode actif : écran central seul, secours jamais proposé, formulaire refusé pour un membre comme pour l'amorçage, session préexistante intacte ; porte de secours : chemin discret fonctionnel en plein mode central, mauvais mot de passe et membre refusés, membre désigné refusé, 404 sans configuration ; amorçage par variable d'environnement et surcharge du panneau par-dessus. + ## 0.46.5 — 2026-11-06 — Pont draco : adoption de l'amorçage conditionnée (fusion #145) et échec de connexion qui suggère le SSO (fusion #144, part Kanbante) Version **corrective de sécurité** dans la série 0.46.x (base 0.46.4 ; la 0.47.0 de la PR #87, métadonnées des jetons, reste indépendante et non touchée). diff --git a/README.md b/README.md index 0d51fe6..d3ed5ca 100644 --- a/README.md +++ b/README.md @@ -120,6 +120,8 @@ sudo systemctl enable --now docker | `KANBANTE_DB_PATH` | `~/.kanbante/kanbante.db` | Base SQLite locale (en Docker : `/data/kanbante.db`) | | `KANBANTE_AUTH_USER` / `KANBANTE_AUTH_PASSWORD` | *(vide)* | Active l'authentification dès que les deux sont définis : écran de connexion + session signée pour les navigateurs ; l'en-tête Basic reste accepté pour les scripts | | `KANBANTE_REQUIRE_AUTH` | `0` | `1` = l'app refuse de servir (503) si l'auth n'est pas configurée | +| `KANBANTE_PORTE_CENTRALE` | `0` | `1` = porte centrale unique : l'écran de connexion ne présente que l'entrée ObsiGate (SSO) et le formulaire local est refusé ; surchargeable au panneau d'administration (réglage `porte_centrale`) — voir `docs/porte-centrale.md` | +| `KANBANTE_PORTE_SECOURS_USER` / `KANBANTE_PORTE_SECOURS_PASSWORD` | *(vide)* | Porte de secours : compte administrateur local désigné, joignable par le chemin discret `/login/secours` (jamais proposé sur l'écran principal) ; vide = porte désactivée | | `KANBANTE_SESSION_SECRET` | *(dérivé)* | Clé HMAC du cookie de session ; par défaut dérivée des identifiants (changer le mot de passe invalide les sessions) | | `KANBANTE_SNAPSHOT_INTERVAL` | `120` | Secondes entre les rafraîchissements d'instantanés d'arrière-plan (chantier B) ; `0` = désactivé | | `KANBANTE_ACTIVE_WINDOW_DAYS` | `365` | Un dépôt non archivé mis à jour depuis moins de N jours est « actif » | diff --git a/VERSION b/VERSION index 992b0b0..6b9ee5c 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -0.46.5 +0.46.6 diff --git a/app/config.py b/app/config.py index 675557b..8d8fd1f 100644 --- a/app/config.py +++ b/app/config.py @@ -11,6 +11,24 @@ Environment variables: KANBANTE_AUTH_USER Login username (with _PASSWORD: enables auth). KANBANTE_AUTH_PASSWORD Login password. KANBANTE_REQUIRE_AUTH "1" = refuse to serve if auth is not configured. + KANBANTE_PORTE_CENTRALE "1" = active la « porte centrale unique » + (0.46.6) : l'écran de connexion ne présente + plus que l'entrée centrale (SSO ObsiGate) + et le formulaire local est refusé. Défaut + "0" (désactivé) ; surchargeable depuis le + panneau d'administration (réglage + ``porte_centrale``, l'environnement amorce, + le panneau gouverne). + KANBANTE_PORTE_SECOURS_USER / KANBANTE_PORTE_SECOURS_PASSWORD + Identifiants de la porte de secours + administrateur (0.46.6) : LE compte + administrateur local désigné, joignable + par le chemin discret /login/secours + (jamais proposé sur l'écran principal), + y compris quand la porte centrale est + active. Secrets d'environnement uniquement, + jamais en base ni dans le panneau. Variables + absentes = porte de secours désactivée. KANBANTE_SESSION_SECRET HMAC key for the login session cookie (default: derived from the credentials — rotating the password invalidates sessions). @@ -370,6 +388,9 @@ class Settings: auth_user: str = "" auth_password: str = "" require_auth: bool = False + porte_centrale: bool = False + porte_secours_user: str = "" + porte_secours_password: str = "" active_window_days: int = 365 cache_ttl: float = 30.0 max_note_chars: int = 20_000 @@ -456,6 +477,9 @@ def _env_settings() -> Settings: auth_user=os.getenv("KANBANTE_AUTH_USER", ""), auth_password=os.getenv("KANBANTE_AUTH_PASSWORD", ""), require_auth=_env_bool("KANBANTE_REQUIRE_AUTH", False), + porte_centrale=_env_bool("KANBANTE_PORTE_CENTRALE", False), + porte_secours_user=os.getenv("KANBANTE_PORTE_SECOURS_USER", ""), + porte_secours_password=os.getenv("KANBANTE_PORTE_SECOURS_PASSWORD", ""), active_window_days=_env_int("KANBANTE_ACTIVE_WINDOW_DAYS", 365), cache_ttl=_env_float("KANBANTE_CACHE_TTL", 30.0), max_note_chars=_env_int("KANBANTE_MAX_NOTE_CHARS", 20_000), @@ -551,6 +575,11 @@ OVERRIDABLE_SETTINGS: dict[str, type] = { "capture_repo": str, "sync_labels": bool, "sync_gitea": bool, + # Porte centrale unique (0.46.6) : booléen du panneau — + # l'administrateur l'active/la désactive sans redémarrage. + # Les identifiants de la porte de secours, eux, restent en + # environnement (secrets, jamais surchargeables). + "porte_centrale": bool, } diff --git a/app/main.py b/app/main.py index 9cbd929..a7f957d 100644 --- a/app/main.py +++ b/app/main.py @@ -249,7 +249,7 @@ registry = connections_service.ForgeRegistry() SESSION_COOKIE = "kanbante_session" SESSION_DAYS = 7 _PUBLIC_PATHS = ("/api/health", "/webhooks/gitea", "/api/capture", "/login", - "/auth/draco") + "/login/secours", "/auth/draco") def _session_secret() -> bytes: @@ -536,11 +536,30 @@ def _safe_next(raw: str) -> str: return "/" +def _ouvrir_session(username: str, next: str) -> RedirectResponse: + """Réponse de connexion native : session signée posée, redirection.""" + response = RedirectResponse(_safe_next(next), status_code=303) + response.set_cookie( + SESSION_COOKIE, + _make_session(username), + max_age=SESSION_DAYS * 86400, + httponly=True, + samesite="lax", + ) + return response + + @app.get("/login") async def login_page(request: Request, next: str = "/"): if not get_settings().auth_enabled or _session_user(request) is not None: return RedirectResponse(_safe_next(next), status_code=303) - return render(request, "login.html", next=_safe_next(next), error="") + # Porte centrale (0.46.6) : en mode actif, le gabarit ne + # présente que l'entrée centrale (lien SSO) — aucun champ + # local (voir app/templates/login.html et docs/porte-centrale.md). + return render( + request, "login.html", next=_safe_next(next), error="", + porte_centrale=bool(get_settings().porte_centrale), + ) @app.post("/login") @@ -559,6 +578,25 @@ async def login_submit( request, "login.html", status_code=403, next=_safe_next(next), error="Session expirée — réessaie.", ) + if settings.porte_centrale: + # Porte centrale unique (0.46.6) : en mode actif, les + # identifiants locaux ordinaires ne sont plus acceptés + # sur ce formulaire — ni mot de passe de base, ni repli + # d'environnement. Seules restent : l'entrée centrale + # (SSO ObsiGate, ci-dessous sur l'écran) et, pour + # l'administrateur désigné, la porte de secours discrète + # (/login/secours, identifiants d'environnement — jamais + # proposée ici). Les sessions déjà établies ne passent + # pas par ce formulaire et ne sont pas touchées. + return render( + request, "login.html", status_code=403, + next=_safe_next(next), porte_centrale=True, + error=( + "La porte centrale est active sur cette instance : " + "la connexion locale est fermée. Utilise « Se " + "connecter avec ObsiGate (SSO) » ci-dessous." + ), + ) from app import accounts as accounts_service user = models.get_user_by_username(username) @@ -622,15 +660,88 @@ async def login_submit( sub = claims.get("sub") if sub and models.get_user_by_draco(sub) is None: models.update_user(user["id"], draco_sub=sub) - response = RedirectResponse(_safe_next(next), status_code=303) - response.set_cookie( - SESSION_COOKIE, - _make_session(username), - max_age=SESSION_DAYS * 86400, - httponly=True, - samesite="lax", + return _ouvrir_session(username, next) + + +# ── Porte de secours administrateur (0.46.6) ────────────────── +# Chemin discret /login/secours : jamais lié ni proposé sur +# l'écran principal (ni en mode porte centrale, ni sinon). +# Un seul compte, désigné par l'environnement : +# KANBANTE_PORTE_SECOURS_USER / KANBANTE_PORTE_SECOURS_PASSWORD +# (voir app/config.py). Le compte désigné doit être un +# administrateur local actif (ou l'opérateur d'environnement) : +# un membre désigné par erreur ne passe pas. Sans les deux +# variables, la porte n'existe pas (404 sec, sans explication). + +def _porte_secours_configuree(settings) -> bool: + return bool(settings.porte_secours_user and settings.porte_secours_password) + + +@app.get("/login/secours") +async def login_secours_page(request: Request, next: str = "/"): + settings = get_settings() + if not settings.auth_enabled or _session_user(request) is not None: + return RedirectResponse(_safe_next(next), status_code=303) + if not _porte_secours_configuree(settings): + return render( + request, "error.html", status_code=404, + message="Page introuvable.", + ) + return render( + request, "login.html", next=_safe_next(next), error="", + mode_secours=True, ) - return response + + +@app.post("/login/secours") +async def login_secours_submit( + request: Request, + username: str = Form(""), + password: str = Form(""), + next: str = Form("/"), + csrf_token: str = Form(""), +): + settings = get_settings() + if not settings.auth_enabled: + return RedirectResponse("/", status_code=303) + if not _porte_secours_configuree(settings): + return render( + request, "error.html", status_code=404, + message="Page introuvable.", + ) + if not _csrf_valid(request, csrf_token): + return render( + request, "login.html", status_code=403, mode_secours=True, + next=_safe_next(next), error="Session expirée — réessaie.", + ) + identifiants_ok = secrets.compare_digest( + username, settings.porte_secours_user + ) and secrets.compare_digest(password, settings.porte_secours_password) + compte = ( + models.get_user_by_username(settings.porte_secours_user) + if identifiants_ok + else None + ) + if compte is not None: + admin_ok = bool(compte["active"]) and compte["role"] == "admin" + else: + # Pas de ligne en base : seul l'opérateur d'environnement + # (administrateur synthétique) peut être le compte désigné. + admin_ok = settings.porte_secours_user == settings.auth_user + if not identifiants_ok or not admin_ok: + return render( + request, "login.html", status_code=401, mode_secours=True, + next=_safe_next(next), error="Identifiants incorrects.", + ) + if compte is not None: + models.update_user( + compte["id"], + last_login_at=time.strftime( + "%Y-%m-%d %H:%M:%S", time.gmtime() + ), + ) + models.log_admin(compte["id"], "login.porte_secours", username) + return _ouvrir_session(settings.porte_secours_user, next) @app.get("/logout") @@ -2090,11 +2201,18 @@ async def admin_settings_save(request: Request, csrf_token: str = Form("")): if raw is None or str(raw).strip() == "": continue # champ vide = retour à la valeur d'environnement try: - overrides[key] = ( - str(raw).strip() - if converter is str - else converter(str(raw).strip()) - ) + if converter is bool: + # Booléen lu EXPLICITEMENT (0.46.6) : bool("false") + # vaudrait True — un réglage booléen du panneau + # (porte_centrale, sync_*, briefing_*) doit pouvoir + # se désactiver en saisissant « false ». + overrides[key] = str(raw).strip().lower() in ( + "1", "true", "on", "oui", + ) + elif converter is str: + overrides[key] = str(raw).strip() + else: + overrides[key] = converter(str(raw).strip()) except (TypeError, ValueError): continue import json as _json diff --git a/app/templates/login.html b/app/templates/login.html index 09122b4..ba86b1d 100644 --- a/app/templates/login.html +++ b/app/templates/login.html @@ -19,6 +19,29 @@ {% if error %}
{{ error }}
{% endif %} + {% if mode_secours|default(false) %} + {# Porte de secours administrateur (0.46.6) : ce gabarit n'est + rendu que par le chemin discret /login/secours, jamais + proposé depuis l'écran principal. #} +Porte de secours — administrateur désigné uniquement.
+ + {% elif porte_centrale|default(false) %} + {# Porte centrale unique (0.46.6) : aucune entrée locale — + seule l'entrée centrale est présentée. #} +Cette instance se connecte par la porte centrale de la suite Dracodev : ton compte du Hub ouvre Kanbante via ObsiGate, sans mot de passe local.
+ Se connecter avec ObsiGate (SSO) +Accès restreint — session de {{ 7 }} jours, déconnexion depuis le menu latéral.
+ {% else %} Se connecter avec ObsiGate (SSO)Accès restreint — session de {{ 7 }} jours, déconnexion depuis le menu latéral.
+ {% endif %}