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

105 lines
5.3 KiB
Markdown

# #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:<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.