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.
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.
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`.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
#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 obtenirdraco_session(cookie HttpOnly,/sso/authorizerefuse lesreturn_tohors*.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) : codeXXXX-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)."appareil",jticonsigné (draco_issued.json) et révocable viarevoked_list. Typesdesktop/terminal/tiktak; dédoublonnage même nom+type ; gardes HUB-19 et changement de mot de passe comme la session draco.Décisions tranchées
dka_— c'est le sens d'un appareil lié ; la révocation est le contrôle, pas l'expiration.tiktakpour ne pas ambiguïserdesktopdans la vue Appareils.user_for_dracoquand le jeton est présenté chez ObsiGate (rôle « aucun » → 403 explicite).Contrôles
pytest tests/: 1991 passed, 1 skipped (dont 13 nouveauxtests/test_draco_liaison.py).ruff check backend/: 0 erreur ;mypy backend/: 0 erreur ;tests/test_version.py+test_draco_barre.py: 64 passed ; frontendvalidate-imports(44 modules, 0 erreur) +unit.test.mjs(13 passed).livree, sans jeton) → jeton valide comme cookie draco → 403 sur la gestion → révocation → 401.test_draco_session,test_draco_config,test_draco_barre) verte.Reste (hors de cette PR)
Fiche :
docs/features/liaison-appareil-draco.md.