ObsiGate 2.87.0 — Liaison d'appareil : flux code d'appareil émettant un jeton draco (#75) #76

Merged
bruno merged 20 commits from feat/liaison-appareil-draco into main 2026-11-16 19:14:06 -05:00
Owner

#75 — Liaison d'appareil : flux « code d'appareil » émettant un jeton draco (2.87.0)

Brique serveur manquante de l'authentification TikTak Desktop (option A draco, audit ~/workspace/audit-appareils-lies/RAPPORT.md) : une application native ne peut pas obtenir draco_session (cookie HttpOnly, /sso/authorize refuse les return_to hors *.dracodev.net). Ce flux, en miroir d'agent-commun (Fusion #45), émet un jeton draco pour un appareil lié.

Ce qui est livré

  • POST /api/v1/liaison (201, sans auth) : code XXXX-XXXX (10 min), code d'appareil secret, URL d'approbation.
  • GET /liaison?code=… : page publique d'approbation (saisie manuelle possible, FR/EN, aucun script inline).
  • 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 + POST /api/v1/appareils/{id}/revoquer (session exigée, révocation immédiate).
  • Jeton : JWS draco standard, longue durée (10 ans, révocable), claim "appareil", jti consigné (draco_issued.json) et révocable via revoked_list. Types desktop / terminal / tiktak ; dédoublonnage même nom+type ; gardes HUB-19 et changement de mot de passe comme la session draco.
  • Un jeton d'appareil ne peut ni gérer les appareils ni décider une liaison (403 en cookie, 401 en Bearer).

Décisions tranchées

  • Durée de vie : longue durée (10 ans) comme dka_ — c'est le sens d'un appareil lié ; la révocation est le contrôle, pas l'expiration.
  • Types : ajout d'un type dédié tiktak pour ne pas ambiguïser desktop dans la vue Appareils.
  • Dédoublonnage : oui, comme agent-commun (un poste = une ligne, un jeton vivant).
  • Rôles Hub : oui, appliqués via user_for_draco quand le jeton est présenté chez ObsiGate (rôle « aucun » → 403 explicite).
  • Conséquence documentée : un jeton d'appareil est un jeton draco à part entière (valable partout où draco est accepté, ObsiGate comprise) — seule la gestion des appareils lui est interdite. En cas de perte : révoquer.

Contrôles

  • pytest tests/ : 1991 passed, 1 skipped (dont 13 nouveaux tests/test_draco_liaison.py).
  • ruff check backend/ : 0 erreur ; mypy backend/ : 0 erreur ; tests/test_version.py + test_draco_barre.py : 64 passed ; frontend validate-imports (44 modules, 0 erreur) + unit.test.mjs (13 passed).
  • Vérification runtime : flux complet contre un serveur réel (uvicorn + curl) — démarrer → approuver (réponse sans jeton) → sonder (jeton) → 2e sondage (livree, sans jeton) → jeton valide comme cookie draco → 403 sur la gestion → révocation → 401.
  • SSO existant intact : suite draco (test_draco_session, test_draco_config, test_draco_barre) verte.

Reste (hors de cette PR)

  • Validation déployée par Bruno (redéploiement ObsiGate, puis flux complet depuis un client de test).
  • Lot client TikTak Desktop (écran « Lier cet appareil »), après celui-ci.

Fiche : docs/features/liaison-appareil-draco.md.

# #75 — Liaison d'appareil : flux « code d'appareil » émettant un jeton draco (2.87.0) Brique serveur manquante de l'authentification TikTak Desktop (option A draco, audit `~/workspace/audit-appareils-lies/RAPPORT.md`) : une application native ne peut pas obtenir `draco_session` (cookie HttpOnly, `/sso/authorize` refuse les `return_to` hors `*.dracodev.net`). Ce flux, en miroir d'agent-commun (Fusion #45), émet un jeton draco pour un appareil lié. ## Ce qui est livré - `POST /api/v1/liaison` (201, sans auth) : code `XXXX-XXXX` (10 min), code d'appareil secret, URL d'approbation. - `GET /liaison?code=…` : page publique d'approbation (saisie manuelle possible, FR/EN, aucun script inline). - `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` + `POST /api/v1/appareils/{id}/revoquer` (session exigée, révocation immédiate). - Jeton : JWS draco standard, **longue durée (10 ans, révocable)**, claim `"appareil"`, `jti` consigné (`draco_issued.json`) et révocable via `revoked_list`. Types `desktop` / `terminal` / `tiktak` ; dédoublonnage même nom+type ; gardes HUB-19 et changement de mot de passe comme la session draco. - Un jeton d'appareil ne peut ni gérer les appareils ni décider une liaison (403 en cookie, 401 en Bearer). ## Décisions tranchées - **Durée de vie : longue durée (10 ans)** comme `dka_` — c'est le sens d'un appareil lié ; la révocation est le contrôle, pas l'expiration. - **Types** : ajout d'un type dédié `tiktak` pour ne pas ambiguïser `desktop` dans la vue Appareils. - **Dédoublonnage** : oui, comme agent-commun (un poste = une ligne, un jeton vivant). - **Rôles Hub** : oui, appliqués via `user_for_draco` quand le jeton est présenté chez ObsiGate (rôle « aucun » → 403 explicite). - **Conséquence documentée** : un jeton d'appareil est un jeton draco à part entière (valable partout où draco est accepté, ObsiGate comprise) — seule la gestion des appareils lui est interdite. En cas de perte : révoquer. ## Contrôles - `pytest tests/` : **1991 passed, 1 skipped** (dont 13 nouveaux `tests/test_draco_liaison.py`). - `ruff check backend/` : 0 erreur ; `mypy backend/` : 0 erreur ; `tests/test_version.py` + `test_draco_barre.py` : 64 passed ; frontend `validate-imports` (44 modules, 0 erreur) + `unit.test.mjs` (13 passed). - Vérification runtime : flux complet contre un serveur réel (uvicorn + curl) — démarrer → approuver (réponse sans jeton) → sonder (jeton) → 2e sondage (`livree`, sans jeton) → jeton valide comme cookie draco → 403 sur la gestion → révocation → 401. - SSO existant intact : suite draco (`test_draco_session`, `test_draco_config`, `test_draco_barre`) verte. ## Reste (hors de cette PR) - Validation déployée par Bruno (redéploiement ObsiGate, puis flux complet depuis un client de test). - Lot client TikTak Desktop (écran « Lier cet appareil »), après celui-ci. Fiche : `docs/features/liaison-appareil-draco.md`.
bruno added 19 commits 2026-11-16 17:29:28 -05:00
feat: liaison d'appareil — flux code d'appareil émettant un jeton draco (#75, 2.87.0)
CI / lint (pull_request) Successful in 1m51s
CI / security (pull_request) Failing after 31s
CI / test (pull_request) Successful in 3m39s
CI / build (pull_request) Successful in 12s
CI / e2e (pull_request) Failing after 14m50s
750dfc25a1
bruno added 1 commit 2026-11-16 17:29:55 -05:00
docs: roadmap #229 — PR #76 (#75, 2.87.0)
CI / lint (pull_request) Successful in 1m37s
CI / security (pull_request) Failing after 25s
CI / test (pull_request) Successful in 3m41s
CI / build (pull_request) Successful in 46s
CI / e2e (pull_request) Failing after 15m14s
9021765b45
bruno merged commit 4c686afac3 into main 2026-11-16 19:14:06 -05:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Projets/ObsiGate#76