Files
ObsiGate/docs/features/retour-sso-cookie-draco-bug-125.md
T
Spark 83a81b931e
CI / lint (pull_request) Successful in 1m18s
CI / security (pull_request) Successful in 19s
CI / test (pull_request) Successful in 3m43s
CI / build (pull_request) Successful in 12s
CI / e2e (pull_request) Failing after 15m32s
fix: retour SSO — réémission du cookie draco garantie à l'arrivée authorize (BUG-125)
2026-11-08 21:46:30 +00:00

100 lines
4.5 KiB
Markdown

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