Merge branch 'main' into hub21-reglages-obsigate
CI / lint (pull_request) Successful in 1m16s
CI / security (pull_request) Failing after 18s
CI / test (pull_request) Successful in 3m48s
CI / build (pull_request) Successful in 13s
CI / e2e (pull_request) Failing after 15m6s

Résolution des conflits de version : la PR visait 2.85.2 depuis le
main 2.85.1, mais main est passé à 2.87.0 entre-temps. La livraison
HUB-21 (#229) devient 2.87.1 — VERSION, package.json, desktop
(Cargo.toml, Cargo.lock, tauri.conf.json), README FR/EN, CHANGELOG
(section [2.87.1] — 2026-11-17 au-dessus de [2.87.0]) et ROADMAP
resynchronisés. backend/main.py fusionné automatiquement (HUB-21 +
liaison d'appareil #75 cohabitent). Tests : hub_reglages, hub_roles,
version, barre, CSP, recherche verts ; suite complète verte ;
ruff et mypy propres.
This commit is contained in:
2026-11-17 17:16:57 -05:00
34 changed files with 2190 additions and 27 deletions
@@ -0,0 +1,59 @@
# BUG-122 — Déconnexion globale navigable : `GET /sso/logout`
**Carte :** fusion #141 (signalement de Bruno, 2026-11-06, capture
depuis la console Spark). **Version :** 2.86.0. **Prérequis :** ACC-3.1
(#216) — la déconnexion globale existe déjà dans
`POST /api/auth/logout`.
## Constat
Le bouton « Déconnexion » du menu compte de la barre commune
(dracodev-commons) est une **action relayée à l'hôte** (`cfg.onAction`,
sinon événement `draco:bar`) : la barre ne déconnecte jamais
elle-même. Or :
- console Spark, ObsiGate, Flowdeck, TikTak, ShaarIt et Hub ne
branchaient **aucune** action `deconnexion` (clic sans effet,
reproduit en navigateur réel sur la console : session draco intacte
après le clic) ;
- Kanbante, seul branché, ne détruisait que sa session locale — la
session SSO survivait ;
- et de toute façon, aucun hôte n'aurait pu terminer la session
globale : `POST /api/auth/logout` n'est appelable qu'en same-origin
depuis l'interface d'ObsiGate. Il manquait le point d'entrée
navigable, symétrique de `GET /sso/authorize`.
## Livraison (cette PR, côté émettrice)
| Méthode | Chemin | Effet |
|---|---|---|
| GET | `/sso/logout?return_to=<url>` | Déconnexion globale, puis redirection 302 vers le `return_to` validé (repli « / ») |
- La logique de `POST /api/auth/logout` est extraite dans
`apply_global_logout(request, response)` (`backend/auth/router.py`)
et partagée par les deux entrées : révocation des jetons natifs
refresh/access, révocation du `jti` du cookie `draco_session`,
effacement des cookies (dont `draco_session` sur le domaine parent).
- `return_to` passe par la liste blanche existante
(`draco_session.validate_return_to` : https + `dracodev.net` ou
sous-domaine) — aucun relais ouvert.
- Idempotente : sans session, la route redirige quand même (les hôtes
y naviguent même si leur session a déjà expiré).
- La barre d'ObsiGate elle-même branche son action `deconnexion` sur
cette route (`frontend/index.html`, retour à sa racine) — garde :
`tests/test_draco_barre.py::test_barre_deconnexion_branchee`.
## Côté hôtes (PR sœurs, carte fusion #141)
Chaque hôte branche son action `deconnexion` : destruction de sa
session locale d'abord (Flowdeck, TikTak, Kanbante, ShaarIt), puis
navigation vers `<émettrice>/sso/logout?return_to=<sa base>`. La
console et le Hub (session draco seule) naviguent directement.
Après le parcours complet, « Déconnexion » termine **la session de la
suite entière** et la session locale de l'hôte courant.
## Tests
`tests/test_draco_session.py` (+3) : révocation du `jti` + redirection
vers le `return_to` + cookie effacé (`Max-Age=0`), liste blanche
(relais refusé, repli « / »), idempotence sans session.
+77
View File
@@ -0,0 +1,77 @@
# Entrée SSO de bout en bout — BUG-123 + BUG-124
Chantier « entrée SSO de bout en bout » (écarts constatés par Bruno en
test réel le 2026-11-08, compte « testeur » créé au Hub) : deux des
trois écarts tenaient à ObsiGate. Diagnostic mené en navigateur réel
dans une pile locale complète servie sous les noms publics
(`*-dev.dracodev.net`, TLS local), chaîne d'URL et de cookies
journalisée à chaque saut — dossier de preuves `preuve-entree-sso`.
## BUG-123 — L'aller-retour SSO ne se referme pas (session existante)
**Chaîne observée (cas fautif)** : clic « Se connecter avec
ObsiGate (SSO) » dans l'application sœur → `GET
/sso/authorize?return_to=<app>/auth/draco` → `302 /?return_to=…` →
la SPA restaure la session (`initAuth` : jeton encore valide, ou
refresh silencieux via le cookie HttpOnly) et affiche l'accueil —
**le `return_to` n'est jamais suivi**. L'utilisateur reste chez
ObsiGate ; revenu manuellement à l'application, il n'y trouve
aucune session locale (« toujours pas connecté »).
**Cause racine** : le retour n'était honoré qu'à un seul endroit,
`AuthManager.saveToken()` → `_honorReturnTo()` — c'est-à-dire après
un login frais, une MFA ou un WebAuthn. Les deux chemins de
restauration d'`initAuth()` ne passaient ni par `saveToken` ni par
`_honorReturnTo`. Le sous-cas « login frais » refermait la boucle
correctement (vérifié dans la même pile) — d'où un bug invisible
pour qui teste en navigateur vierge sans session centrale.
**Correctif** (`frontend/js/auth.js`) :
- `_honorReturnTo()` retourne `true` quand il redirige (même liste
blanche inchangée : https + `*.dracodev.net`, jamais l'hôte
courant — re-validation cliente en plus de celle du serveur).
- `initAuth()` invoque `_honorReturnTo()` sur ses deux chemins de
restauration réussie, avant `showApp()`.
- Les refresh silencieux **en cours de session** (`refreshAccessToken`
appelé par l'intercepteur) n'honorent toujours pas le retour :
une page déjà ouverte ne doit jamais être redirigée.
## BUG-124 — Le nom du compte absent du menu de la barre après login
**Constat** : juste après le login, le menu compte de la barre
commune affiche l'en-tête générique « Compte » et l'avatar neutre
« ✦ » ; un rechargement forcé fait apparaître le nom.
**Cause racine** : la barre résout le nom dans `cfg.user`, sinon
dans le `title` de l'avatar. Chez ObsiGate, le seul poseur du
`title` était le fetch d'amorçage d'`index.html` au
`DOMContentLoaded` — limité aux sessions **déjà présentes au
chargement**. `renderUserSection()` (`js/auth.js`), appelée pour
toutes les sessions établies (login, restauration), mettait à jour
le bloc latéral et le drapeau admin de la barre (`setAdmin`,
v0.6.0/fusion #142) mais jamais le nom : la barre n'avait aucune
API pour le recevoir.
**Correctif** :
- dracodev-commons **v0.7.0** (PR #15) : API publique
`DRACO_BAR.setUser(user)` — même contrat de valeur que `cfg.user`
(chaîne, ou objet `display_name` / `name` / `username`) ;
resynchronise l'avatar (initiale, infobulle, aria-label) et
l'en-tête du menu compte immédiatement ; `setUser(null)` rétablit
l'état neutre. Barre re-vendangée verbatim dans
`frontend/draco-barre.js`.
- `renderUserSection()` appelle `setUser(name)` pour toute session
établie et `setUser(null)` sans identité ; le fetch d'amorçage
d'`index.html` pousse aussi le nom par `setUser` (le `title` seul
ne resynchronisait ni l'aria-label ni un menu déjà construit).
## Vérifications
- `tests/test_draco_barre.py::test_barre_v070_setuser_et_retour_sso_restauration`
(contrats épinglés) + suites draco/session/version vertes.
- `node ui/barre-apps/tests/barre-apps.test.js` côté commons :
58 tests, 284 assertions (nouveau test setUser).
- Preuve navigateur de bout en bout (scénario de Bruno, contexte
vierge) : voir le rapport du chantier et `preuve-entree-sso/`.
+1 -1
View File
@@ -3,7 +3,7 @@
**Carte :** propagation de HUB-21 (fusion #135) — le pilote TikTak
(0.61.22, en production) a posé le patron de client ; ObsiGate le
consomme à son tour, comme les autres hôtes de la suite.
**Version cible :** 2.85.2 (branche depuis le main 2.85.1).
**Version cible :** 2.85.2 à l'ouverture (branche depuis le main 2.85.1) — **livrée en 2.87.1** (PR #70 fusionnée le 2026-11-17 sur le main 2.87.0).
## Contrat consommé (liste fermée D6(a))
+113
View File
@@ -0,0 +1,113 @@
# #75 — Liaison d'appareil : flux « code d'appareil » émettant un jeton draco
**Carte :** issue Gitea #75 (demande de Bruno, 2026-11-16 : faire fonctionner
l'authentification TikTak Desktop avec le jeton central draco — option A
choisie après audit `~/workspace/audit-appareils-lies/RAPPORT.md`).
**Version :** 2.87.0. **Prérequis :** ACC-3.1 (#216) — ObsiGate émet
`draco_session` ; ACC-3.2 (ticktick-clone #213) — le backend TikTak
valide déjà draco (mapping `sub` → compte, provisionnement JIT HUB-15).
## Constat
Le backend TikTak accepte déjà draco, mais aucune application native ne
peut **obtenir** ce jeton : `draco_session` est un cookie HttpOnly sur
`.dracodev.net`, délivré par `Set-Cookie` au login navigateur, et
`GET /sso/authorize` refuse tout `return_to` hors `*.dracodev.net` (un
schéma `tiktak://` ou un loopback serait rejeté). Le flux équivalent
existe chez agent-commun (`app/appareils.py`, Fusion #45, 0.50.0) — même
UX (code `XXXX-XXXX`, page d'approbation, sondage) — mais il émet des
jetons `dka_` qui n'authentifient que contre agent-commun.
## Livraison (cette PR, côté émettrice)
| Méthode | Chemin | Effet |
|---|---|---|
| POST | `/api/v1/liaison` (201, sans auth) | Démarre une liaison `{nom, type}` → `{demande_id, code_utilisateur, code_appareil, expire_le, url_liaison}` |
| GET | `/liaison?code=XXXX-XXXX` | Page publique d'approbation (saisie manuelle possible) |
| GET | `/api/v1/liaison/en-attente` | Demandes en attente (session) |
| POST | `/api/v1/liaison/approuver` | Approuve (session) → `{appareil}` — **jamais le jeton** |
| POST | `/api/v1/liaison/refuser` | Refuse (session) → `{refusee}` |
| POST | `/api/v1/liaison/sonder` | `en_attente` / `approuvee` (+ `jeton`, livré UNE fois) / `refusee` / `expiree` / `livree` ; 404 si inconnue ou mauvais code |
| GET | `/api/v1/appareils` | Appareils liés de l'utilisateur (session) |
| POST | `/api/v1/appareils/{id}/revoquer` | Révoque (session) → `{revoque: true}` |
- **Module** `backend/draco_appareils.py` (logique pure, sans FastAPI) :
demandes et appareils en JSON dans `data/` (`draco_liaisons.json`,
`draco_appareils.json` — même patron que `draco_session.py` :
chargement paresseux, verrou, écriture atomique). Seule l'empreinte
SHA-256 du code d'appareil est stockée ; le jeton en clair ne vit
que dans la ligne de liaison, entre l'approbation et sa délivrance
unique (colonne vidée à la délivrance, lignes expirées purgées —
une demande approuvée mais jamais délivrée voit son appareil
révoqué à la purge).
- **Jeton** : un JWS draco standard, émis par
`draco_session.issue_token` (nouveaux paramètres `ttl_seconds` et
`extra_claims`) — **longue durée, 10 ans, révocable** (décision :
c'est le sens d'un appareil lié ; la révocation est le contrôle,
pas l'expiration — comme `dka_`). Il porte le claim
`"appareil": "<id>"` ; son `jti` est consigné dans le registre des
émissions (`draco_issued.json`) et sa révocation rejoint
`revoked_list` (donc `GET /api/sso/revocations`, HUB-13
« révoquer toutes les sessions », HUB-22).
- **Code** : 8 caractères, alphabet sans ambiguïté, affiché
`XXXX-XXXX` ; expiration 10 min
(`OBSIGATE_LIAISON_EXPIRATION_MIN`) ; plafond 20 demandes en
attente (429 au-delà).
- **Types** : `desktop` / `terminal` (agent-commun) + `tiktak`
(type dédié pour TikTak Desktop, sinon ambigu avec un desktop
générique) ; type inconnu → `desktop`, jamais d'erreur.
- **Dédoublonnage** : une liaison approuvée révoque les appareils
actifs de même nom+type du même utilisateur (vécu agent-commun
2026-11-13 : un poste = une ligne, un jeton vivant).
- **Rôles Hub (HUB-19)** : le jeton d'appareil est soumis aux mêmes
gardes que la session draco quand il est présenté chez ObsiGate —
changement de mot de passe (`iat`) et rôle Hub (« aucun » → refus
403 explicite). `user_for_draco` joint `_draco_appareil` au dict
utilisateur quand le claim est présent.
- **Garde 403** : un jeton d'appareil ne peut ni gérer les appareils
ni décider une liaison (patron `_exiger_session` d'agent-commun) —
en cookie draco : 403 explicite ; en `Authorization: Bearer` : 401
(ce n'est pas un jeton natif, rejet dès `get_current_user`).
- **Page** `GET /liaison` (`frontend/liaison.html` + `liaison.js` +
`liaison.css`, FR/EN, aucun script inline — CSP) : vérifie la
session (`/api/auth/me`), propose la connexion avec retour ici
(`/?return_to=…`), liste les demandes en attente ou recherche par
code, boutons Approuver / Refuser.
- **Écarts assumés vs agent-commun** : `derniere_utilisation` reste
à `null` (l'émettrice ne voit jamais l'usage du jeton — seul le
consommateur le voit) ; pas de journal d'audit ni d'événement
d'activité (ObsiGate n'a pas ces canaux) ; pas de vue « Appareils »
dans la console — la gestion se fait par l'API et la page
`/liaison` (une vue console est un travail séparé, si voulue).
## Conséquence à connaître (documentée, pas un bug)
Un jeton d'appareil est un **jeton draco à part entière** : présenté
comme cookie chez ObsiGate (ou chez tout consommateur draco), il
authentifie comme l'utilisateur, avec les mêmes gardes (mot de passe,
rôle Hub) — seule la gestion des appareils lui est interdite. Si un
appareil est perdu ou volé, il faut le révoquer (liste des appareils,
déconnexion globale, ou administration des comptes HUB-13) : la
révocation prend effet dès l'appel suivant.
## Côté clients (travaux séparés, après celui-ci)
- **TikTak Desktop** : écran « Lier cet appareil » (copie de
`faireLogin` de DracoSH : code, page `/liaison`, sondage 2 s,
stockage chiffré) ; le backend TikTak accepte déjà le jeton
(il reste à configurer `DRACO_SESSION_SECRET` dans son conteneur).
- **DracoSH / DracoTerm** : le même flux peut remplacer `dka_` si
voulu — les deux jetons coexistent, rien ne change côté
agent-commun.
## Tests
`tests/test_draco_liaison.py` (13 tests, TestClient sur la vraie
application) : flux complet (démarrer → approuver → sonder → jeton →
lister → révoquer → 401), page publique, types inconnus, dédoublonnage,
refus, sondage 404 indiscernable, expiration (410 / `expiree`),
double livraison, plafond (429), sans session (401), jeton d'appareil
refusé sur la gestion (403 cookie / 401 Bearer), rôle Hub « aucun »
(403 explicite), `issue_token` (ttl + claims, réservés non écrasés).
Vérification runtime en plus : flux complet contre un serveur réel
(uvicorn + curl, `~/workspace/obsigate-75/smoke.sh`).
@@ -0,0 +1,99 @@
# Retour SSO — cookie draco réémis avant le retour (BUG-125)
Suite du chantier « entrée SSO de bout en bout » : retest réel de
Bruno le 2026-11-08, après la fusion de BUG-123/BUG-124 (2.86.2)
et du correctif « l'hôte de la requête fait foi » côté applications
sœurs (Kanbante 0.46.9). Le retour tombe désormais sur le bon
hôte, mais l'utilisateur arrive devant le formulaire de
l'application sœur, **sans message d'erreur** — pas connecté.
## Diagnostic (pile « conteneur dev réel », navigateur réel)
Les formes d'échec du pont Kanbante ont d'abord été
cartographiées une à une (jetons forgés/révoqués, compte lié
désactivé, rôle « aucun » au registre du Hub) :
| Cause au pont | Arrivée |
|---|---|
| Jeton valide, correspondance saine | session ouverte |
| Échec de résolution (compte lié désactivé) | `/login?draco=echec` **avec bandeau** |
| Rôle « aucun » au registre | page **403 explicite** |
| Jeton absent, illisible (signature) ou **révoqué** | `/login` **nu, sans signal** |
Le formulaire nu de Bruno ne peut donc venir que de la dernière
ligne : au moment du pont, aucun jeton draco valide n'est
présenté. La variante qui le reproduit à l'identique :
1. login chez ObsiGate (session établie, `sessionStorage`
alimenté) ;
2. suppression des cookies `access_token` et `draco_session`
(le cookie `refresh_token`, 7 j, est conservé) ;
3. Kanbante → « Se connecter avec ObsiGate (SSO) » ;
4. la SPA honore le `return_to` par son chemin court
(`sessionStorage` encore « valide ») — **aucun échange
serveur** ;
5. la requête du pont part **sans cookie `draco_session`**
(journalisée) → Kanbante répond `303 /login`, formulaire nu.
Un second clic, lui, aboutit : le premier passage chez ObsiGate
a provoqué entre-temps la réémission du cookie (activité
authentifiée traversant `DracoRenewalMiddleware`).
## Cause racine
La réémission du cookie `draco_session` est opportuniste :
`DracoRenewalMiddleware` ne peut la poser que sur la réponse
d'une requête portant un cookie `access_token` natif valide.
Le chemin court d'`initAuth()` (session « valide » en
`sessionStorage`, ajouté pour BUG-123) redirige vers
l'application sœur **sans aucune requête authentifiée** : si
les deux cookies ont disparu indépendamment de la session
(cookies purgés séparément, profil restauré, domaines nettoyés
à des rythmes différents — le cookie draco vit 12 h,
l'`access_token` 1 h, le refresh 7 j et `sessionStorage`
suit sa propre logique d'onglet), rien ne réémet le cookie
avant le départ, et le pont sœur est muet par construction
(un jeton absent est indiscernable d'un visiteur jamais
connecté).
## Correctif (`frontend/js/auth.js`, `initAuth()`)
Quand la page est l'arrivée d'un `/sso/authorize`
(`return_to` présent dans l'URL), le chemin court est
écarté : `initAuth()` emprunte toujours le chemin du refresh
silencieux — `POST /api/auth/refresh` (rotation, pose un
nouvel `access_token`) puis `GET /api/auth/me`, dont la
requête porte ce cookie et dont la réponse traverse
`DracoRenewalMiddleware` : le cookie draco absent, invalide
ou en fenêtre de renouvellement est réémis **avant**
`_honorReturnTo()`. Si le refresh échoue (plus de session
centrale réelle), l'écran de connexion s'affiche comme
avant et le `return_to`, toujours dans l'URL, sera honoré
par `saveToken` après login frais.
Hors arrivée `authorize`, le démarrage est strictement
inchangé (chemin court conservé pour les visites directes
d'ObsiGate) ; les refresh en cours de session ne redirigent
toujours jamais.
## Garde et preuve
- `tests/test_draco_barre.py::test_retour_sso_refresh_force_bug_125`
(test épinglé : le chemin court est conditionné à l'absence
de `return_to`, et le compte d'appels `_honorReturnTo` de
BUG-123 reste à 2).
- Preuve navigateur dans la pile « conteneur dev réel »
(dossier `preuve-retour-sso-hote`, scripts `diag-*.py`) :
la variante fautive retourne **connectée** après correctif,
la requête du pont portant le cookie draco réémis.
## Périmètre
Ce correctif ferme le mécanisme « retour honoré sans cookie »
côté émettrice. Les deux autres formes silencieuses relevées
au diagnostic relèvent d'autres gestes, inchangés : jeton
révoqué (déconnexion globale, révocation de session au Hub —
guéri par une reconnexion ou une activité chez ObsiGate) et
jeton illisible pour une application sœur (secret partagé
propre à son conteneur — permanent tant que la configuration
n'est pas alignée).