ci(backend): ajoute un scan DAST OWASP ZAP de l'API avec un compte lecteur jetable*

scripts/README.md

@@ -1,3 +1,11 @@
 # Scripts
 
 Outillage local du monorepo. Les taches courantes passent par le `Makefile` racine.
+
+## dast-token.sh
+
+Prépare le scan DAST (`.github/workflows/dast.yml`) : sur une API déjà démarrée, crée un compte
+`lecteur` jetable, lui fait passer le changement de mot de passe obligatoire et écrit son jeton
+d'accès sur la sortie standard. À lancer depuis `apps/backend`, contre une base **jetable** (il y
+crée deux comptes) : `BASE_URL=http://localhost:8000 ../../scripts/dast-token.sh`. Nécessite `curl`,
+`jq` et `openssl`.

scripts/dast-token.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+# Prépare le scan DAST : crée un compte `lecteur` sur une API déjà démarrée, lui fait passer le
+# changement de mot de passe obligatoire, et écrit son jeton d'accès sur la sortie standard.
+#
+# Piège : un compte neuf est en `must_change_password`, et toute route gardée le refuse tant que
+# le mot de passe n'a pas été changé. Sans cette étape, ZAP ne verrait que 403 sur les routes
+# gardées et le scan ne testerait rien de l'API authentifiée.
+#
+# Contrainte : le compte du scan est `lecteur`, jamais `admin`. Un scan actif avec un jeton admin
+# frapperait POST /users ou la réinitialisation de mots de passe pour de bon.
+#
+# L'administrateur n'existe que pour créer ce compte (l'API n'a pas d'inscription publique).
+# À lancer depuis apps/backend, dans un environnement où DATABASE_URL et APP_SECRET_KEY visent
+# une base JETABLE : le script y crée deux comptes.
+
+set -euo pipefail
+
+BASE_URL="${BASE_URL:-http://localhost:8000}"
+API="$BASE_URL/api/v1"
+SUFFIXE="$(openssl rand -hex 4)"
+EMAIL_ADMIN="dast-admin-$SUFFIXE@enervision.fr"
+EMAIL_LECTEUR="dast-lecteur-$SUFFIXE@enervision.fr"
+
+# Classes exigées par le validateur : majuscule, minuscule, chiffre, caractère spécial.
+nouveau_mot_de_passe() { echo "Dast-$(openssl rand -hex 12)-Aa1!"; }
+
+# Tout ce qui n'est pas la sortie finale part sur stderr : la sortie standard ne porte que le jeton.
+journal() { echo "dast-token: $*" >&2; }
+
+connexion() {
+    curl -fsS -X POST "$API/auth/login" -H 'Content-Type: application/json' \
+        -d "$(jq -n --arg e "$1" --arg p "$2" '{email:$e, password:$p}')" | jq -r '.access_token'
+}
+
+changer_mot_de_passe() {
+    local jeton="$1" ancien="$2" nouveau="$3"
+    curl -fsS -o /dev/null -X POST "$API/auth/password" \
+        -H "Authorization: Bearer $jeton" -H 'Content-Type: application/json' \
+        -d "$(jq -n --arg a "$ancien" --arg n "$nouveau" '{current_password:$a, new_password:$n}')"
+}
+
+journal "création de l'administrateur $EMAIL_ADMIN"
+SORTIE="$(uv run python -m app.cli create-admin --email "$EMAIL_ADMIN" --generate)"
+MDP_ADMIN="$(sed -n 's/^Mot de passe généré, il ne sera plus affiché : //p' <<<"$SORTIE")"
+[[ -n "$MDP_ADMIN" ]] || { journal "mot de passe administrateur introuvable dans la sortie"; exit 1; }
+
+JETON="$(connexion "$EMAIL_ADMIN" "$MDP_ADMIN")"
+NOUVEAU_ADMIN="$(nouveau_mot_de_passe)"
+changer_mot_de_passe "$JETON" "$MDP_ADMIN" "$NOUVEAU_ADMIN"
+# Le changement de mot de passe ferme les sessions : le jeton précédent ne vaut plus rien.
+JETON="$(connexion "$EMAIL_ADMIN" "$NOUVEAU_ADMIN")"
+
+journal "création du lecteur $EMAIL_LECTEUR"
+REPONSE="$(curl -fsS -X POST "$API/users" -H "Authorization: Bearer $JETON" \
+    -H 'Content-Type: application/json' \
+    -d "$(jq -n --arg e "$EMAIL_LECTEUR" '{email:$e, role:"lecteur"}')")"
+MDP_TEMPORAIRE="$(jq -r '.temporary_password' <<<"$REPONSE")"
+
+JETON="$(connexion "$EMAIL_LECTEUR" "$MDP_TEMPORAIRE")"
+NOUVEAU_LECTEUR="$(nouveau_mot_de_passe)"
+changer_mot_de_passe "$JETON" "$MDP_TEMPORAIRE" "$NOUVEAU_LECTEUR"
+JETON="$(connexion "$EMAIL_LECTEUR" "$NOUVEAU_LECTEUR")"
+
+# Vérifie que le jeton ouvre bien une route gardée avant de le rendre.
+CODE="$(curl -sS -o /dev/null -w '%{http_code}' "$API/sites" -H "Authorization: Bearer $JETON")"
+[[ "$CODE" == "200" ]] || { journal "GET /sites répond $CODE avec le jeton du lecteur, attendu 200"; exit 1; }
+
+journal "jeton du lecteur prêt"
+echo "$JETON"