Repository navigation
fix(sécurité): correctifs audit — authz export EDT, injection CSV, upload filigrane - #344
Merged
Merged
Conversation
Assistant d'installation style WordPress, calqué sur le design de la page de connexion (hero + DalibiLogo). Quatre étapes visibles : langue, école, administrateur, protocole de sécurité, puis écran d'exécution. Cette phase couvre l'ossature et l'UI ; l'exécution réelle (migrations, seed, création école/admin, pose du verrou) arrive en Phase 2 — l'écran 'running' est pour l'instant un espace réservé. - InstallState : source de vérité (verrou storage/app/installed.json + auto-cicatrisation si la base contient déjà des utilisateurs) - RequirementsChecker : contrôle PHP/extensions/droits/APP_KEY sans base - EnsureAppInstalled / EnsureAppNotInstalled : redirection vers/hors l'assistant, priorisé avant l'authentification - Session forcée en driver 'file' avant installation (pas de base requise) - Écrans Inertia : welcome, school, admin, security, running, requirements - i18n FR/EN, tests fonctionnels (8) ; TestCase considère l'app installée
Branche l'orchestration réelle derrière l'écran de progression : à l'affichage, le front déclenche POST /install/execute qui exécute le service Installer puis redirige vers la connexion. Service App\Support\Install\Installer : - migrate --force (idempotent) - création de l'école (avant le seed, pour les en-têtes/bulletins par défaut) - db:seed ReferenceDataSeeder (rôles & permissions, catalogues) — rejouable - découpage des périodes (trimestre/semestre) appliqué aux types de classe - année scolaire active - administrateur + rôle « administrateur » + matricule (sans changement de mot de passe imposé : il vient de le choisir) - réglages de sécurité best-effort sur .env (APP_DEBUG, APP_URL en HTTPS), jamais sous tests ; choix consignés dans le verrou - pose du verrou storage/app/installed.json Chaque étape est idempotente (firstOrCreate/firstOrNew) : une reprise après échec ne crée pas de doublon. En cas d'erreur, l'écran propose de relancer. Tests : 2 nouveaux cas (garde-fou session, installation complète + verrou), nettoyage du verrou en tearDown. Suite complète verte (515).
…durcissement sécurité
Affinements de l'assistant d'installation après la Phase 2.
Étapes
- Ordre revu : Langue → Administrateur → Sécurité → École (l'école clôt et
déclenche l'installation). Stepper, redirections et liens « Retour » alignés.
- Le choix de la langue bascule désormais toute l'interface : l'étape écrit
session('locale') (lue par SetLocale), les étapes suivantes suivent.
École & propriétaire
- Formulaire école calqué sur le modèle School (niveau, code, devise,
directeur, email, téléphone, adresse, ville, région, description) ; la devise
est un sélecteur alimenté par la constante Currencies (validation sur les codes).
- Suivi du propriétaire : migration owner_id (FK users, nullOnDelete),
relation School::owner(), renseigné par l'Installer (= administrateur créé).
Sécurité (suite audit)
- H1 : le mot de passe de l'administrateur applique la politique de l'app
(trait PasswordValidationRules → Password::default()).
- H2 : réglages honnêtes. 2FA retirée (non imposée, laissée au choix de chaque
utilisateur) ; force_https réellement effectif via FORCE_HTTPS lu par
AppServiceProvider (hors local) ; app_debug_off inchangé.
Tests : nouvel ordre, propagation de langue, owner, champs modèle, politique mdp.
Suite complète verte (516). PHPStan 0, Pint, tsc, ESLint, build OK.
… de vérité) M2 — plus de mot de passe en clair pendant l'assistant : - l'étape admin chiffre le mot de passe en session (Crypt::encryptString, APP_KEY) ; le payload de session fichier ne contient plus de secret exploitable au repos. - execute le déchiffre juste avant de créer le compte ; une session altérée (déchiffrement impossible) renvoie à l'étape admin sans rien installer. - stockage final inchangé : base de données, mot de passe haché, session purgée. M3 — la base de données fait foi, le fichier-verrou n'est qu'un cache : - InstallState::isInstalled() regarde d'abord la base (présence d'un utilisateur), puis se rabat sur installed.json uniquement si la base est injoignable. - un verrou périmé sur une base vide ne bloque plus une réinstallation légitime. - sonde allégée : une requête exists indexée, mémoïsée, sans Schema::hasTable. Tests : installation avec mot de passe chiffré + Hash::check, session altérée rejetée. Suite complète verte (517). PHPStan 0, Pint OK.
L1 — logs : en cas d'échec d'installation, journaliser le type et l'emplacement de l'exception, mais masquer le message d'une QueryException (il contient le SQL et ses bindings, dont l'email). L2 — écran prérequis : ne plus afficher la version exacte de PHP lorsque le prérequis passe (empreinte système) ; visible uniquement en cas d'échec. L3 — throttling : limiter toutes les étapes de l'assistant (throttle:30,1) en plus de la limite stricte propre à l'exécution (throttle:6,1). L4 — cache de config : après écriture du .env (APP_DEBUG, FORCE_HTTPS…), appeler config:clear pour que les nouvelles valeurs soient lues au prochain boot (no-op sans cache ; jamais exécuté sous tests). Suite complète verte (517). PHPStan 0, Pint OK.
Le throttle des routes d'installation (ajouté en L3) s'appuie sur le store de cache. Avec CACHE_STORE=database, la table cache n'existe pas avant les migrations : l'affichage de l'assistant levait une QueryException (relation « cache » inexistante), comme le faisait la session. AppServiceProvider bascule désormais session ET cache sur le pilote file tant que l'application n'est pas installée (useFileStoresBeforeInstall). Après migration, les stores database reprennent normalement. Vérifié en live : GET /install répond 200 (plus de QueryException). 12 tests install verts, PHPStan 0, Pint OK.
Étape « École » de l'assistant :
- Select pays (liste ISO via App\Constants\Countries, source unique du
CountrySeeder) + colonne schools.country (défaut TG).
- Niveaux multiples : cases à cocher rattachées comme types de classe
(School::classTypes) ; l'enum level garde le cycle principal.
- Champ devise/slogan distinct de la monnaie (currency), relibellé « Monnaie ».
- Champs groupés par logique (identité/contact/localisation/pédagogie), sans
card ; cartes de niveaux de dimension uniforme.
Autres :
- Messages d'erreur de formulaire traduits : lang/{fr,en}/validation.php
(bloc password + attributs lisibles).
- admin/school : nettoyage des erreurs à la saisie (clearErrors) — fin de
l'erreur « figée » sur la confirmation de mot de passe.
- Suppression du seeder obsolète DemoSeeder (non référencé).
- Documentation : README (section assistant web), page dédiée
installation-web.md, index de doc, CHANGELOG.
Tests : InstallWizardTest (pays, multi-niveaux, devise, garde-fous
config/seeder) ; PHPStan, Pint, ESLint OK.
…oad filigrane) - F1: gate la route timetable.export avec can:view_timetable (alignée sur ses voisines) — l'export PDF d'emploi du temps n'était soumis à aucune permission et classId n'est pas scopé (lecture cross-école). - F2: neutralise l'injection de formule CSV dans SituationController::export (helper csvCell) — matricule/nom/prénom/classe/n° facture sont préfixés d'une apostrophe s'ils commencent par = + - @ \t \r. - NV1: restreint l'upload du filigrane (watermark_image) à mimes jpg,jpeg,png,webp comme le logo, pour écarter le SVG sur le disque public media (XSS stocké).
…F2, NV1) - F1: TimetableTest::export_forbidden_without_view_timetable_permission (Comptabilité → 403 sur timetable.export). - F2: SituationExportTest — préfixage des cellules dangereuses (=/@) dans l'export CSV, non-altération des valeurs normales, et 403 sans view_finances. - NV1: DocumentHeaderTest — rejet d'un filigrane SVG, acceptation d'un PNG.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Contexte
Correctifs issus d'un audit de sécurité (run partiel) de l'application. Trois points avec leurs tests de régression.
Correctifs
F1 — Export d'emploi du temps sans autorisation (Medium)
routes/web.php— la routetimetable.exportn'avait aucune permission (classIdnon scopé → lecture d'emploi du temps de n'importe quelle classe, cross-école). Ajout de->middleware('can:view_timetable'), aligné sur ses routes voisines.F2 — Injection de formule CSV (Medium)
SituationController::exportécrivait matricule/nom/prénom/classe/n° facture bruts viafputcsv. Un nom d'élève commençant par= + - @s'exécutait comme formule chez la victime (Compta/Direction) à l'ouverture du fichier. Nouveau helpercsvCell()qui préfixe ces cellules d'une apostrophe.NV1 — Upload de filigrane sans allowlist MIME (préventif)
DocumentHeaderController::update—watermark_imagepassait deimageàimage+mimes:jpg,jpeg,png,webp(comme le logo), pour écarter un SVG (XSS stocké) sur le disque publicmedia.Tests de régression
6 tests ajoutés (suite complète : 23 passent, 57 assertions) :
TimetableTest: Comptabilité → 403 surtimetable.export.SituationExportTest(nouveau) : préfixage des cellules dangereuses, non-altération des valeurs normales, 403 sansview_finances.DocumentHeaderTest: rejet du filigrane SVG, acceptation du PNG.Portée
Aucune modification de comportement fonctionnel pour les utilisateurs autorisés. Changements limités à une route, un contrôleur d'export, une règle de validation et les tests.