From 57fb12c8f7c12e2b730279683da396f1e1e0fc53 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Th=C3=A9o=20Gastinel?= <264859180+gastinelt@users.noreply.github.com> Date: Thu, 29 Oct 2026 12:47:58 +0100 Subject: [PATCH] docs: mise a jour de la documentation technique et du plan de deploiement en production --- DOCUMENTATION.md | 45 +++++--- beta/README.md | 53 +++++++--- beta/deploiement/PLAN.md | 221 +++++++++++++++++++++++++++++++++------ 3 files changed, 259 insertions(+), 60 deletions(-) diff --git a/DOCUMENTATION.md b/DOCUMENTATION.md index dd74c10..d37e900 100644 --- a/DOCUMENTATION.md +++ b/DOCUMENTATION.md @@ -37,23 +37,32 @@ jobrunner web/ ├── .gitignore # Protection des clés privées, logs et dépendances ├── README.md # Présentation du dépôt ├── DOCUMENTATION.md # Présente documentation technique complète -├── index.html # Espace projet : tableau de bord (point d'entrée ; accès protégé par Caddy basic_auth) +├── index.html # Espace projet : tableau de bord & générateur de codes bêta (admin.jobrunner.fr) ├── app.html # Application Web frontend complète (HTML, CSS inline, JS vanilla) ├── charte.html # Charte graphique v1.1 (couleurs, typo, logo, icônes, animations) -├── legal.html # Documents légaux (CGU, CGV, confidentialité, cookies, mentions) — brouillon, voir docs/conformite-legale.md +├── legal.html # Documents légaux (CGU, CGV, confidentialité, cookies, mentions) — brouillon ├── package.json # Outil de build CSS (devDependency : Tailwind 3.4.19) ├── tailwind.config.js # Palette et ombres du site (source du CSS généré, lit app.html) +├── beta/ # Couche autonome de la bêta testeurs (Python 3 standard) +│ ├── server.py # Serveur HTTP (porte d'entrée, sessions, API admin, injection CSS/JS) +│ ├── codes.py # CLI d'administration des codes d'accès (génération, révocation, liste) +│ ├── db.py # Couche SQLite (codes, sessions, tentatives, audit, démo) +│ ├── bots.py # Simulation d'activité lente et profils fictifs +│ ├── static/ # Pages HTML autonomes (formulaire.html, gate.html) +│ ├── pdf/ # Générateur du formulaire d'engagement testeur PDF (AcroForm) +│ ├── deploiement/ # Architecture et plan de déploiement en production (PLAN.md) +│ └── tests/ # Suite de 25 tests unitaires automatisés └── assets/ ├── css/ │ ├── app.css # CSS Tailwind compilé (généré, à versionner) - │ ├── espace.css # Styles de l'espace projet (index.html) + │ ├── espace.css # Styles de l'espace projet (index.html) dont zone gestion bêta │ ├── legal.css # Styles de legal.html │ ├── tailwind.src.css # Entrée du build Tailwind + règle reduced-motion │ └── fonts.css # @font-face Plus Jakarta Sans et Outfit (auto-hébergées) ├── js/ │ └── legal.js # Navigation de legal.html ├── icones-jobrunner/ # 15 icônes de la charte (SVG, currentColor, sans cadre) - ├── img/logo-j.svg # Logo J de la charte v1.1 (l'ancien logo-light.svg reste utilisé par app.html) + ├── img/logo-j.svg # Logo J de la charte v1.1 ├── fonts/ # Fichiers .woff2 Plus Jakarta Sans et Outfit (latin + latin-ext) └── icons/ ├── phosphor.css # Icônes Phosphor (sous-ensemble utilisé) @@ -116,6 +125,8 @@ Le fichier `index.html` intègre déjà les modules complets suivants : | **Processus de Séquestre Mock** | Modale de paiement avec explication des fonds protégés et validation de fin de mission. | | **Espace Profil & Annonces** | Gestion des annonces personnelles, favoris, historique et statut de certification. | | **Footer & Mentions Légales** | Modales légales (Mentions légales, CGU, Politique de confidentialité RGPD, Cookies). | +| **Porte d'entrée & Bêta (`jobrunner.fr`)** | Porte d'accès par code unique, formulaire d'inscription autonome (`/__beta/formulaire`), bandeau d'information bêta et bouton de retour d'expérience. | +| **Gestionnaire Bêta (`admin.jobrunner.fr`)** | Générateur instantané de codes testeurs `JRB-...`, validité paramétrable, message d'invitation pré-rempli pour WhatsApp/SMS, historique et statut des codes en temps réel. | --- @@ -144,19 +155,23 @@ Le fichier `index.html` intègre déjà les modules complets suivants : --- -## 6. Mise en Ligne & Configuration du Domaine `Jobrunner.fr` +## 6. Mise en Ligne & Architecture de Production (Déployé le 29/10/2026) -### Pointage DNS du domaine : -Dans l'interface de gestion de votre nom de domaine `Jobrunner.fr` (chez votre registrar) : +L'infrastructure sépare le site public de test et l'espace projet / administration : -* **Enregistrement `A` :** - * Hôte : `@` - * Valeur : `IP_DE_VOTRE_SERVEUR` -* **Enregistrement `CNAME` :** - * Hôte : `www` - * Valeur : `jobrunner.fr.` -* **Certificat SSL / HTTPS :** - * Activation du certificat HTTPS Let's Encrypt (gratuit) sur votre serveur pour un affichage sécurisé avec le cadenas vert. +### 6.1 Domaines & DNS (Infomaniak) +* `jobrunner.fr`, `www.jobrunner.fr`, `beta.jobrunner.fr` : Enregistrements `A` vers `179.237.102.233` (VPS Suisse). +* `admin.jobrunner.fr` : Enregistrement `A` vers `179.237.102.233` (Espace projet sous authentification HTTP Basic Auth). + +### 6.2 Architecture Caddy (VPS `cornafsuisse`) +* **`admin.jobrunner.fr`** : Protégé par HTTP Basic Auth (`/etc/caddy/jobrunner-auth.caddy`). Sert les fichiers statiques de `/srv/jobrunner.fr`. La route `/_admin/api/*` est proxifiée vers `10.88.88.2:8830` via WireGuard (`wg2`) avec l'en-tête interne `X-Admin: 1`. +* **`jobrunner.fr` (et alias `www`, `beta`)** : Proxifié vers `10.88.88.2:8830` via WireGuard (`wg2`). + +### 6.3 Serveur Backend (`cornafserver`) +* **Service** : `jobrunner-beta.service` (systemd utilisateur). +* **Port** : `8830`, sécurisé par `nftables` (accessible uniquement depuis le VPS via WireGuard `wg2`). +* **Données** : `/home/cornaf2049/jobrunner-beta-data/beta.sqlite` avec permissions restreintes (`0600`). +* **Sécurité applicative** : HMAC-SHA256 pour les codes d'accès, anti-bruteforce (6 essais / 15 min), plafonds de requêtes concurrentes, timeouts stricts de 20 s. --- diff --git a/beta/README.md b/beta/README.md index 5586199..8b0cb9d 100644 --- a/beta/README.md +++ b/beta/README.md @@ -1,19 +1,42 @@ # Bêta testeurs JobRunner -Couche locale, sans dépendance (Python 3 standard), qui sert le site derrière un code d'accès. -Le site d'origine n'est pas modifié : le serveur injecte `beta.js` et `beta.css` dans les pages. +Couche autonome, sans dépendance externe (Python 3 standard), qui sert le site JobRunner derrière un code d'accès sécurisé et offre une interface d'inscription pour les testeurs. +Le site d'origine n'est pas altéré : le serveur injecte `beta.js` et `beta.css` dans les pages servies aux testeurs. - set BETA_DATA=...\data # optionnel (défaut : beta/data, ignoré par git) - python beta/codes.py generer --label "Prénom N." --jours 30 - python beta/server.py # http://127.0.0.1:8830/ - python beta/bots.py # bots lents (autre terminal) - python -m unittest discover -s beta/tests -p "test_*.py" - python beta/pdf/generer_formulaire.py # régénère le PDF (reportlab, fonttools, brotli) +## Architecture & Déploiement en production (depuis le 29/10/2026) -Sécurité : codes hachés (HMAC + sel local), comparés en temps constant à tous les codes, limite de -tentatives par IP (6 par 15 min), journal, révocation immédiate, CSP `connect-src 'self'` (aucun appel -vers un prestataire de paiement), données de démo dans des tables `demo_*` séparées. -Droits POSIX (dossier 0700, fichiers 0600) vérifiés par `test_droits.py` sous Linux uniquement ; -sous Windows ils n'ont pas d'effet : s'appuyer sur le profil utilisateur. -Ne jamais exposer ce serveur directement : écoute 127.0.0.1, derrière Caddy seulement. -Déploiement : `beta/deploiement/PLAN.md` (non appliqué). +- **Domaine public bêta** : `https://jobrunner.fr` (et `www.jobrunner.fr`, `beta.jobrunner.fr`) + - Redirige automatiquement vers la porte d'entrée `/__beta/gate`. + - Formulaire interactif autonome d'inscription : `https://jobrunner.fr/__beta/formulaire`. + - Proxifié par le Caddy du VPS (`cornafsuisse`) vers le port 8830 de `cornafserver` via WireGuard (`wg2`). +- **Espace projet & Administration** : `https://admin.jobrunner.fr` + - Protégé par HTTP Basic Auth au niveau de Caddy (`/etc/caddy/jobrunner-auth.caddy`). + - Sert les maquettes et l'espace projet (`/srv/jobrunner.fr`). + - Intègre la **Gestion de la Bêta** pour générer en un clic des codes d'accès uniques (`JRB-XXXX-XXXX-XXXX`), copier le message d'invitation pré-rédigé pour WhatsApp/SMS, et suivre l'historique des codes. + - Route API : `/_admin/api/*` proxifiée vers `cornafserver:8830` avec l'en-tête interne `X-Admin: 1`. + +## Commandes locales & Développement + +```bash +set BETA_DATA=...\data # optionnel (défaut : beta/data, ignoré par git) +python beta/codes.py generer --label "Prénom N." --jours 30 +python beta/server.py # http://127.0.0.1:8830/ +python beta/bots.py # bots lents (autre terminal) +python -m unittest discover -s beta/tests -p "test_*.py" +python beta/pdf/generer_formulaire.py # régénère le PDF d'engagement (reportlab, fonttools, brotli) +``` + +## Sécurité & Robustesse + +- **Codes d'accès** : Hachage HMAC-SHA256 avec sel local (`salt` de 32 octets sous `0600`), comparaison en temps constant `hmac.compare_digest`. +- **Anti-bruteforce** : Limite stricte de 6 tentatives par IP par tranche de 15 minutes, temporisation adaptative. +- **Déni de service & DoS** : + - Plafond de 64 connexions simultanées, max 2 requêtes `/enter` concurrentes par IP. + - Timeout total de 20 s (ligne de requête + en-têtes + corps). + - Taille de corps bornée par route (ex. 2 ko pour `/enter`, 4 ko pour `/admin/api/codes/creer`). + - Aucun keep-alive (`Connection: close` systématique). +- **Protection des données** : + - Base SQLite dédiée (`beta.sqlite`) avec permissions `0600` (dossier parent en `0700`). + - Tables de démo isolées (`demo_*`) réinitialisables via `bots.py --reset`. + - CSP stricte : `connect-src 'self'`, `frame-ancestors 'none'`, pas d'accès sortant vers des prestataires tiers de paiement. + - Respect RGPD : données testeurs conservées uniquement pour la durée du test, purgeable après clôture. diff --git a/beta/deploiement/PLAN.md b/beta/deploiement/PLAN.md index 2bc4f57..e225cf1 100644 --- a/beta/deploiement/PLAN.md +++ b/beta/deploiement/PLAN.md @@ -1,36 +1,197 @@ -# Plan de déploiement de la bêta sur jobrunner.fr (préparé, NON appliqué) +# Déploiement de la Bêta JobRunner (Appliqué en production le 29/10/2026) -Rien de ce dossier n'a été exécuté sur un serveur. Tout est à valider avec Nils, puis à appliquer par Théo. +Ce document décrit l'architecture déployée et les procédures d'exploitation pour la bêta testeurs de JobRunner. -## Choix recommandé : sous-domaine `beta.jobrunner.fr` -| | Sous-domaine `beta.` (recommandé) | Chemin `jobrunner.fr/beta` | -|---|---|---| -| Cookies / CSP | isolés du site principal | partagés avec `jobrunner.fr` (basic_auth) | -| Retour arrière | supprimer 1 bloc Caddy + 1 DNS | éditer le bloc principal | -| Risque pour l'existant | nul (bloc séparé) | touche le bloc protégé | -| Coût | 1 enregistrement DNS + certificat auto | aucun | +--- -## Étapes (dans l'ordre) -1. DNS : enregistrement `beta` (A, et AAAA si le VPS en a un) vers l'IP du VPS. Où est géré le DNS de jobrunner.fr : à vérifier (non trouvé dans mes notes). -2. cornafserver : copier le dépôt (branche `feat/beta-testeurs-1029`) dans `~/jobrunner-beta`, installer les unités `*.service.exemple` (utilisateur, sans sudo), `loginctl enable-linger` si besoin, démarrer le serveur puis les bots. -3. Générer les codes en local sur le serveur : `python3 beta/codes.py generer --label "Prénom N." --jours 30 --csv`, envoyer chaque code par un canal privé, puis supprimer `codes-emis.csv`. -4. VPS : ajouter le bloc `Caddyfile.beta.exemple` (sudo Théo), `caddy validate`, `systemctl reload caddy`. Sauvegarder d'abord le Caddyfile. -5. Vérifications : `/` redirige vers `/__beta/gate`, un mauvais code est refusé puis limité, un bon code entre, `/beta/db.py` et `/.git/config` donnent 404, aucun appel sortant (CSP `connect-src 'self'`). -6. Pré-requis : page 404 commune (note du 27/10) non appliquée sur jobrunner.fr : à voir avec Nils. +## 1. Architecture en Production -## Exposition : UNIQUEMENT derrière Caddy (obligatoire) -Le serveur Python (`http.server`) n'est pas fait pour Internet. Règles : -- il écoute sur `127.0.0.1` uniquement (`BETA_HOST=127.0.0.1`), jamais sur 0.0.0.0 ni sur une IP publique ; -- seul un Caddy le joint. Le VPS et cornafserver étant deux machines : VPS Caddy (public, TLS) -> WireGuard -> **second Caddy sur cornafserver** (écoute sur l'IP wg1) -> `127.0.0.1:8830`. Les limites ci-dessous se posent dans le Caddy qui est le plus proche du client (VPS) ET dans celui de cornafserver ; -- `BETA_TRUST_PROXY=1` seulement dans cette chaîne (le serveur lit le DERNIER `X-Forwarded-For`, ajouté par Caddy) ; -- limites Caddy explicites (voir `Caddyfile.beta.exemple`) : `timeouts { read_header 10s, read_body 15s, write 20s, idle 15s }`, `request_body max_size 3MB` (le serveur borne en plus : 2 ko /enter, 8 ko /tester, 2,6 Mo /feedback après session), `max_header_size`. Limite de connexions par IP : pas dans Caddy de base ; soit plugin `caddy-ratelimit`, soit règle `nftables ct count` (sudo Théo) : à choisir, non faite ; -- défenses déjà dans le serveur : délai total 20 s (ligne + en-têtes + corps, socket fermée), pas de keep-alive, 64 connexions max, 2 requêtes /enter simultanées par IP, délais d'échec hors de tout verrou. +``` + INTERNET + │ + ▼ + ┌────────────────────────┐ + │ VPS cornafsuisse │ + │ IP : 179.237.102.233 │ + │ Caddy (TLS Let's Enc) │ + └───────────┬────────────┘ + │ + ┌────────────────────────────┴────────────────────────────┐ + │ │ + admin.jobrunner.fr jobrunner.fr + (HTTP Basic Auth) www. / beta.jobrunner.fr + │ │ + ┌───────┴───────────────┐ │ + │ Fichiers statiques │ │ + │ /srv/jobrunner.fr │ │ + │ (Espace projet) │ │ + └───────┬───────────────┘ │ + │ │ + │ Route /_admin/api/* │ + │ (en-tête X-Admin: 1) │ + ▼ ▼ + Tunnel WireGuard wg2 (chiffré) Tunnel WireGuard wg2 (chiffré) + │ │ + └────────────────────────────┬────────────────────────────┘ + │ + ▼ + ┌────────────────────────┐ + │ cornafserver (maison) │ + │ IP wg2 : 10.88.88.2 │ + │ nftables : port 8830 │ + │ Service systemd user │ + │ jobrunner-beta │ + │ SQLite beta.sqlite │ + └────────────────────────┘ +``` -## Retour arrière -Retirer le bloc Caddy, `systemctl --user stop jobrunner-beta jobrunner-beta-bots`, supprimer l'enregistrement DNS, supprimer `~/jobrunner-beta-data` (retours, testeurs : données personnelles). +--- -## Exploitation -- Révoquer : `codes.py revoquer ` (coupe les sessions tout de suite). Prolonger : `codes.py prolonger --jours N`. -- Journal : `codes.py journal`. Retours : `codes.py retours`. Testeurs : `codes.py testeurs`. -- Remise à zéro de la démo : `bots.py --reset` (n'efface que les tables `demo_*`). -- Suppression des données personnelles 6 mois après la fin de la bêta (engagement du formulaire). +## 2. Configuration DNS (Infomaniak) + +| Enregistrement | Type | Cible | Rôle | +|---|---|---|---| +| `jobrunner.fr` | `A` | `179.237.102.233` | Bêta publique (redirigée vers `/__beta/gate`) | +| `www.jobrunner.fr` | `A` | `179.237.102.233` | Alias web | +| `beta.jobrunner.fr` | `A` | `179.237.102.233` | Sous-domaine dédié bêta | +| `admin.jobrunner.fr`| `A` | `179.237.102.233` | Espace projet & générateur de codes (accès restreint) | + +--- + +## 3. Configuration Caddy (`cornafsuisse`) + +Fichier : `/etc/caddy/Caddyfile` + +### Espace projet & API Admin : +```caddy +admin.jobrunner.fr { + import /etc/caddy/jobrunner-auth.caddy + import /etc/caddy/securite.caddy + log { + format filter { + wrap json + fields { + request>remote_ip delete + request>client_ip delete + request>headers>X-Forwarded-For delete + request>headers>X-Real-Ip delete + } + } + } + encode zstd gzip + + handle /_admin/api/* { + reverse_proxy 10.88.88.2:8830 { + header_up Host admin.jobrunner.fr + header_up X-Admin 1 + header_up X-Forwarded-For {remote_host} + header_up X-Forwarded-Proto https + } + } + + handle { + root * /srv/jobrunner.fr + file_server + } +} +``` + +### Bêta publique : +```caddy +jobrunner.fr, www.jobrunner.fr, beta.jobrunner.fr { + import /etc/caddy/securite.caddy + header { + X-Robots-Tag "noindex, nofollow, noarchive" + -Server + } + encode zstd gzip + + reverse_proxy 10.88.88.2:8830 { + header_up Host {host} + header_up X-Forwarded-For {remote_host} + header_up X-Forwarded-Proto https + } +} +``` + +--- + +## 4. Configuration Serveur (`cornafserver`) + +### Pare-feu nftables : +Fichier : `/etc/nftables.d/filtre_hote.nft` +Le port `8830` est autorisé uniquement depuis l'interface WireGuard `wg2` : +```nftables +table inet filtre_hote { + set tcp_wg2 { + type inet_service + flags interval + elements = { 22, 8000, 8095, 8830 } + } +} +``` + +### Service systemd utilisateur : +Fichier : `~/.config/systemd/user/jobrunner-beta.service` +- Écoute : `0.0.0.0:8830` (joignable par wg2 uniquement) +- Répertoire de travail : `/home/cornaf2049/jobrunner-beta` +- Variables d'environnement : `BETA_DATA=/home/cornaf2049/jobrunner-beta-data` +- Droits SQLite : `0600` sur `beta.sqlite`, `0700` sur `~/jobrunner-beta-data` + +--- + +## 5. Exploitation & Gestion des Codes + +### Depuis l'interface web (recommandé) : +Rendez-vous sur `https://admin.jobrunner.fr` : +1. Connectez-vous avec vos identifiants d'administration. +2. Dans la section **Gestion de la Bêta**, saisissez le nom ou la référence du testeur (ex. *Thomas D. (WhatsApp)*). +3. Choisissez la durée de validité (30 jours, 60 jours, 90 jours ou illimitée). +4. Cliquez sur **Créer le code**. +5. Le code `JRB-XXXX-XXXX-XXXX` s'affiche immédiatement avec : + - Un bouton pour copier le code seul. + - Un bouton pour copier le message d'invitation pré-rempli pour WhatsApp ou SMS. + +### En ligne de commande sur `cornafserver` : +```bash +# Lister les codes actifs +python3 ~/jobrunner-beta/beta/codes.py liste + +# Créer un code en CLI +python3 ~/jobrunner-beta/beta/codes.py generer --label "Testeur X" --jours 30 + +# Révoquer un code immédiatement +python3 ~/jobrunner-beta/beta/codes.py revoquer + +# Consulter le journal d'activité +python3 ~/jobrunner-beta/beta/codes.py journal + +# Consulter les retours testeurs reçus +python3 ~/jobrunner-beta/beta/codes.py retours +``` + +### Maintenance du service : +```bash +# Vérifier l'état du service +systemctl --user status jobrunner-beta + +# Redémarrer après mise à jour +systemctl --user restart jobrunner-beta + +# Consulter les logs en direct +journalctl --user -u jobrunner-beta -f -n 50 +``` + +--- + +## 6. Procédure de Retour Arrière (Rollback) + +En cas de besoin de suspension temporaire ou définitive : +1. **Couper le reverse proxy sur `cornafsuisse`** : + Restaurer la sauvegarde Caddy `/root/sauvegardes/caddy/Caddyfile.avant-admin-jobrunner-20261029-105849` et recharger Caddy (`caddy reload`). +2. **Stopper le service sur `cornafserver`** : + ```bash + systemctl --user stop jobrunner-beta + ``` +3. **Fermer le port au pare-feu** : + Retirer le port 8830 de `/etc/nftables.d/filtre_hote.nft` et recharger nftables.