Files
ObsiGate/docs/features/desktop-sso-environnement-230.md
T
bruno f77b0e6574
CI / lint (push) Failing after 29s
CI / test (push) Skipped
CI / build (push) Skipped
CI / e2e (push) Skipped
CI / security (push) Failing after 16s
feat: desktop — connexion compte central + environnement prod/dev (#230)
Liaison d'appareil sur og/og-dev, validation du jeton draco et ouverture de la session de l'admin local. Sélecteur prod/dev (Configuration + premier lancement), admin local par défaut admin/chab30, sans impact sur le web Docker. Inclut BUG-126 (runtime python-embed/_pth + copie de backend/frontend + signature updater opt-in) et BUG-127 (retour /liaison même hôte).
2026-11-20 07:19:08 -05:00

5.3 KiB

#230 — Desktop : connexion avec un compte central + choix d'environnement

Statut : livré (en attente de vérification utilisateur) Impact : desktop uniquement — l'application web Docker est inchangée. Fiche liée : BUG-127 (retour /liaison même hôte).

Problème

L'application desktop embarque son propre backend FastAPI sur http://127.0.0.1:<port>. Le cookie draco_session émis par le site central ( Domain=.dracodev.net ) n'est jamais envoyé à cette origine :

  • la connexion locale (admin + mot de passe) restait possible, mais aucun moyen de se connecter avec le compte central ;
  • les liens inter-apps de la barre pointaient toujours la production, sans choix dev/prod ;
  • au premier lancement, le mot de passe admin était aléatoire et affiché uniquement dans les logs — inaccessible sans terminal.

Décisions (validation Bruno, 2026-11-19)

Sujet Décision
Méthode de login central Liaison d'appareil existante (/api/v1/liaison) : pas de mot de passe central saisi dans l'app, aucune modification du backend web.
Accès local après validation Déverrouille l'admin local par défaut (app mono-utilisateur). Aucun utilisateur local créé.
Choix d'environnement Configuration + premier lancement, persisté dans %APPDATA%\ObsiGate\config.json.
Admin local par défaut admin / chab30 à la création initiale (backend en loopback), modifiable ensuite.

Flux

  1. Écran de connexion desktop : bouton « Se connecter avec mon compte central » + libellé de l'environnement (og / og-dev).
  2. POST /api/desktop/sso/start (backend local) → POST {central}/api/v1/liaison (serveur-à-serveur) → code XXXX-XXXX, URL d'approbation.
  3. L'app ouvre l'URL dans le navigateur système (shell:allow-open). L'utilisateur se connecte au central si besoin, puis approuve.
  4. POST /api/desktop/sso/poll (toutes les 2 s) → POST {central}/api/v1/liaison/sonder. À l'approbation, le backend local :
    • valide le jeton draco via GET {central}/api/auth/me (cookie draco_session, jamais journalisé) ;
    • sélectionne l'admin local (OBSIGATE_ADMIN_USER, puis admin, puis le premier admin actif) ;
    • émet les jetons natifs locaux avec le même format que /api/auth/login.
  5. L'interface applique AuthManager.saveToken() puis le démarrage habituel (_onLoginSuccess). Le login local reste disponible en parallèle.

Environnement

Le shell Rust injecte dans le backend embarqué uniquement :

Variable Valeur prod Valeur dev
OBSIGATE_DESKTOP_SSO 1 1
OBSIGATE_DESKTOP_ENV prod dev
DRACO_AGENT_URL https://agent.dracodev.net https://agent-dev.dracodev.net
DRACO_OBSIGATE_URL https://og.dracodev.net https://og-dev.dracodev.net
OBSIGATE_ADMIN_USER / _PASSWORD admin / chab30 idem

backend/draco_config dérive les sœurs (Flowdeck, TikTak, Kanbante, ShaarIt, Hub) en -dev depuis l'hôte de l'agent (BUG-120), donc window.DRACO_URLS suit l'environnement choisi. Gitea reste en prod.

Le changement d'environnement (Configuration ou wizard) enregistre la valeur puis appelle restart_backend ; les variables sont réinjectées au prochain démarrage du backend local.

Inertie hors desktop

  • Les routes /api/desktop/sso/* répondent 404 tant que OBSIGATE_DESKTOP_SSO n'est pas activé (le shell Tauri seul le pose).
  • Côté frontend, tout est conditionné par isTauriEnv() : la page web Docker ne montre ni le bouton central, ni le sélecteur d'environnement.
  • Aucun changement de comportement pour les connexions locales existantes.

Sécurité

  • start / poll ne transportent aucun secret d'utilisateur ; le jeton central n'est utilisé que dans l'appel serveur-à-serveur /api/auth/me.
  • Seuls les hôtes og.dracodev.net et og-dev.dracodev.net sont acceptés (pas de SSRF arbitraire). L'URL d'approbation est reconstruite sur ce site central en https : derrière un reverse proxy qui ne transmet pas X-Forwarded-Proto, le central renvoie parfois http:// via request.base_url (observé en prod le 2026-11-19).
  • Le jeton n'est ni persisté ni loggé. La session locale est un jeton natif normal (cookie refresh 7/30 jours) : une révocation centrale ne coupe pas rétroactivement cette session locale (utiliser « Déconnexion » dans l'app pour la terminer).
  • Le backend desktop n'écoute que sur 127.0.0.1 ; les POST start/poll refusent en plus une origine navigateur non locale (Origin).
  • BUG-127 : /liaison (même hôte) est honoré après le login central, sinon l'approbation ne reprenait pas ; les autres retours même-hôte restent ignorés (pas de boucle).

Tests

  • tests/test_desktop_sso.py (9) : routes inertes hors desktop, statut, délégation à la liaison, attente/approbation/refus, validation central, sélection de l'admin local, refus d'un hôte central inconnu.
  • desktop/src/main.rs : normalisation d'environnement, URLs, variables injectées, compatibilité des anciennes configs (32 tests Rust, dont l'ACL).
  • tests/frontend/desktop.test.mjs (30) : commandes d'environnement, label, dégradation web.
  • tests/test_desktop_sso_ui.py + tests/test_draco_barre.py : garde-fous UI/Tauri-only et retour /liaison même hôte.