ajoute le dossier WebDAV de l'élève (bloc C)
Dossier personnel de l'élève monté comme lecteur réseau : rclone sert le dossier local, l'authentification est déléguée au portail via auth_request Nginx (mêmes identifiants que la connexion), sans nouveau système de comptes. Nettoyé par la purge RGPD comme les autres données d'élève. Corrige au passage un vrai bug d'isolation trouvé en testant avec deux comptes jetables : rewrite injectait la variable posée par auth_request_set, mais rewrite s'exécute dans une phase Nginx antérieure à cette variable, donc toujours vide - un élève pouvait lire le fichier d'un autre en devinant son nom. Corrigé par une location à regex nommée + proxy_pass. Détails : ADR 0008. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
parent
cdf79d2823
commit
e549f03e1b
19 changed files with 553 additions and 8 deletions
|
|
@ -24,3 +24,5 @@ portail_port_visio: 8090
|
|||
# routeur par nom (stream Nginx) l'envoie directement à coturn.
|
||||
portail_domaine_turn: turn.syllabuslab.fr
|
||||
portail_port_turn_tls: 5349
|
||||
# Bloc C : dossier de l'élève en WebDAV (rclone, local pour l'instant).
|
||||
portail_port_webdav: 8765
|
||||
|
|
|
|||
|
|
@ -14,3 +14,9 @@
|
|||
name: portail-horizon
|
||||
state: restarted
|
||||
enabled: true
|
||||
|
||||
- name: redémarrer rclone-webdav
|
||||
ansible.builtin.systemd:
|
||||
name: rclone-webdav
|
||||
state: restarted
|
||||
enabled: true
|
||||
|
|
|
|||
35
ansible/roles/portail/tasks/09-webdav.yml
Normal file
35
ansible/roles/portail/tasks/09-webdav.yml
Normal file
|
|
@ -0,0 +1,35 @@
|
|||
---
|
||||
# Bloc C (CLAUDE.md) : dossier de l'élève monté comme lecteur réseau WebDAV.
|
||||
# rclone sert un dossier local en WebDAV (bascule vers un backend S3
|
||||
# possible plus tard sans changer l'architecture : rclone sait servir les
|
||||
# deux). Nginx fait l'authentification (déléguée au portail, mêmes
|
||||
# identifiants que la connexion) et restreint chaque élève à son seul
|
||||
# sous-dossier avant de relayer vers rclone — voir 05-nginx.yml et
|
||||
# App\Http\Controllers\WebdavAuthController.
|
||||
- name: installer rclone
|
||||
ansible.builtin.apt:
|
||||
name: rclone
|
||||
state: present
|
||||
|
||||
- name: créer le dossier racine du WebDAV des élèves
|
||||
ansible.builtin.file:
|
||||
path: "{{ portail_dossier_app }}/storage/app/webdav"
|
||||
state: directory
|
||||
owner: www-data
|
||||
group: www-data
|
||||
mode: "0750"
|
||||
|
||||
- name: déployer le service systemd de rclone (WebDAV)
|
||||
ansible.builtin.template:
|
||||
src: rclone-webdav.service.j2
|
||||
dest: /etc/systemd/system/rclone-webdav.service
|
||||
mode: "0644"
|
||||
notify:
|
||||
- recharger systemd
|
||||
- redémarrer rclone-webdav
|
||||
|
||||
- name: activer et démarrer rclone (WebDAV)
|
||||
ansible.builtin.systemd:
|
||||
name: rclone-webdav
|
||||
state: started
|
||||
enabled: true
|
||||
|
|
@ -14,6 +14,9 @@
|
|||
- name: banque de quiz officielle (contenu éditorial de paillasse-contenus/)
|
||||
ansible.builtin.import_tasks: 08-banque-quiz.yml
|
||||
|
||||
- name: dossier de l'élève en WebDAV (bloc C)
|
||||
ansible.builtin.import_tasks: 09-webdav.yml
|
||||
|
||||
- name: Nginx
|
||||
ansible.builtin.import_tasks: 05-nginx.yml
|
||||
|
||||
|
|
|
|||
|
|
@ -39,6 +39,47 @@
|
|||
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
|
||||
}
|
||||
|
||||
# Bloc C : dossier de l'élève en WebDAV (rclone en local, voir
|
||||
# 09-webdav.yml). "internal" : jamais appelable depuis l'extérieur,
|
||||
# seulement par la sous-requête auth_request ci-dessous.
|
||||
# $request_uri d'une sous-requête auth_request reflète la requête
|
||||
# d'origine ("/webdav/…", pas "/interne/webdav-auth") : constaté le
|
||||
# 2026-10-14 (404 systématique côté Laravel, qui routait donc sur le
|
||||
# mauvais chemin). D'où REQUEST_URI écrit en dur ci-dessous — l'URI de
|
||||
# cette location est fixe, il n'y a rien d'autre qu'elle ne pourrait
|
||||
# valoir.
|
||||
location = /interne/webdav-auth {
|
||||
internal;
|
||||
fastcgi_pass unix:/run/php/php{{ portail_php_version }}-fpm.sock;
|
||||
fastcgi_index index.php;
|
||||
include fastcgi_params;
|
||||
fastcgi_param SCRIPT_FILENAME {{ portail_dossier_app }}/public/index.php;
|
||||
fastcgi_param SCRIPT_NAME /index.php;
|
||||
fastcgi_param REQUEST_URI /interne/webdav-auth;
|
||||
fastcgi_param REQUEST_METHOD GET;
|
||||
}
|
||||
|
||||
# "rewrite" s'exécute dans une phase antérieure à auth_request_set (le
|
||||
# rewrite verrait donc toujours $eleve_dossier vide, et chaque élève
|
||||
# atterrirait à la racine commune du dossier — constaté le 2026-10-14,
|
||||
# un élève pouvait lire les fichiers d'un autre). proxy_pass avec le nom
|
||||
# capturé par la regex de la location, lui, est évalué après coup.
|
||||
location ~ ^/webdav/(?<chemin_webdav>.*)$ {
|
||||
auth_request /interne/webdav-auth;
|
||||
auth_request_set $eleve_dossier $upstream_http_x_eleve_dossier;
|
||||
error_page 401 = @webdav_non_authentifie;
|
||||
client_max_body_size 100m;
|
||||
proxy_pass http://127.0.0.1:{{ portail_port_webdav }}/$eleve_dossier/$chemin_webdav;
|
||||
proxy_http_version 1.1;
|
||||
}
|
||||
|
||||
# Sans cela, un explorateur de fichiers (Windows/macOS) ne propose
|
||||
# jamais de ressaisir les identifiants après un échec.
|
||||
location @webdav_non_authentifie {
|
||||
add_header WWW-Authenticate 'Basic realm="Syllabus WebDAV"' always;
|
||||
return 401;
|
||||
}
|
||||
|
||||
location ~ /\.(?!well-known) {
|
||||
deny all;
|
||||
}
|
||||
|
|
|
|||
27
ansible/roles/portail/templates/rclone-webdav.service.j2
Normal file
27
ansible/roles/portail/templates/rclone-webdav.service.j2
Normal file
|
|
@ -0,0 +1,27 @@
|
|||
# Géré par Ansible (rôle portail) — ne pas modifier à la main.
|
||||
# Bloc C (CLAUDE.md) : dossier de l'élève monté comme lecteur réseau.
|
||||
# N'écoute qu'en local (127.0.0.1) : Nginx authentifie (délégué au portail)
|
||||
# et restreint chaque élève à son sous-dossier avant de relayer ici — voir
|
||||
# ansible/roles/portail/templates/nginx-portail.conf.j2 et
|
||||
# App\Http\Controllers\WebdavAuthController.
|
||||
[Unit]
|
||||
Description=Serveur WebDAV (rclone) pour le dossier des élèves — Syllabus
|
||||
After=network.target
|
||||
|
||||
[Service]
|
||||
Type=simple
|
||||
User=www-data
|
||||
Group=www-data
|
||||
# --dir-cache-time : sans ça, les dossiers créés par Laravel (un par élève,
|
||||
# en dehors de rclone) restent invisibles jusqu'à 5 minutes (la valeur par
|
||||
# défaut) — constaté le 2026-10-14, un nouveau dossier élève répondait 404
|
||||
# tant que rclone ne l'avait pas découvert lui-même.
|
||||
ExecStart=/usr/bin/rclone serve webdav {{ portail_dossier_app }}/storage/app/webdav --addr 127.0.0.1:{{ portail_port_webdav }} --no-modtime --vfs-cache-mode off --dir-cache-time 1s
|
||||
Restart=on-failure
|
||||
RestartSec=5
|
||||
NoNewPrivileges=true
|
||||
ProtectSystem=strict
|
||||
ReadWritePaths={{ portail_dossier_app }}/storage/app/webdav
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
82
docs/adr/0008-webdav-eleve-auth-request.md
Normal file
82
docs/adr/0008-webdav-eleve-auth-request.md
Normal file
|
|
@ -0,0 +1,82 @@
|
|||
# ADR 0008 — WebDAV de l'élève : authentification déléguée (Nginx auth_request) + rclone
|
||||
|
||||
- **Date** : 2026-10-14
|
||||
- **Statut** : accepté
|
||||
|
||||
## Contexte
|
||||
|
||||
Bloc C du CLAUDE.md : « dossier de l'élève montable comme lecteur réseau. »
|
||||
Besoin : chaque élève a un dossier personnel, accessible en WebDAV (Windows/
|
||||
macOS/Linux savent tous monter un lecteur réseau WebDAV nativement), avec les
|
||||
mêmes identifiants que la connexion, et **jamais** accès au dossier d'un
|
||||
autre élève.
|
||||
|
||||
## Décisions
|
||||
|
||||
**`rclone serve webdav`, pas un module WebDAV Nginx/Apache.** rclone sait
|
||||
servir aussi bien un dossier local qu'un bucket S3 avec la même commande —
|
||||
bascule possible plus tard vers Hetzner Object Storage sans rien changer à
|
||||
l'architecture d'authentification. Empreinte mémoire très faible (~20 Mo).
|
||||
|
||||
**Authentification déléguée au portail via `auth_request` (Nginx), pas une
|
||||
authentification propre à rclone.** rclone n'a pas de notion de comptes
|
||||
multiples ; Nginx vérifie les identifiants auprès du portail (même logique
|
||||
que la connexion, `Auth::guard('eleve')->once(...)`) via une sous-requête
|
||||
interne (`WebdavAuthController`), puis limite la suite de la requête au seul
|
||||
sous-dossier de l'élève authentifié.
|
||||
|
||||
**Un seul process rclone pour tous les élèves, pas un par élève.** Chaque
|
||||
sous-dossier (`storage/app/webdav/<id élève>/`) est injecté dans le chemin
|
||||
transmis à rclone via `proxy_pass http://127.0.0.1:.../$eleve_dossier/$chemin`
|
||||
— $eleve_dossier vient de l'en-tête `X-Eleve-Dossier` posé par
|
||||
`WebdavAuthController` après vérification des identifiants.
|
||||
|
||||
## Deux bugs trouvés en vérifiant en réel (pas en local, Nginx n'a pas de test unitaire)
|
||||
|
||||
**1. `rewrite` ne voit jamais la variable posée par `auth_request_set`.**
|
||||
Nginx exécute les directives `rewrite` dans la phase *rewrite*, qui a lieu
|
||||
**avant** la phase *access* où tourne `auth_request`/`auth_request_set` —
|
||||
même écrites après dans le fichier, textuellement. Une première version
|
||||
utilisait `rewrite ^/webdav/(.*)$ /$eleve_dossier/$1 break;` : `$eleve_dossier`
|
||||
y était toujours vide, donc tous les fichiers de tous les élèves atterrissaient
|
||||
à la racine commune du dossier WebDAV — **un élève pouvait lire le fichier
|
||||
d'un autre simplement en devinant son nom.** Jamais vu en local (pas de test
|
||||
automatisé qui exerce une vraie pile Nginx+rclone) : découvert en testant
|
||||
avec deux comptes élèves jetables en vrai sur le serveur.
|
||||
Corrigé : une `location` avec une regex à groupe nommé
|
||||
(`location ~ ^/webdav/(?<chemin_webdav>.*)$`) et `proxy_pass` avec la
|
||||
variable directement dans l'URL — `proxy_pass` construit sa requête dans une
|
||||
phase plus tardive, où `$eleve_dossier` est déjà posée.
|
||||
|
||||
**2. Le cache de répertoires de rclone (`--dir-cache-time`, 5 min par
|
||||
défaut) ne voit pas les dossiers créés par Laravel.** Chaque dossier élève
|
||||
est créé par PHP (`Storage::disk('webdav')->makeDirectory(...)`), en dehors
|
||||
de rclone — qui le découvre seulement à la prochaine actualisation de son
|
||||
cache de liste. Un élève dont le dossier venait d'être créé pouvait recevoir
|
||||
une 404 pendant plusieurs minutes. Corrigé par `--dir-cache-time 1s` dans le
|
||||
service systemd (`infra`/`ansible/roles/portail/templates/rclone-webdav.service.j2`).
|
||||
`--vfs-cache-mode off` (déjà en place, pour ne jamais garder de contenu de
|
||||
fichier en cache) ne couvre pas ce cache de répertoires : deux réglages
|
||||
distincts.
|
||||
|
||||
**3. `SCRIPT_NAME`/`REQUEST_URI` ne sont pas fiables dans une sous-requête
|
||||
`auth_request` quand on construit son propre appel FastCGI.** `$request_uri`
|
||||
dans la sous-requête reflétait la requête d'origine (`/webdav/…`), pas l'URI
|
||||
de la sous-requête elle-même (`/interne/webdav-auth`) : Laravel routait donc
|
||||
sur le mauvais chemin et répondait 404 à chaque appel. Comme cette location
|
||||
a une URI toujours identique (`= /interne/webdav-auth`), la solution a été
|
||||
d'écrire `SCRIPT_FILENAME`, `SCRIPT_NAME` et `REQUEST_URI` en dur dans les
|
||||
paramètres FastCGI plutôt que de les déduire de variables Nginx.
|
||||
|
||||
## Conséquences
|
||||
|
||||
- Testé en réel avec trois comptes élèves jetables : upload, lecture,
|
||||
PROPFIND, isolation stricte entre élèves (un 404 propre, jamais le
|
||||
contenu d'un autre), dossier d'un nouvel élève utilisable immédiatement.
|
||||
Comptes et fichiers de test supprimés ensuite.
|
||||
- Cette classe de bug (interaction entre phases Nginx, cache rclone) n'est
|
||||
détectable qu'en testant la vraie pile déployée — aucun test Pest ne
|
||||
l'aurait vue, puisque les tests appellent le contrôleur Laravel
|
||||
directement, sans passer par Nginx ni rclone.
|
||||
- Reste en dette : pas de quota de stockage par élève, dossier local
|
||||
seulement (pas encore sur Hetzner Object Storage).
|
||||
|
|
@ -39,3 +39,4 @@ retirer la ligne (et le noter dans le journal) quand c'est fait.
|
|||
| **Serveur réel : 31 Go de RAM et 230 Go RAID 1, pas 64 Go / 2×500 Go comme écrit dans le CLAUDE.md (section 3)** | Constaté en vérifiant l'état réel avant la démo Ceph (`free -h`, `lsblk`). Change la vraie marge de capacité (hot pool + OpenStack + portail + tout chantier futur) : à corriger dans le CLAUDE.md, ou à traiter avec une vraie mise à niveau matérielle si le pilote (semaine 8) montre que ça manque. | Avant le pilote si la capacité manque | 2026-10-14 |
|
||||
| Ceph : démo mono-serveur seulement (1 OSD sur fichier épars, pas de réplication, pas branché à Cinder/Glance) | `ceph_pool_default_size=1` et un seul OSD acceptés uniquement parce que c'est une démo de compréhension, sans donnée réelle. Le vrai cluster (plusieurs OSD, réplication, intégré à Cinder) attend le 2ᵉ serveur du CLAUDE.md. Voir [ADR 0007](adr/0007-ceph-demo-mono-serveur.md). | 2ᵉ serveur (bloc C) | 2026-10-14 |
|
||||
| Ceph : bootstrap fait à la main, pas encore rejouable par Ansible | Comme Kolla à l'étape 2 : acceptable pour une démo, à automatiser si ce cluster doit durer. Le fichier systemd du loop device est suivi dans `infra/ceph/` mais déployé à la main. | Si la démo devient durable | 2026-10-14 |
|
||||
| WebDAV de l'élève : stockage local, pas S3 ; pas de quota par élève | Dossier local (`storage/app/webdav/`), partage le disque serré avec OpenStack et le portail — pas de limite de taille par élève. rclone sait servir un backend S3 sans changement d'architecture (voir [ADR 0008](adr/0008-webdav-eleve-auth-request.md)) : à basculer en même temps que le bucket S3 des devoirs (`docs/runbooks/stockage-s3.md`), et à ajouter un quota si l'usage réel le demande. | Quand le bucket S3 existe / si l'usage le demande | 2026-10-14 |
|
||||
|
|
|
|||
|
|
@ -1199,3 +1199,55 @@ Deux leçons distinctes : d'abord, ne jamais faire confiance à la documentation
|
|||
**Suite**
|
||||
|
||||
Prochain chantier du bloc C, annoncé par Adam : WebDAV, puis ElasticSearch.
|
||||
|
||||
## 2026-10-14 — WebDAV de l'élève (bloc C)
|
||||
|
||||
Deuxième chantier du bloc C : dossier personnel de l'élève, monté comme
|
||||
lecteur réseau. Deux bugs réels trouvés et corrigés en vérifiant en vrai sur
|
||||
le serveur, détaillés dans [ADR 0008](adr/0008-webdav-eleve-auth-request.md).
|
||||
|
||||
**Fait**
|
||||
|
||||
- `rclone serve webdav` (20 Mo de RAM) sert le dossier local de chaque élève (`storage/app/webdav/<id>/`), accessible en `https://syllabuslab.fr/webdav/` avec les identifiants de connexion habituels.
|
||||
- L'authentification est déléguée au portail via `auth_request` de Nginx (`WebdavAuthController`, sous-requête interne, jamais appelable depuis l'extérieur) — pas de nouveau système de comptes.
|
||||
- Page « Mes fichiers » (menu du compte, élève seulement) : explique comment monter le lecteur sous Windows/macOS/Linux.
|
||||
- Dossier WebDAV de l'élève supprimé automatiquement lors de la purge RGPD d'une classe archivée (comme pour le stockage S3 des devoirs).
|
||||
|
||||
**Bug grave trouvé en testant en réel (pas en local)**
|
||||
|
||||
Première version : un `rewrite` injectait le sous-dossier de l'élève
|
||||
(posé par `auth_request_set` après vérification des identifiants) dans le
|
||||
chemin transmis à rclone. Testé avec deux comptes élèves jetables : le
|
||||
fichier déposé par le premier atterrissait à la racine du dossier WebDAV
|
||||
commun, et **le second élève pouvait le lire en devinant juste son nom** —
|
||||
un élève aurait pu accéder aux fichiers d'un autre. Cause : `rewrite`
|
||||
s'exécute dans une phase Nginx antérieure à celle où `auth_request_set` pose
|
||||
sa variable, qui était donc toujours vide au moment du `rewrite`, même
|
||||
écrite après dans le fichier. Corrigé avec une `location` à regex nommée et
|
||||
`proxy_pass` construisant l'URL directement (phase plus tardive, la
|
||||
variable y est déjà posée) — revérifié avec trois comptes élèves jetables,
|
||||
isolation stricte confirmée (404 propre, jamais le contenu d'un autre),
|
||||
comptes supprimés ensuite.
|
||||
|
||||
Deuxième bug, plus bénin : le cache de répertoires de rclone (distinct du
|
||||
cache de contenu de fichier, déjà désactivé) ne voyait pas un dossier élève
|
||||
tout juste créé par Laravel — 404 pendant que le cache n'avait pas encore
|
||||
rafraîchi sa liste. Corrigé en réduisant ce cache à 1 seconde (volume
|
||||
d'élèves trop faible pour que ça coûte quoi que ce soit).
|
||||
|
||||
**Comprendre**
|
||||
|
||||
Aucun test Pest n'aurait pu voir ni l'un ni l'autre bug : les tests
|
||||
appellent `WebdavAuthController` directement, sans jamais passer par Nginx
|
||||
ni par rclone — la pile complète (Nginx → auth_request → PHP-FPM → rclone →
|
||||
disque) n'existe qu'en production. Pour ce genre de chantier (plusieurs
|
||||
briques d'infra qui communiquent entre elles), la vérification en réel avec
|
||||
de vraies requêtes HTTP sur deux comptes différents n'est pas une étape de
|
||||
confort après coup : c'est la seule façon de voir ce bug-là. La leçon
|
||||
« rewrite s'exécute avant auth_request_set » est aussi le genre de piège
|
||||
d'ordre des phases Nginx qui ne saute pas aux yeux en relisant le fichier
|
||||
de haut en bas — une bonne question à savoir expliquer en entretien SRE.
|
||||
|
||||
**Suite**
|
||||
|
||||
Prochain chantier du bloc C : ElasticSearch.
|
||||
|
|
|
|||
67
docs/runbooks/webdav.md
Normal file
67
docs/runbooks/webdav.md
Normal file
|
|
@ -0,0 +1,67 @@
|
|||
# Runbook — WebDAV de l'élève
|
||||
|
||||
Dossier personnel de l'élève, monté comme lecteur réseau (bloc C du
|
||||
CLAUDE.md). Détail des choix et des bugs trouvés en vérifiant en réel :
|
||||
[ADR 0008](../adr/0008-webdav-eleve-auth-request.md).
|
||||
|
||||
## Où sont les choses
|
||||
|
||||
| Élément | Emplacement |
|
||||
|---|---|
|
||||
| Fichiers des élèves | `/var/www/portail/storage/app/webdav/<id élève>/` (jamais versionné, jamais synchronisé par un déploiement) |
|
||||
| Service WebDAV | `rclone-webdav.service` (systemd), écoute en local seulement sur `127.0.0.1:8765` |
|
||||
| Authentification | `App\Http\Controllers\WebdavAuthController`, sous-requête Nginx `/interne/webdav-auth` (jamais appelable de l'extérieur) |
|
||||
| Config Nginx | bloc `/webdav/` dans `ansible/roles/portail/templates/nginx-portail.conf.j2` |
|
||||
|
||||
Adresse pour l'élève : `https://syllabuslab.fr/webdav/` (voir « Mes fichiers »
|
||||
dans le menu du compte). Identifiants : les mêmes que la connexion.
|
||||
|
||||
## Vérifier que ça fonctionne
|
||||
|
||||
```
|
||||
systemctl is-active rclone-webdav
|
||||
curl -s -o /dev/null -w "%{http_code}\n" https://syllabuslab.fr/webdav/ # 401 attendu sans identifiants
|
||||
```
|
||||
|
||||
Avec un compte élève jetable (créé et supprimé ensuite via tinker, jamais un
|
||||
compte réel) :
|
||||
|
||||
```
|
||||
curl -u IDENTIFIANT:CODE -X PROPFIND -H "Depth: 1" https://syllabuslab.fr/webdav/
|
||||
curl -u IDENTIFIANT:CODE -T fichier.txt https://syllabuslab.fr/webdav/fichier.txt
|
||||
```
|
||||
|
||||
## Pourquoi RAM et disque sont serrés
|
||||
|
||||
Comme pour Ceph (voir `docs/runbooks/ceph.md`) : ce serveur a réellement
|
||||
31 Go de RAM et 230 Go en RAID 1, pas 64 Go / 2×500 Go comme écrit dans le
|
||||
CLAUDE.md. rclone utilise ~20 Mo, négligeable — mais chaque fichier déposé
|
||||
par un élève prend de l'espace disque réel, partagé avec OpenStack et le
|
||||
portail. Pas de quota par élève pour l'instant (voir `docs/dette.md`).
|
||||
|
||||
## Nettoyer entièrement (si besoin)
|
||||
|
||||
```
|
||||
ssh paillasse
|
||||
sudo systemctl disable --now rclone-webdav.service
|
||||
sudo rm /etc/systemd/system/rclone-webdav.service
|
||||
sudo rm -rf /var/www/portail/storage/app/webdav
|
||||
sudo systemctl daemon-reload
|
||||
```
|
||||
Puis retirer le bloc `/webdav/` et `/interne/webdav-auth` du vhost (relancer
|
||||
`ansible-playbook portail.yml` après avoir enlevé `09-webdav.yml` du
|
||||
`main.yml` du rôle).
|
||||
|
||||
## Écueils rencontrés (pour ne pas les redécouvrir)
|
||||
|
||||
- **Jamais `rewrite` pour injecter une variable posée par `auth_request_set`**
|
||||
dans le chemin proxié — `rewrite` s'exécute avant que la variable existe.
|
||||
Utiliser une `location` à regex nommée + `proxy_pass` avec la variable
|
||||
dans l'URL.
|
||||
- **`--vfs-cache-mode off` ne désactive pas le cache de répertoires de
|
||||
rclone** (`--dir-cache-time`, 5 min par défaut) : un dossier créé par
|
||||
Laravel reste invisible de rclone jusqu'à l'expiration du cache, sauf à
|
||||
mettre `--dir-cache-time` très bas (1 s ici, le volume est faible).
|
||||
- **`SCRIPT_NAME`/`REQUEST_URI` ne sont pas fiables** dans une sous-requête
|
||||
`auth_request` qui fait son propre appel FastCGI : les écrire en dur
|
||||
quand l'URI de la location est fixe.
|
||||
|
|
@ -9,15 +9,17 @@ use App\Services\Stockage\StockageTravauxEleves;
|
|||
use Illuminate\Console\Command;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Log;
|
||||
use Illuminate\Support\Facades\Storage;
|
||||
|
||||
/**
|
||||
* RGPD (CLAUDE.md, étape 14) : supprime les classes archivées depuis
|
||||
* 90 jours, avec en cascade leurs élèves, séances, sessions de lab, machines,
|
||||
* corrections, quiz et devoirs maison (chantier « vrai cockpit »), ainsi que
|
||||
* les annonces, observations, le chat élève ↔ prof (séparation vitrine/
|
||||
* application, 2026-10-13) et les événements d'examen (2026-10-14). Le
|
||||
* compte du prof est conservé. Le journal ne garde que des identifiants et
|
||||
* des nombres, jamais de nom d'élève.
|
||||
* application, 2026-10-13), les événements d'examen (2026-10-14) et le
|
||||
* dossier WebDAV de chaque élève (bloc C, 2026-10-14). Le compte du prof
|
||||
* est conservé. Le journal ne garde que des identifiants et des nombres,
|
||||
* jamais de nom d'élève.
|
||||
*
|
||||
* Les sauvegardes chiffrées contenant encore ces données expirent d'elles-
|
||||
* mêmes au plus 4 semaines plus tard (rotation, docs/runbooks/sauvegardes.md).
|
||||
|
|
@ -33,6 +35,7 @@ class PurgerClassesArchivees extends Command
|
|||
$classes = Classe::whereNotNull('archivee_a')
|
||||
->where('archivee_a', '<=', now()->subDays(Classe::DELAI_PURGE_JOURS))
|
||||
->withCount('eleves')
|
||||
->with('eleves:id,classe_id')
|
||||
->get();
|
||||
|
||||
$purgees = 0;
|
||||
|
|
@ -46,13 +49,18 @@ class PurgerClassesArchivees extends Command
|
|||
continue;
|
||||
}
|
||||
|
||||
// Les fichiers d'Object Storage ne sont pas liés par une clé
|
||||
// étrangère : à supprimer nous-mêmes avant la cascade en base.
|
||||
// Les fichiers d'Object Storage et les dossiers WebDAV ne sont
|
||||
// pas liés par une clé étrangère : à supprimer nous-mêmes avant
|
||||
// la cascade en base.
|
||||
RenduDevoir::whereHas('devoir', fn ($q) => $q->where('classe_id', $classe->id))
|
||||
->whereNotNull('fichier_chemin')
|
||||
->pluck('fichier_chemin')
|
||||
->each(fn (string $chemin) => StockageTravauxEleves::supprimer($chemin));
|
||||
|
||||
foreach ($classe->eleves as $eleve) {
|
||||
Storage::disk('webdav')->deleteDirectory((string) $eleve->id);
|
||||
}
|
||||
|
||||
DB::transaction(fn () => $classe->delete());
|
||||
CacheTableauDeBordProf::vider($classe->user_id);
|
||||
Log::info('Purge RGPD : classe supprimée', [
|
||||
|
|
|
|||
25
portail/app/Http/Controllers/MesFichiersController.php
Normal file
25
portail/app/Http/Controllers/MesFichiersController.php
Normal file
|
|
@ -0,0 +1,25 @@
|
|||
<?php
|
||||
|
||||
namespace App\Http\Controllers;
|
||||
|
||||
use App\Models\Eleve;
|
||||
use Illuminate\Support\Facades\Auth;
|
||||
use Illuminate\View\View;
|
||||
|
||||
/**
|
||||
* « Mes fichiers » (bloc C, CLAUDE.md) : le dossier personnel de l'élève,
|
||||
* montable comme lecteur réseau en WebDAV (voir WebdavAuthController et
|
||||
* ansible/roles/portail/templates/nginx-portail.conf.j2). Pas de liste de
|
||||
* fichiers ici : la page ne fait qu'expliquer comment monter le lecteur,
|
||||
* la navigation dans les fichiers se fait dans l'explorateur du système.
|
||||
*/
|
||||
class MesFichiersController extends Controller
|
||||
{
|
||||
public function show(): View
|
||||
{
|
||||
/** @var Eleve $eleve */
|
||||
$eleve = Auth::guard('eleve')->user();
|
||||
|
||||
return view('mes-fichiers', ['eleve' => $eleve, 'urlWebdav' => rtrim(config('app.url'), '/').'/webdav/']);
|
||||
}
|
||||
}
|
||||
58
portail/app/Http/Controllers/WebdavAuthController.php
Normal file
58
portail/app/Http/Controllers/WebdavAuthController.php
Normal file
|
|
@ -0,0 +1,58 @@
|
|||
<?php
|
||||
|
||||
namespace App\Http\Controllers;
|
||||
|
||||
use App\Models\Eleve;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Http\Response;
|
||||
use Illuminate\Support\Facades\Auth;
|
||||
use Illuminate\Support\Facades\RateLimiter;
|
||||
use Illuminate\Support\Facades\Storage;
|
||||
|
||||
/**
|
||||
* Sous-requête interne de Nginx (auth_request, bloc C, WebDAV des élèves) :
|
||||
* mêmes identifiants que la connexion, jamais de session, jamais appelable
|
||||
* directement depuis l'extérieur (location « internal » de Nginx, voir
|
||||
* ansible/roles/portail/templates/nginx-portail.conf.j2). Répond 200 avec
|
||||
* l'id de l'élève en en-tête (le sous-dossier auquel Nginx le limite), ou
|
||||
* 401 sinon.
|
||||
*/
|
||||
class WebdavAuthController extends Controller
|
||||
{
|
||||
public function verifier(Request $request): Response
|
||||
{
|
||||
$identifiant = $request->getUser();
|
||||
$code = $request->getPassword();
|
||||
|
||||
if ($identifiant === null || $code === null) {
|
||||
return $this->refuser();
|
||||
}
|
||||
|
||||
$cle = 'webdav:'.$identifiant.'|'.$request->ip();
|
||||
|
||||
if (RateLimiter::tooManyAttempts($cle, 5)) {
|
||||
return $this->refuser();
|
||||
}
|
||||
|
||||
$succes = Auth::guard('eleve')->once(['identifiant' => $identifiant, 'password' => $code]);
|
||||
|
||||
if (! $succes) {
|
||||
RateLimiter::hit($cle, 300);
|
||||
|
||||
return $this->refuser();
|
||||
}
|
||||
|
||||
RateLimiter::clear($cle);
|
||||
|
||||
/** @var Eleve $eleve */
|
||||
$eleve = Auth::guard('eleve')->user();
|
||||
Storage::disk('webdav')->makeDirectory((string) $eleve->id);
|
||||
|
||||
return response('', 200)->withHeaders(['X-Eleve-Dossier' => (string) $eleve->id]);
|
||||
}
|
||||
|
||||
private function refuser(): Response
|
||||
{
|
||||
return response('', 401);
|
||||
}
|
||||
}
|
||||
|
|
@ -47,6 +47,18 @@ return [
|
|||
'report' => false,
|
||||
],
|
||||
|
||||
// Bloc C, WebDAV (2026-10-14) : dossier personnel de l'élève, servi
|
||||
// en WebDAV par rclone (voir ansible/roles/portail/templates/
|
||||
// rclone-webdav.service.j2), un sous-dossier par élève (son id).
|
||||
// Local pour l'instant ; bascule vers S3 possible plus tard sans
|
||||
// changer l'architecture (rclone sait servir les deux).
|
||||
'webdav' => [
|
||||
'driver' => 'local',
|
||||
'root' => storage_path('app/webdav'),
|
||||
'throw' => false,
|
||||
'report' => false,
|
||||
],
|
||||
|
||||
's3' => [
|
||||
'driver' => 's3',
|
||||
'key' => env('AWS_ACCESS_KEY_ID'),
|
||||
|
|
|
|||
|
|
@ -31,6 +31,12 @@
|
|||
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8"><circle cx="12" cy="12" r="3"/><path d="M19.4 13a7.6 7.6 0 0 0 0-2l2-1.5-2-3.4-2.3.9a7.6 7.6 0 0 0-1.7-1l-.3-2.5h-4l-.3 2.5a7.6 7.6 0 0 0-1.7 1l-2.3-.9-2 3.4L6.6 11a7.6 7.6 0 0 0 0 2l-2 1.5 2 3.4 2.3-.9c.5.4 1.1.8 1.7 1l.3 2.5h4l.3-2.5c.6-.2 1.2-.6 1.7-1l2.3.9 2-3.4-2-1.5Z"/></svg>
|
||||
Paramètres
|
||||
</a>
|
||||
@if (! $estProf)
|
||||
<a href="{{ route('mes-fichiers') }}" role="menuitem">
|
||||
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8"><rect x="3.5" y="7" width="17" height="13" rx="2"/><path d="M3.5 7l1.5-3h6l1.5 3"/></svg>
|
||||
Mes fichiers
|
||||
</a>
|
||||
@endif
|
||||
<a href="{{ route('aide.app') }}" role="menuitem">
|
||||
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8"><circle cx="12" cy="12" r="9"/><path d="M9.5 9a2.5 2.5 0 1 1 3.5 2.3c-.8.4-1 .8-1 1.7v.5"/><path d="M12 17h.01"/></svg>
|
||||
Aide et assistance
|
||||
|
|
|
|||
38
portail/resources/views/mes-fichiers.blade.php
Normal file
38
portail/resources/views/mes-fichiers.blade.php
Normal file
|
|
@ -0,0 +1,38 @@
|
|||
@extends('layouts.app')
|
||||
|
||||
@section('titre', 'Mes fichiers')
|
||||
|
||||
@section('contenu')
|
||||
<div class="mx-auto max-w-3xl px-5 py-10">
|
||||
<h1 class="text-3xl font-extrabold" style="color:var(--sy-ink)">Mes fichiers</h1>
|
||||
<p class="mt-3 font-semibold" style="color:var(--sy-muted)">
|
||||
Un dossier personnel, à toi seul, que tu peux ouvrir comme un lecteur réseau depuis ton ordinateur — pas besoin de passer par le site pour y déposer ou récupérer un fichier.
|
||||
</p>
|
||||
|
||||
<section class="mt-8 rounded-2xl border p-6" style="border-color:var(--sy-line);background:var(--sy-surface)">
|
||||
<h2 class="text-xl font-extrabold" style="color:var(--sy-ink)">Adresse à utiliser</h2>
|
||||
<p class="mt-3 rounded-xl border px-4 py-3 font-mono text-sm font-semibold" style="border-color:var(--sy-line);background:var(--sy-bg);color:var(--sy-ink)">{{ $urlWebdav }}</p>
|
||||
<p class="mt-3 font-semibold" style="color:var(--sy-muted)">
|
||||
Identifiant et code secret : les mêmes que pour te connecter ({{ $eleve->identifiant }}).
|
||||
</p>
|
||||
</section>
|
||||
|
||||
<section class="mt-6 rounded-2xl border p-6" style="border-color:var(--sy-line);background:var(--sy-surface)">
|
||||
<h2 class="text-xl font-extrabold" style="color:var(--sy-ink)">Comment monter le lecteur</h2>
|
||||
<dl class="mt-4 grid gap-4">
|
||||
<div>
|
||||
<dt class="font-bold" style="color:var(--sy-ink)">Windows</dt>
|
||||
<dd class="mt-1 font-semibold" style="color:var(--sy-muted)">Explorateur de fichiers → « Ce PC » → « Ajouter un lecteur réseau » → coller l'adresse ci-dessus.</dd>
|
||||
</div>
|
||||
<div>
|
||||
<dt class="font-bold" style="color:var(--sy-ink)">macOS</dt>
|
||||
<dd class="mt-1 font-semibold" style="color:var(--sy-muted)">Finder → menu « Aller » → « Se connecter au serveur… » → coller l'adresse ci-dessus.</dd>
|
||||
</div>
|
||||
<div>
|
||||
<dt class="font-bold" style="color:var(--sy-ink)">Linux</dt>
|
||||
<dd class="mt-1 font-semibold" style="color:var(--sy-muted)">Gestionnaire de fichiers → « Se connecter à un serveur » → type WebDAV (davs) → coller l'adresse ci-dessus.</dd>
|
||||
</div>
|
||||
</dl>
|
||||
</section>
|
||||
</div>
|
||||
@endsection
|
||||
|
|
@ -20,6 +20,7 @@ use App\Http\Controllers\InscriptionController;
|
|||
use App\Http\Controllers\MaClasseController;
|
||||
use App\Http\Controllers\MesCoursController;
|
||||
use App\Http\Controllers\MesDevoirsController;
|
||||
use App\Http\Controllers\MesFichiersController;
|
||||
use App\Http\Controllers\MesNotesController;
|
||||
use App\Http\Controllers\ObservationController;
|
||||
use App\Http\Controllers\ParametresController;
|
||||
|
|
@ -36,6 +37,7 @@ use App\Http\Controllers\SessionQuizController;
|
|||
use App\Http\Controllers\SignalementController;
|
||||
use App\Http\Controllers\TokenApiController;
|
||||
use App\Http\Controllers\VisioController;
|
||||
use App\Http\Controllers\WebdavAuthController;
|
||||
use Illuminate\Foundation\Http\Middleware\ValidateCsrfToken;
|
||||
use Illuminate\Support\Facades\Route;
|
||||
|
||||
|
|
@ -157,8 +159,17 @@ Route::middleware(['auth:eleve', 'session.unique:eleve', 'maj.activite'])->group
|
|||
// Chantier « vrai cockpit », étape 3 : Devoirs maison.
|
||||
Route::get('/devoirs/{devoir}', [DevoirEleveController::class, 'show'])->name('devoirs.eleve.show');
|
||||
Route::post('/devoirs/{devoir}/rendre', [DevoirEleveController::class, 'rendre'])->name('devoirs.eleve.rendre');
|
||||
|
||||
// Bloc C : dossier personnel en WebDAV.
|
||||
Route::get('/mes-fichiers', [MesFichiersController::class, 'show'])->name('mes-fichiers');
|
||||
});
|
||||
|
||||
// Sous-requête interne de Nginx seulement (location "internal", voir
|
||||
// ansible/roles/portail/templates/nginx-portail.conf.j2) : jamais appelable
|
||||
// depuis l'extérieur. Pas de middleware de session : chaque appel s'identifie
|
||||
// par en-tête HTTP Basic (mêmes identifiants que la connexion élève).
|
||||
Route::get('/interne/webdav-auth', [WebdavAuthController::class, 'verifier'])->name('interne.webdav-auth');
|
||||
|
||||
// --- Espace prof (protégé, session unique) ---
|
||||
Route::middleware(['auth:web', 'session.unique:web'])->group(function () {
|
||||
Route::get('/mes-classes', [ClasseController::class, 'index'])->name('mes-classes.index');
|
||||
|
|
|
|||
|
|
@ -12,7 +12,7 @@ test('chaque page publique s’affiche sans erreur', function () {
|
|||
&& $r->getName() !== null
|
||||
&& ! str_contains($r->uri(), '{')
|
||||
&& ! collect($r->gatherMiddleware())->contains(fn ($m) => is_string($m) && str_starts_with($m, 'auth')))
|
||||
->reject(fn ($r) => str_starts_with($r->uri(), 'horizon') || str_starts_with($r->uri(), '_') || $r->uri() === 'up')
|
||||
->reject(fn ($r) => str_starts_with($r->uri(), 'horizon') || str_starts_with($r->uri(), '_') || str_starts_with($r->uri(), 'interne/') || $r->uri() === 'up')
|
||||
// Redirections voulues (ex. /statut vers le site de statut ; pages de
|
||||
// suivi d'une demande pour rejoindre une classe, sans demande en cours).
|
||||
->reject(fn ($r) => $r->getActionName() === '\\Illuminate\\Routing\\RedirectController'
|
||||
|
|
@ -31,7 +31,8 @@ test('chaque page publique s’affiche sans erreur', function () {
|
|||
test('aucune page publique ne charge de police depuis un service externe', function () {
|
||||
$pages = collect(Route::getRoutes())
|
||||
->filter(fn ($r) => in_array('GET', $r->methods(), true) && $r->getName() !== null && ! str_contains($r->uri(), '{'))
|
||||
->reject(fn ($r) => collect($r->gatherMiddleware())->contains(fn ($m) => is_string($m) && str_starts_with($m, 'auth')));
|
||||
->reject(fn ($r) => collect($r->gatherMiddleware())->contains(fn ($m) => is_string($m) && str_starts_with($m, 'auth')))
|
||||
->reject(fn ($r) => str_starts_with($r->uri(), 'interne/'));
|
||||
|
||||
foreach ($pages as $route) {
|
||||
$html = $this->get('/'.ltrim($route->uri(), '/'))->getContent();
|
||||
|
|
@ -56,7 +57,8 @@ test('les scripts en ligne des pages publiques sont du JavaScript valide', funct
|
|||
$pages = collect(Route::getRoutes())
|
||||
->filter(fn ($r) => in_array('GET', $r->methods(), true) && $r->getName() !== null && ! str_contains($r->uri(), '{'))
|
||||
->reject(fn ($r) => collect($r->gatherMiddleware())->contains(fn ($m) => is_string($m) && str_starts_with($m, 'auth')))
|
||||
->reject(fn ($r) => $r->getActionName() === '\Illuminate\Routing\RedirectController');
|
||||
->reject(fn ($r) => $r->getActionName() === '\Illuminate\Routing\RedirectController')
|
||||
->reject(fn ($r) => str_starts_with($r->uri(), 'interne/'));
|
||||
|
||||
$erreurs = [];
|
||||
foreach ($pages as $route) {
|
||||
|
|
|
|||
69
portail/tests/Feature/WebdavTest.php
Normal file
69
portail/tests/Feature/WebdavTest.php
Normal file
|
|
@ -0,0 +1,69 @@
|
|||
<?php
|
||||
|
||||
use App\Models\Classe;
|
||||
use App\Models\Eleve;
|
||||
use Illuminate\Support\Facades\RateLimiter;
|
||||
use Illuminate\Support\Facades\Storage;
|
||||
|
||||
beforeEach(function () {
|
||||
Storage::fake('webdav');
|
||||
});
|
||||
|
||||
test('la sous-requête Nginx refuse sans identifiants', function () {
|
||||
$this->get(route('interne.webdav-auth'))->assertStatus(401);
|
||||
});
|
||||
|
||||
test('la sous-requête Nginx refuse un code secret incorrect', function () {
|
||||
$eleve = Eleve::factory()->create();
|
||||
|
||||
$this->withBasicAuth($eleve->identifiant, 'mauvais-code')
|
||||
->get(route('interne.webdav-auth'))
|
||||
->assertStatus(401);
|
||||
});
|
||||
|
||||
test('la sous-requête Nginx accepte les identifiants de connexion et pose le dossier de l’élève', function () {
|
||||
$eleve = Eleve::factory()->create(['code_secret' => bcrypt('monCode123')]);
|
||||
|
||||
$this->withBasicAuth($eleve->identifiant, 'monCode123')
|
||||
->get(route('interne.webdav-auth'))
|
||||
->assertStatus(200)
|
||||
->assertHeader('X-Eleve-Dossier', (string) $eleve->id);
|
||||
|
||||
Storage::disk('webdav')->assertExists((string) $eleve->id);
|
||||
});
|
||||
|
||||
test('5 échecs de suite bloquent temporairement même avec le bon code juste après', function () {
|
||||
$eleve = Eleve::factory()->create(['code_secret' => bcrypt('monCode123')]);
|
||||
|
||||
for ($i = 0; $i < 5; $i++) {
|
||||
$this->withBasicAuth($eleve->identifiant, 'mauvais')
|
||||
->get(route('interne.webdav-auth'))
|
||||
->assertStatus(401);
|
||||
}
|
||||
|
||||
$this->withBasicAuth($eleve->identifiant, 'monCode123')
|
||||
->get(route('interne.webdav-auth'))
|
||||
->assertStatus(401);
|
||||
|
||||
RateLimiter::clear('webdav:'.$eleve->identifiant.'|127.0.0.1');
|
||||
});
|
||||
|
||||
test('un élève connecté voit l’adresse de son dossier WebDAV', function () {
|
||||
$eleve = Eleve::factory()->create();
|
||||
|
||||
eleve($this, $eleve)->get(route('mes-fichiers'))
|
||||
->assertOk()
|
||||
->assertSee('/webdav/')
|
||||
->assertSee($eleve->identifiant);
|
||||
});
|
||||
|
||||
test('purger une classe archivée supprime aussi le dossier WebDAV de ses élèves', function () {
|
||||
$classe = Classe::factory()->create();
|
||||
$eleve = Eleve::factory()->create(['classe_id' => $classe->id]);
|
||||
Storage::disk('webdav')->put($eleve->id.'/photo.jpg', 'contenu');
|
||||
|
||||
$classe->forceFill(['archivee_a' => now()->subDays(91)])->save();
|
||||
$this->artisan('classes:purger-archivees');
|
||||
|
||||
Storage::disk('webdav')->assertMissing($eleve->id.'/photo.jpg');
|
||||
});
|
||||
Loading…
Add table
Add a link
Reference in a new issue