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).
105 lines
5.3 KiB
Markdown
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.
|