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).
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
/liaisonmê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
- Écran de connexion desktop : bouton « Se connecter avec mon compte central » + libellé de l'environnement (og / og-dev).
POST /api/desktop/sso/start(backend local) →POST {central}/api/v1/liaison(serveur-à-serveur) → codeXXXX-XXXX, URL d'approbation.- L'app ouvre l'URL dans le navigateur système (
shell:allow-open). L'utilisateur se connecte au central si besoin, puis approuve. 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(cookiedraco_session, jamais journalisé) ; - sélectionne l'admin local (
OBSIGATE_ADMIN_USER, puisadmin, puis le premier admin actif) ; - émet les jetons natifs locaux avec le même format que
/api/auth/login.
- valide le jeton draco via
- 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 queOBSIGATE_DESKTOP_SSOn'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/pollne 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.netetog-dev.dracodev.netsont 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 pasX-Forwarded-Proto, le central renvoie parfoishttp://viarequest.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 POSTstart/pollrefusent 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/liaisonmême hôte.