[SSO] Liaison d'appareil pour les clients natifs (TikTak Desktop) — flux code d'appareil émettant un jeton draco #75
Closed
opened 2026-11-16 17:03:26 -05:00 by bruno
·
1 comment
No Branch/Tag Specified
main
feat/liaison-appareil-draco
retour-sso-cookie-draco-bug-125
entree-sso-bug-123-124
menu-compte-admin-v060
fix/deconnexion-globale-bug-122
hub21-reglages-obsigate
hub19-roles-obsigate-2-85-1
hub22-sessions-machine
hub18-theme-commun
hub13-api-admin-comptes-2-84-0
hub12-barre-v041
hub11-barre-v040
hub1-barre-v030
recherche-shaarit
barre-v020-2-83-1
spark-vault-dir
fix-ci-main
secrets-afficher-copier
barre-v0111-2-82-7
barre-logos-2-82-6
barre-logos-2-82-5
fix/retrait-splash-demarrage
fix/recherche-texte-theme-parasite
federation-recherche-console
console-federation-recherche
obsigate-recherche-theme
align-recherche-console
alertes-onglets-5
recherche-onglets-ux-68
coffre-distribuables
cors-recherche-alertes-68-69
recherche-partout-68-rebase
alertes-unifiees-69-rebase
recherche-partout-68
alertes-unifiees-69
fusion-70-barre-console-spark
barre-apps-v0.1.6-obsigate
fix/version-2.81.1
fix/sidebar-console-style-domaine
fix/ci-tests-openapi-themes
fix/icone-secrets-coffre-fort
fix/ruff-coffres-imports
fix/version-2.81.0
feat/coffre-phase5-deploiement
feat/coffre-phase2
fix/mypy-coffre-2.80.2
fix/version-2.80.1-ruff
feat/theme-spark
feat/coffre-secrets-phase1
v2.87.0
v2.86.3
v2.86.2
v2.86.1
v2.86.0
v2.85.1
v2.85.0
v2.84.1
v2.84.0
v2.83.5
v2.83.4
v2.83.3
v2.83.2
v2.83.1
v2.83.0
v2.82.8
v2.82.7
v2.82.6
v2.82.5
v2.82.4
v2.82.3
v2.82.2
v2.82.1
v2.82.0
v2.81.4
v2.81.3
v2.81.2
v2.81.1
v2.81.0
v2.80.2
v2.80.1
v2.80.0
v2.79.0
v2.78.2
v2.78.1
v2.78.0
v2.77.1
v2.77.0
v2.76.1
v2.76.0
v2.75.0
v2.74.1
v2.74.0
v2.73.1
v2.73.0
v2.72.1
v2.72.0
v2.71.0
v2.70.1
v2.70.0
v2.69.0
v2.68.6
v2.68.5
v2.68.4
v2.68.3
v2.68.2
v2.68.1
v2.68.0
v2.67.2
v2.67.1
v2.67.0
v2.66.0
v2.65.2
v2.65.1
v2.65.0
v2.64.0
v2.63.0
v2.62.0
v2.61.0
v2.60.0
v2.58.0
v2.57.1
v2.57.0
v2.56.0
v2.55.0
v2.54.0
v2.53.3
v2.53.2
v2.53.1
v2.53.0
v2.52.0
v2.51.0
v2.50.2
v2.50.1
v2.50.0
v2.49.4
v2.49.2
v2.49.1
v2.49.0
v2.48.0
v2.47.1
v2.47.0
v2.46.0
v2.45.2
v2.45.1
v2.45.0
v2.44.1
v2.44.0
v2.43.2
v2.43.1
v2.43.0
v2.42.0
v2.41.0
v2.40.0
v2.39.10
v2.39.9
v2.39.8
v2.39.7
v2.39.6
v2.39.5
v2.39.4
v2.39.3
v2.39.2
v2.39.1
v2.39.0
v2.38.0
v2.37.0
v2.36.0
v2.35.0
v2.34.0
v2.33.0
v2.32.0
v2.31.0
v2.30.0
v2.29.0
v2.28.16
v2.28.15
v2.28.14
v2.28.13
v2.28.12
v2.28.11
v2.28.10
v2.28.9
v2.28.8
v2.28.7
v2.28.6
v2.28.5
v2.28.4
v2.28.3
v2.28.2
v2.28.1
v2.28.0
v2.27.12
v2.27.11
v2.27.10
v2.27.9
v2.27.8
v2.27.7
v2.27.6
v2.27.5
v2.27.4
v2.27.3
v2.27.2
v2.27.1
v2.27.0
v2.25.1
v2.25.0
v2.24.0
v2.23.0
v2.22.1
v2.22.0
v2.21.0
v2.20.0
v2.19.2
v2.19.1
v2.19.0
v2.18.0
v2.17.0
v2.16.6
v2.16.5
v2.16.4
v2.16.3
v2.16.2
v2.16.1
v2.16.0
v2.15.0
v2.14.1
v2.14.0
v2.13.1
v2.13.0
v2.12.2
v2.12.1
v2.12.0
v2.11.6
v2.11.5
v2.11.4
v2.11.3
v2.11.2
v2.11.1
v2.11.0
v2.10.1
v2.10.0
v2.9.1
v2.9.0
v2.8.4
v2.8.3
v2.8.2
v2.8.1
v2.8.0
v2.7.5
v2.7.4
v2.7.3
v2.7.2
v2.7.1
v2.7.0
v2.6.2
v2.6.1
v2.6.0
v2.5.2
v2.5.1
v2.5.0
v2.4.0
v2.3.4
v2.3.3
v2.3.2
v2.3.1
v2.3.0
v2.2.1
v2.2.0
v2.1.0
v2.0.0
v1.8.0
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: Projets/ObsiGate#75
Reference in New Issue
Block a user
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.
Demande de Bruno (2026-11-16) : faire fonctionner l'authentification TikTak Desktop avec le jeton central draco (SSO) — option A choisie (audit
~/workspace/audit-appareils-lies/RAPPORT.md). Cette issue est la brique serveur manquante : le flux d'appairage côté émettrice. Le lot client Desktop vient ENSUITE, une fois ce protocole défini et livré.Pourquoi cette issue existe (vérifié à la source)
Projets/ticktick-clone#213 (ACC-3.2, livré 0.52.0, commit 4664396, kanban:review) —app/draco.pyvalide le cookiedraco_sessionlocalement (HS256, secret partagé +_PREV, expiration, révocation en cache 60 s), accroché àcurrent_user/auth_gate/api_user; mappingsub→ compte viadraco_links(migration 017) ; Fusion #143 (0.61.25) : toutsubinconnu passe par le provisionnement JIT (HUB-15,fusion-trois-apps#129, kanban:review). Inerte tant queDRACO_SESSION_SECRETn'est pas configuré dans le conteneur TikTak.draco_sessionest un cookie HttpOnly sur.dracodev.net, délivré parSet-Cookieau login navigateur (backend/draco_session.py:issue_token,set_cookie;TOKEN_TTL_SECONDS= 12 h).GET /sso/authorize(backend/routers/sso.py:37) n'accepte qu'unreturn_toen*.dracodev.net(anti open-redirect) — un schéma personnalisé (tiktak://) ou un loopback127.0.0.1serait rejeté. Il n'existe aucun flux « code d'appareil » dans ObsiGate (0 occurrence de « appareil » dansbackend/, vérifié ; les 4 occurrences « oauth » sont du bruit : commentaires et regex Google).Projets/agent-communapp/appareils.py+ routesapp/main.py:4496-4590, 5560-5594(Fusion #45, livré 0.50.0, déployé sur agent.dracodev.net) — même UX (codeXXXX-XXXX, page d'approbation, sondage), mais il émet des jetonsdka_qui n'authentifient que contre agent-commun. Client de référence : DracoSHsrc/sparkhttp.zig(faireLogin, sondage 2 s, stockage~/.dracosh/spark.json0600 / DPAPI Windows).Cible
Un flux « code d'appareil » émis PAR ObsiGate, délivrant un jeton draco utilisable par les clients natifs (TikTak Desktop d'abord ; DracoSH/DracoTerm ensuite si voulu), en miroir d'agent-commun :
POST /api/v1/liaison){nom, type}→{demande_id, code_utilisateur, code_appareil, expire_le, url_liaison}. Code 8 caractères, alphabet sans ambiguïté, affichéXXXX-XXXX. Expiration courte (10 min chez agent-commun), plafond de demandes en attente.GET /liaison?code=XXXX-XXXX, saisie manuelle du code possible) — session SSO exigée ;POST …/approuver {code}/…/refuser. La réponse d'approbation ne contient JAMAIS le jeton.POST …/sonder {demande_id, code_appareil}→en_attente/approuvee(+jeton,appareil) /refusee/expiree/livree; 404 si inconnu/mauvais code.draco_session.issue_token; seule l'empreinte (SHA-256) est stockée. Révocation intégrée au mécanisme existant (revoked_list,GET /api/sso/revocations). Métadonnées :nom(hostname),type,cree_le,derniere_utilisation,revoque_le— pas d'IP, pas d'OS, pas de version.Décisions de conception à trancher dans le lot (documenter le choix dans le commentaire de livraison)
dka_vs 12 h + endpoint de renouvellement. Recommandation : longue durée commedka_, révocable, car c'est le sens d'un appareil lié — à confirmer pendant l'implémentation.desktop/terminalconnus chez agent-commun ; TikTak Desktop se lierait commedesktop(ambigu dans la vue Appareils) sauf ajout d'un type dédié.user_for_dracol'applique et reproduire le même comportement.Audit préalable (obligatoire)
backend/routers/sso.py,backend/draco_session.py,backend/auth/) et lire intégralementagent-commun/app/appareils.py+ les routes associées comme spécification de référence.issue_token/verify_token/revoked_listsont utilisables depuis un nouveau module sans casser le SSO navigateur existant.Contraintes
/sso/authorize,/sso/logout,/api/sso/revocations, cookie navigateur et révocations restent intacts et testés.kanban:reviewvérifié parget-issue. Le lot client TikTak Desktop est un travail séparé, après celui-ci.Livraison — liaison d'appareil, flux « code d'appareil » émettant un jeton draco (v2.87.0)
PR #76 (branche
feat/liaison-appareil-draco, ouverte — le merge est ta décision, jamais fusionnée sans ton go). Aucune publication, aucun déploiement (tu redéploies).Audit de l'existant (confirmé)
backend/), vérifié surbackend/routers/sso.py,backend/draco_session.py,backend/auth/.agent-commun/app/appareils.py+ routesapp/main.py:4496-4590, 5560-5594(Fusion #45, 0.50.0) ; client de référence DracoSHsrc/sparkhttp.zig(faireLogin, sondage 2 s).issue_token/verify_token/revoked_listsont réutilisables tels quels depuis un nouveau module — le SSO navigateur n'est pas touché.Ce qui est livré, point par point
POST /api/v1/liaison(201, sans auth){nom, type}→{demande_id, code_utilisateur, code_appareil, expire_le, url_liaison}. 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à).GET /liaison?code=XXXX-XXXX(saisie manuelle possible, FR/EN, aucun script inline) — session native exigée ;POST …/approuver/…/refuser. La réponse d'approbation ne contient jamais le jeton (vérifié par test).POST /api/v1/liaison/sonder {demande_id, code_appareil}→en_attente/approuvee(+jeton,appareil) /refusee/expiree/livree; 404 si inconnue ou mauvais code (indiscernables, volontairement).draco_session.issue_token(nouveaux paramètresttl_seconds+extra_claims) ; seule l'empreinte SHA-256 du code d'appareil est stockée ; révocation intégrée (revoked_list,GET /api/sso/revocations) ; métadonnées nom/type/cree_le/revoque_le(+derniere_utilisationànull— voir écarts). Pas d'IP, pas d'OS, pas de version.GET /api/v1/appareils,POST /api/v1/appareils/{id}/revoquer(session SSO) ; un jeton d'appareil ne peut ni gérer les appareils ni décider une liaison (403 en cookie draco, 401 en Bearer).backend/draco_appareils.py(logique pure, JSONdata/— même patron quedraco_session.py) ; routeurbackend/routers/liaison.py; pagefrontend/liaison.html/js/css; tag OpenAPI « Liaison d'appareil ».Décisions tranchées (et pourquoi)
dka_— c'est le sens d'un appareil lié (se relier chaque jour serait inacceptable pour un desktop) ; la révocation est le contrôle, pas l'expiration.desktop/terminal(agent-commun) +tiktakdédié — sinon TikTak Desktop serait ambigu avec un desktop générique dans la vue Appareils. Type inconnu →desktop, jamais d'erreur.iat, rôle « aucun » → 403 explicite en français).user_for_dracojoint_draco_appareilquand le claim est présent.docs/features/liaison-appareil-draco.md) : un jeton d'appareil est un jeton draco à part entière — présenté comme cookie chez ObsiGate (ou tout consommateur draco), il authentifie comme l'utilisateur, avec les mêmes gardes ; seule la gestion des appareils lui est interdite. Si un appareil est perdu : révoquer (liste des appareils, déconnexion globale, ou admin HUB-13).derniere_utilisationreste à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.Contrôles (tous verts)
pytest tests/: 1991 passed, 1 skipped (dont 13 nouveauxtests/test_draco_liaison.py: flux complet, refus, expiration 410/expiree, mauvais code 404, double livraison, plafond 429, sans session 401, jeton d'appareil 403/401, rôle Hub « aucun » 403, dédoublonnage, types inconnus).ruff check backend/: 0 erreur ;mypy backend/: 0 erreur (130 fichiers) ;tests/test_version.py+test_draco_barre.py: 64 passed ; frontendvalidate-imports(44 modules, 0 erreur) +unit.test.mjs(13 passed).test_draco_session,test_draco_config,test_draco_barrevertes (52 tests de base + nouveaux).~/workspace/obsigate-75/smoke.sh) — démarrer → approuver (réponse sans jeton) → sonder (jeton) → 2e sondage (livree, sans jeton) → jeton valide comme cookie draco (/api/auth/me200) → 403 sur la gestion → révocation → 401. Données sur disque vérifiées (draco_appareils.json,draco_liaisons.json,draco_revoked.json,draco_issued.json).Limites / restes
curl: démarrer → ouvrir l'URL → approuver → sonder → jeton → appel authentifié TikTak une foisDRACO_SESSION_SECRETconfiguré dans le conteneur TikTak)./liaisonest couverte par les tests backend + vérification manuelle par curl).faireLoginDracoSH) — travail séparé, après celui-ci.