From 9b504526258b188464a5254236afd9a9d0ec6f12 Mon Sep 17 00:00:00 2001 From: maxime Date: Tue, 24 Mar 2026 23:59:06 +0100 Subject: [PATCH] 1.2 --- README.md | 51 +++++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 47 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 2476d8d..3f74979 100644 --- a/README.md +++ b/README.md @@ -27,6 +27,12 @@ loustiques-home/ │ ├── dashboard.html # Tableau de bord principal │ ├── admin.html # Panneau d'administration │ └── log.html # Visualisation des logs en temps réel +├── web_secu/ +│ ├── ssl.sh # Génération du certificat SSL auto-signé +│ ├── avahi.sh # Installation et démarrage du service mDNS +│ └── ssl/ +│ ├── cert.pem # Certificat SSL (généré automatiquement) +│ └── key.pem # Clé privée SSL (générée automatiquement) ├── run_flask.sh # Script de démarrage du serveur ├── requirement.txt # Dépendances Python └── .env # Variables d'environnement (non versionné) @@ -38,9 +44,9 @@ loustiques-home/ ### `run_flask.sh` -Script bash de démarrage. Il vérifie la présence de Python 3 et de Flask, crée le fichier de log `/var/log/loustique.log` avec les bonnes permissions, puis lance le serveur Flask. +Script bash de démarrage. Il vérifie la présence de Python 3 et de Flask, génère le certificat SSL si absent, démarre Avahi pour le DNS local, crée le fichier de log `/var/log/loustique.log` avec les bonnes permissions, puis lance le serveur Flask. -À exécuter avec `sudo` pour pouvoir créer le fichier de log : +À exécuter avec `sudo` pour pouvoir créer le fichier de log et installer les services : ```bash sudo bash run_flask.sh @@ -48,6 +54,31 @@ sudo bash run_flask.sh --- +### `web_secu/ssl.sh` + +Génère un certificat SSL auto-signé (`cert.pem` + `key.pem`) dans `web_secu/ssl/`. Le certificat est valable 365 jours et est émis pour `loustiques.local`. Si le certificat existe déjà, le script ne le régénère pas. + +``` +C=BE / ST=Brabant Wallon / L=Louvain-La-Neuve / O=Les Loustiques / OU=EPHEC / CN=loustiques.local +``` + +--- + +### `web_secu/avahi.sh` + +Installe et démarre **Avahi** (implémentation mDNS) sur le Raspberry Pi. Une fois actif, le Pi est automatiquement accessible via son hostname suivi de `.local` sur tout le réseau local, sans rien modifier sur les machines clientes. + +Pour changer le hostname du Pi : + +```bash +sudo hostnamectl set-hostname loustiques +sudo reboot +``` + +Le Pi sera ensuite accessible via `https://loustiques.local:5000`. + +--- + ### `log.py` Configure le système de logging de l'application. Les logs sont écrits dans `/var/log/loustique.log` au format : @@ -135,7 +166,7 @@ Interface de visualisation des logs en temps réel. Se rafraîchit automatiqueme - MySQL / MariaDB - Un environnement virtuel Python (`venv`) - > **Note :** Le script `run_flask.sh` s'occupe automatiquement de vérifier et installer les dépendances nécessaires. Cette liste est fournie par souci de transparence et pour les installations manuelles. +> **Note :** Le script `run_flask.sh` s'occupe automatiquement de vérifier et installer les dépendances nécessaires. Cette liste est fournie par souci de transparence et pour les installations manuelles. ### Étapes @@ -161,6 +192,18 @@ sudo bash run_flask.sh --- +## Accès à l'interface + +Une fois le serveur lancé, l'interface est accessible via : + +``` +https://.local:5000 +``` + +Le certificat étant auto-signé, le navigateur affichera un avertissement de sécurité. Il suffit d'accepter l'exception pour continuer. + +--- + ## Variables d'environnement (`.env`) ```env @@ -202,4 +245,4 @@ CREATE TABLE Auth ( ## Groupe -Projet réalisé par **Les Loustiques** — étudiants à l'**EPHEC** (Louvain-La-Neuve). +Projet réalisé par **Les Loustiques** — étudiants à l'**EPHEC** (Louvain-La-Neuve). \ No newline at end of file