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).
This commit is contained in:
@@ -0,0 +1,104 @@
|
||||
# #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.
|
||||
@@ -121,5 +121,21 @@
|
||||
`webauthn-key-item`), boutons `.config-btn-sm` (primaire/secondaire),
|
||||
override mobile 44px dans le bloc `#config-modal`.
|
||||
- [x] Tests : `test_default_first_run_config`, `test_welcome_doc_embedded`
|
||||
— `cargo test` 28 passed ; suites frontend vertes (validate-imports,
|
||||
- `cargo test` 28 passed ; suites frontend vertes (validate-imports,
|
||||
unit, config-mobile, desktop-roots, settings-order) + E2E locale.
|
||||
|
||||
## I. Connexion centralisée & environnement prod/dev - #230 - 🟢 livré (2026-11-19)
|
||||
|
||||
- [x] Liaison d'appareil sur le central choisi → validation du jeton draco
|
||||
par `/api/auth/me` → session de l'admin local par défaut
|
||||
(`backend/routers/desktop_sso.py`).
|
||||
- [x] Shell Rust : champ `environment`, commandes `get_desktop_settings` /
|
||||
`set_desktop_environment`, injection `OBSIGATE_DESKTOP*` + `DRACO_*` au
|
||||
seul backend embarqué, admin local `admin` / `chab30` à la création.
|
||||
- [x] UI : bouton « compte central » sur l'écran de connexion, sélecteur
|
||||
prod/dev dans la Configuration et le wizard (i18n FR/EN), ouverture du
|
||||
navigateur système via `open_external_url` (ACL).
|
||||
- [x] Aucun impact web Docker : routes `/api/desktop/sso/*` en 404 hors
|
||||
desktop, UI conditionnée par `isTauriEnv()`.
|
||||
- [x] BUG-127 : retour `/liaison` même hôte honoré après le login central.
|
||||
- **Fiche dédiée :** [`desktop-sso-environnement-230.md`](./desktop-sso-environnement-230.md).
|
||||
|
||||
Reference in New Issue
Block a user