fix(sso): rattachement par homonymie, conflit explicite et re-liaison par double preuve au pont draco (0.46.10)
CI / test (pull_request) Failing after 1s
CI / test (push) Failing after 3m13s

Cas réel Bruno (2026-11-16) : le bouton SSO ne connectait pas son
compte « bruno » — résolution par sub seul : clone JIT « bruno-2 »
servi à la place de son admin (compte sans lien ou lié à un ancien
sub), et formulaire nu sans message quand le jeton était illisible
pour le service.

- resolve_draco_user : étape 3, rattachement par homonymie (compte
  local homonyme sans lien rattaché au sub vérifié) ; homonyme lié
  à un autre sub = conflit (aucun rattachement, aucun clone).
- Pont : /login?draco=conflit et /login?draco=invalide explicites ;
  le formulaire nu ne subsiste que pour un jeton absent ou inerte.
- Re-liaison par double preuve : /auth/draco/relier (page + POST),
  exemption de cohérence limitée à ce chemin, réécriture journalisée.
- Tests : tests/test_draco_rattachement.py (9, cas réel) ; contrat
  homonyme de test_draco_correspondance.py inversé ; refus signalés
  dans test_draco_sso.py. Doc : docs/correspondance-draco.md.
This commit is contained in:
Spark
2026-11-16 19:50:25 +00:00
parent eac6156d47
commit 365a724e6e
9 changed files with 768 additions and 48 deletions
+97 -18
View File
@@ -91,20 +91,29 @@ def ensure_bootstrap_admin() -> dict | None:
# l'utilisateur connecté lie explicitement son compte) ;
# tout autre sub inconnu suit le parcours ordinaire (JIT ou
# refus selon la surface), JAMAIS l'amorçage ;
# 3. sinon, si provisionner=True : création JIT d'un compte
# 3. rattachement par HOMONYMIE (0.46.10, chantier SSO
# « bruno ») : si un compte local porte EXACTEMENT le nom
# d'utilisateur que cette identité porterait (base dérivée
# des claims, voir _base_nom_draco) et qu'il n'a AUCUN lien
# draco, le sub y est rattaché et c'est CE compte qui est
# servi — avant, le JIT créait un clone suffixé (« bruno-2 »)
# et le propriétaire légitime n'atteignait jamais son compte.
# Fondement : les noms centraux font foi — les comptes de la
# suite sont créés par l'administrateur au Hub, il n'existe
# aucune inscription publique ; un sub de nom DIFFÉRENT
# n'absorbe toujours aucun compte (le #145 reste entier).
# Si l'homonyme est déjà lié à un AUTRE sub : aucun
# rattachement silencieux, aucun clone — résolution à None,
# le pont signale le conflit (draco_conflit_nom) et la
# re-liaison exige la double preuve (voir
# app.main.draco_relier) ;
# 4. sinon, si provisionner=True : création JIT d'un compte
# propre à cette identité (voir provision_draco_user).
#
# Avant la 0.46.5, l'étape 2 liait l'amorçage au PREMIER sub
# valide de passage : sur une instance fraîche, un simple
# utilisateur de la suite devenait l'administrateur local
# (audit « compte partout » du 2026-11-06, carte fusion #145).
#
# Un sub inconnu ne désigne JAMAIS un compte existant non lié
# (ni l'opérateur d'environnement, ni un compte dont le nom
# ressemblerait au nom affiché draco) : la liaison d'un compte
# préexistant est un geste d'administrateur (/admin, voir
# docs/correspondance-draco.md) ou la première visite
# doublement connectée (session native + cookie draco).
def _slug_draco(valeur: str) -> str:
@@ -113,17 +122,28 @@ def _slug_draco(valeur: str) -> str:
return re.sub(r"[^a-z0-9]+", "-", texte).strip("-")[:40].strip("-")
def _base_nom_draco(nom_affiche: str) -> str | None:
"""Base du nom d'utilisateur d'une identité draco : le nom
affiché slugifié (« Alice Exemple » → « alice-exemple »,
« bruno » → « bruno »). None si la base est inexploitable
(< 3 caractères) : aucune homonymie ne peut alors être
établie et le JIT retombe sur son nom de repli."""
base = _slug_draco(nom_affiche)
return base if len(base) >= 3 else None
def _nom_utilisateur_draco(nom_affiche: str, sub: str) -> str:
"""Nom d'utilisateur libre dérivé des claims (jamais réutilisé).
Base : le nom affiché slugifié (« Alice Exemple » →
« alice-exemple ») ; repli « draco-<sub slugifié> ». Si le nom
est déjà pris — y compris par un compte préexistant NON lié,
qui ne doit pas être adopté — un suffixe -2, -3… est ajouté :
le JIT crée toujours un compte nouveau, distinct.
est déjà pris, un suffixe -2, -3… est ajouté : hors le
rattachement par homonymie de resolve_draco_user (compte
homonyme SANS lien), le JIT crée toujours un compte nouveau,
distinct.
"""
base = _slug_draco(nom_affiche)
if len(base) < 3:
base = _base_nom_draco(nom_affiche)
if base is None:
base = _slug_draco(f"draco-{sub}") or "draco"
candidat, n = base, 2
while models.get_user_by_username(candidat) is not None:
@@ -132,6 +152,43 @@ def _nom_utilisateur_draco(nom_affiche: str, sub: str) -> str:
return candidat
def _compte_homonyme(claims: dict | None, sub: str) -> dict | None:
"""Compte local portant le nom d'utilisateur de l'identité
draco présentée (base dérivée des claims), ou None.
C'est la clé du rattachement de l'étape 3 de
resolve_draco_user et du conflit signalé par
draco_conflit_nom : la comparaison porte sur le NOM
D'UTILISATEUR local contre le nom que l'émetteur fait porter
à l'identité — jamais sur un nom d'une autre forme.
"""
base = _base_nom_draco(str((claims or {}).get("name") or ""))
if base is None:
return None
return models.get_user_by_username(base)
def draco_conflit_nom(claims: dict | None) -> dict | None:
"""Compte local homonyme de l'identité présentée mais lié à
un AUTRE sub, ou None.
Distingue, pour le pont, l'échec « ce nom est déjà le compte
d'une autre identité de la suite » (conflit explicite,
re-liaison par double preuve) d'un échec ordinaire : la
résolution refuse alors tout rattachement et tout clone JIT.
"""
sub = str((claims or {}).get("sub") or "")
if not sub:
return None
homonyme = _compte_homonyme(claims, sub)
if homonyme is None:
return None
lie = homonyme.get("draco_sub")
if lie and lie != sub:
return homonyme
return None
def provision_draco_user(sub: str, nom_affiche: str = "") -> dict | None:
"""Création JIT du compte Kanbante d'une identité draco (HUB-16).
@@ -186,11 +243,14 @@ def resolve_draco_user(
provisionner=False : correspondance et amorçage seulement
(surfaces qui ne doivent pas créer de compte, p. ex.
/api/search). provisionner=True : création JIT si aucune
correspondance n'existe (pont /auth/draco — la « première
connexion draco » du critère « un compte fonctionne
partout »). Un compte désactivé résout à None et n'est
jamais contourné par un JIT (la correspondance existe).
/api/search — le rattachement par homonymie, qui ÉCRIT le
lien, n'y a pas lieu). provisionner=True : rattachement par
homonymie si un compte local sans lien porte le nom de
l'identité, sinon création JIT si aucune correspondance
n'existe (pont /auth/draco — la « première connexion
draco » du critère « un compte fonctionne partout »). Un
compte désactivé résout à None et n'est jamais contourné
par un JIT (la correspondance existe).
Adoption de l'amorçage (fusion #145) : ``role_hub`` est le
rôle du sub au registre du Hub pour kanbante, déjà consulté
@@ -222,6 +282,25 @@ def resolve_draco_user(
models.log_admin(seul["id"], "draco.link.amorcage", sub)
return models.get_user(seul["id"])
if provisionner:
# Étape 3 — rattachement par homonymie (0.46.10) : le
# compte local qui porte le nom de cette identité et n'a
# aucun lien draco EST le compte de cette identité (les
# noms centraux sont émis par l'administrateur au Hub,
# sans inscription publique). Un homonyme désactivé
# résout à None, jamais contourné par un clone. Un
# homonyme lié à un autre sub arrête tout : ni
# rattachement silencieux, ni clone JIT — le pont
# signalera le conflit (draco_conflit_nom) et la
# re-liaison passera par la double preuve.
homonyme = _compte_homonyme(claims, sub)
if homonyme is not None:
if homonyme.get("draco_sub"):
return None
if not homonyme["active"]:
return None
models.update_user(homonyme["id"], draco_sub=sub)
models.log_admin(homonyme["id"], "draco.link.nom", sub)
return models.get_user(homonyme["id"])
cree = provision_draco_user(sub, str((claims or {}).get("name") or ""))
if cree is not None and cree["active"]:
return cree