# #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](../ISSUES_TODOLIST.md) (retour `/liaison` même hôte). ## Problème L'application desktop embarque son propre backend FastAPI sur `http://127.0.0.1:`. 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.