fix : correctifs multiples

BackupVaultWarden/README.md

@@ -0,0 +1,116 @@
+# FONCTIONNEMENT DU SCRIPT VAULTWARDEN
+Le script de backup de vaultwarden permet une sauvegard périodique des mots de passe et utilisateurs de celui-ci.
+
+## INITIALISATION DES VARIABLES DE MANIÈRE SÉCURISÉ
+
+1. Les informations sensibles ne sont pas stockées directement dans le script. Elles sont placées dans un fichier .env
+
+```bash
+WEBHOOK_URL=...
+REMOTE_USER=...
+REMOTE_HOST=...
+SSH_KEY=...
+DATA_DIR=...
+```
+
+2. on recupere les varibales dans le script
+```bash
+REMOTE_USER=$(grep -E '^REMOTE_USER=' .env | cut -d '=' -f2-)
+```
+
+Explication:
+
+- grep recherche la variable dans le fichier .env 
+- cut récupère uniquement la valeur après =
+- REMOTE_USER="user" Le script récupère >> "user"
+
+Cela permet:
+
+- d’améliorer la sécurité 
+- d’éviter de modifier le script si un paramètre change
+
+## RÉCUPÉRATION DES DONNÉES
+
+1. Le dossier data de Vaultwarden est dupliqué puis compressé afin de créer une archive :
+```bash
+tar -czf "$LOCAL_BACKUP" -C "$(dirname "$DATA_DIR")" "$(basename "$DATA_DIR")"
+```
+
+2. Transfer vers le serveur de backup
+```bash
+scp "${SSH_OPTS[@]}" "$LOCAL_BACKUP" "$REMOTE_USER@$REMOTE_HOST:$REMOTE_DIR/"
+```
+La sauvegarde est envoyée vers une machine dédiée grâce à SCP. Pour éviter de saisir un mot de passe à chaque fois, une clé SSH est utilisée.
+
+Cette clé SSH est générée sur la machine de backup et autorisée sur la machine Vaultwarden.
+
+## NOTIFICATION DISCORD
+
+Le script envoie une notification sur un salon Discord pour informer de l’état de la sauvegarde. Cela se fait grâce à un webhook Discord.
+
+1. on défini le message
+```bash
+local msg="**@here Backup Vaultwarden $color**\n"
+msg+="Backup: ${BACKUP_NAME}\n"
+msg+="Data transfer: $dumps_display\n"
+[[ -n "$details" ]] && msg+="Details: $details"
+```
+
+2. on envoie le message sur discord avec le message et le webhook
+```bash
+curl -fsS -H "Content-Type: application/json" \
+-d "{\"content\":\"$msg\"}" \
+"$DISCORD_WEBHOOK_URL"
+```
+Le message indique:
+
+- si la sauvegarde a réussi 🟢 
+- si elle a échoué 🔴 
+- le nom du backup 
+- les détails de l’erreur si nécessaire
+
+## PLANIFICATION AVEC CRON
+
+Le script est exécuté automatiquement chaque jour grâce à cron.
+
+1. Ouvrez le crontab pour l'édition :
+   ```bash
+   crontab -e
+   ```
+2. Ajoutez la ligne suivante pour exécuter le script tous les jours à 19h :
+```bash
+   0 19 * * * /chemin/vers/le/script/check_storage.sh
+```
+
+Signification:
+
+- 0  minute 0
+- 19  19h  
+- *  tous les jours du mois
+- *  tous les mois 
+- *  tous les jours de la semaine 
+
+Tous les jours à 19h, le script est exécuté et les logs sont enregistrés dans backup.log ce qui permet d’analyser les erreurs si un problème survient.
+
+## NETTOYAGE
+
+Une fois la sauvegarde envoyée sur la machine distante, le fichier temporaire est supprimé :
+
+```bash
+rm -f "$LOCAL_BACKUP"
+```
+
+Cela permet de garder le serveur propre et éviter de remplir le disque.
+
+## RÉSUMÉ
+
+Le script automatise complètement les sauvegardes Vaultwarden :
+
+- sauvegarde du dossier data 
+- compression et datation 
+- transfert sécurisé via SSH 
+- notification Discord 
+- exécution automatique avec cron 
+- sécurisation des paramètres via .env
+
+Cela permet d’avoir une sauvegarde quotidienne fiable et surveillée.