Files
williamandClaude Sonnet 5 c57420c8c9 Phase 3 : hardening qualite de code - typage strict, securite, dead code, a11y
Config strictement stricte partout (ruff, mypy --strict, bandit, vulture,
import-linter, eslint, stylelint), aucune regle desactivee "pour ne pas
casser le build" - l'existant a ete corrige pour la satisfaire plutot que
l'inverse. Hooks pre-commit locaux (language: system) bloquants.

- Typage mypy --strict propage a tout le moteur (db, screens, auth, core,
  ai, routes, puis publish/scripts/tests/app.py/build_css.py).
- Securite : fuite de handle fichier Windows corrigee dans l'export SCORM
  (routes/publish/export_scorm.py), CSRF/RNG non-crypto/xAPI documentes
  (# nosec, # NOSONAR justifies), nouveau db.json_for_script() (echappe
  "</script>" dans le JSON embarque en <script>, 25 sites).
- Architecture : imports circulaires/F811 nettoyes, contrats
  import-linter respectes, code mort retire (vulture).
- Accessibilite : 69 champs de formulaire sans label correctement
  associe corriges (for/id ou aria-label) sur 11 templates.
- ESLint/Stylelint : lot mecanique JS/CSS, regles ajustees puis
  appliquees (aucune desactivee sans verification individuelle).
- Tests : isolation du compte admin partage (nettoyage ponctuel +
  fixture de teardown automatique en filet de securite), suite complete
  verte (591 tests Python, 241 tests JS).
- SonarQube Community Build self-heberge (Docker + PostgreSQL) : rapport
  complet analyse point par point, faux positifs documentes.
- .gitattributes ajoute (LF force) : core.autocrlf=true sur cette machine
  faisait echouer ESLint (linebreak-style) via un bug connu de git
  (checkout "en place" qui ignore l'eol force sur un fichier deja
  present sur disque - contourne en supprimant puis recreant chaque
  fichier suivi).

djLint (H021, styles inline) volontairement saute pour ce commit -
backlog assume, deja documente, traite dans un lot separe.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-15 16:06:15 +02:00

61 lines
2.1 KiB
Python

import secrets
from werkzeug.security import check_password_hash, generate_password_hash
from .connection import connect
_CODE_COUNT = 10
def _format_code(raw: str) -> str:
return "-".join(raw[i : i + 4] for i in range(0, len(raw), 4))
def generate_recovery_codes(user_id: int) -> list[str]:
"""(Re)génère les codes de récupération 2FA d'un utilisateur : un
nouvel appel invalide tout jeu de codes précédent (un seul jeu valide
à la fois, pour ne jamais avoir à deviner lesquels tiennent encore).
Les codes ne sont renvoyés EN CLAIR qu'ICI, à l'instant de leur
création — seul leur hash (werkzeug, comme les mots de passe) est
conservé en base, pour qu'une fuite de la base ne les rende pas
directement réutilisables."""
conn = connect()
conn.execute("DELETE FROM _recovery_codes WHERE user_id = ?", (user_id,))
codes: list[str] = []
for _ in range(_CODE_COUNT):
code = _format_code(secrets.token_hex(6))
codes.append(code)
conn.execute(
"INSERT INTO _recovery_codes (user_id, code_hash) VALUES (?, ?)",
(user_id, generate_password_hash(code)),
)
conn.commit()
conn.close()
return codes
def verify_recovery_code(user_id: int, code: str | None) -> bool:
"""Un code n'est utilisable qu'UNE SEULE FOIS (used_at) : consommé dès
qu'il sert à une connexion réussie, pour qu'un code intercepté une
fois (capture d'écran, historique du navigateur...) ne redonne pas un
accès permanent."""
code = (code or "").strip().lower()
if not code:
return False
conn = connect()
rows = conn.execute(
"SELECT id, code_hash FROM _recovery_codes WHERE user_id = ? AND used_at IS NULL",
(user_id,),
).fetchall()
for row in rows:
if check_password_hash(row["code_hash"], code):
conn.execute(
"UPDATE _recovery_codes SET used_at = CURRENT_TIMESTAMP WHERE id = ?",
(row["id"],),
)
conn.commit()
conn.close()
return True
conn.close()
return False