TL;DR
Wazuh est une plateforme open source de sécurité utilisée pour centraliser des événements, détecter des comportements suspects, suivre la conformité et investiguer des incidents. Dans cet épisode, le sujet central est: Installation. L objectif est de relier la démonstration du dépôt Xavki à une compréhension exploitable en contexte SIEM/XDR.
La vidéo de référence
Vidéo: https://www.youtube.com/watch?v=BXEc0P9t2tM
Playlist complète: https://www.youtube.com/playlist?list=PLn6POgpklwWoCKf3PDJYT2ihAd0hPZ0uM
Le dépôt support est disponible ici: https://gitlab.com/xavki/tutorials-wazuh. Le support de ce chapitre se trouve dans 02-installation/install.txt.
Wazuh et Installation: c est quoi exactement ?
Une installation Wazuh n est pas juste un paquet à poser. Elle assemble des services centraux, une configuration de noeuds, des certificats, un dashboard et des agents qui doivent pointer vers le bon manager.
Le vrai sujet de ce chapitre est de installer les composants Wazuh sans perdre le fil entre indexer, server, dashboard, certificats, mots de passe et agents. Le dépôt Xavki sert de colonne vertébrale factuelle: il expose les slides, commandes et fichiers utilisés pendant les démonstrations. La documentation Wazuh complète ensuite le contexte officiel: architecture, installation, agents, règles, intégrations et capacités.
Points clés vus dans le support Xavki
- Le dépôt fournit le support du chapitre et les fichiers nécessaires au lab.
- La vidéo explique le fil pédagogique et l ordre de manipulation.
- Les commandes doivent être adaptées à votre environnement de test.
Ces points doivent être lus comme une progression: d abord comprendre le signal collecté, ensuite vérifier la collecte, puis seulement interpréter l alerte dans Wazuh.
Modèle mental minimal
Un flux Wazuh se résume ainsi: endpoint -> agent -> Wazuh server -> rules/decoders -> indexer -> dashboard. Si une alerte manque, il faut diagnostiquer cette chaîne dans l ordre. Si une alerte existe mais n est pas utile, le problème vient souvent du bruit, du contexte ou du seuil de règle.
Notions et définitions sécurité
- **SIEM**: Security Information and Event Management. Un SIEM centralise des journaux, applique des règles de corrélation et aide les équipes sécurité à investiguer des événements. Wazuh couvre ce rôle en collectant, normalisant, stockant et affichant des alertes.
- **XDR**: Extended Detection and Response. Un XDR élargit la détection au-delà du simple log management: endpoints, comportements, réponse active, cloud, conteneurs et menaces. Dans Wazuh, cette dimension apparaît avec les agents, les capacités endpoint, la conformité et les intégrations.
- **Agent**: Composant installé sur une machine surveillée. Il collecte des logs, fichiers, événements système, inventaires, métriques ou signaux de sécurité, puis les transmet au serveur Wazuh.
- **Decoder**: Un decoder transforme un événement brut en champs compréhensibles: source IP, utilisateur, programme, message, code, chemin de fichier. Sans décodage correct, une règle peut ne jamais se déclencher.
- **Rule**: Une règle Wazuh évalue un événement décodé et produit éventuellement une alerte avec un niveau, des groupes, une description et des métadonnées. Les règles sont le cœur de la détection.
- **Faux positif**: Alerte techniquement déclenchée mais non pertinente dans le contexte. Un outil de sécurité utile doit gérer les faux positifs avec du tuning, des exceptions documentées et des seuils adaptés.
- **Indicateur de compromission**: Un IOC est un signal qui peut indiquer une activité malveillante: IP, hash, domaine, chemin, comportement, signature IDS ou motif dans un log. Il doit toujours être interprété avec du contexte.
Ces définitions sont volontairement pratiques. L objectif n est pas de réciter un glossaire, mais de savoir où placer chaque notion dans la chaîne de détection: collecte, décodage, corrélation, alerte, investigation et réponse.
Approfondissement spécifique
Dans l épisode Installation, le point spécifique est l assemblage des composants Wazuh. L indexer stocke, le server reçoit et analyse, le dashboard expose les données, et l agent prouve que la plateforme voit réellement un endpoint.
La validation ne doit pas s arrêter à une interface web accessible. Il faut confirmer que les services sont démarrés, que le cluster indexer répond, que le dashboard communique avec l API et qu un agent remonte correctement.
Le dépôt fournit aussi des fichiers concrets pour ce chapitre: 02-installation/install.txt. Ils servent à retrouver les commandes, scripts de test, sorties ou configurations utilisées dans la démonstration.
Ce que cet épisode cherche à modifier
- installer indexer, server et dashboard dans le bon ordre
- gérer certificats, mots de passe et endpoints de connexion
- enrôler au moins un agent pour valider la chaîne complète
Chemin de diagnostic recommandé
- générer la configuration
- installer l indexer puis démarrer le cluster
- installer le server et le dashboard
- enrôler un agent et vérifier sa remontée
- preuve attendue: installer indexer, server et dashboard dans le bon ordre
- preuve attendue: gérer certificats, mots de passe et endpoints de connexion
- preuve attendue: enrôler au moins un agent pour valider la chaîne complète
Points de vigilance sécurité
- oublier les certificats ou mots de passe générés pendant l installation
- croire que le dashboard suffit à valider l installation
- installer un agent qui pointe vers le mauvais manager
Commandes et fichiers du chapitre
curl -sO https://packages.wazuh.com/4.7/wazuh-install.shcurl -sO https://packages.wazuh.com/4.7/config.ymlecho 'bash wazuh-install.sh --generate-config-filesbash wazuh-install.sh --wazuh-indexer wazidx1bash wazuh-install.sh --start-clustertar -axf wazuh-install-files.tar wazuh-install-files/wazuh-passwords.txt -O | grep -P "\'admin\'" -A 1bash wazuh-install.sh --wazuh-server wazidx1bash wazuh-install.sh --wazuh-dashboard wazidx1curl -s https://packages.wazuh.com/key/GPG-KEY-WAZUH | gpg --no-default-keyring --keyring gnupg-ring:/usr/share/keyrings/wazuh.gpg --import && chmod 644 /usr/share/keyrings/wazuh.gpgecho "deb [signed-by=/usr/share/keyrings/wazuh.gpg] https://packages.wazuh.com/4.x/apt/ stable main" | tee -a /etc/apt/sources.list.d/wazuh.listapt-get update
Liens utiles
- Dépôt Xavki tutorials-wazuh
- Playlist YouTube Wazuh Xavki
- Documentation officielle Wazuh
- Wazuh Quickstart
- Architecture Wazuh
- Wazuh agents
- Wazuh ruleset, decoders et rules
- Documentation complémentaire Wazuh
- Documentation complémentaire Wazuh
- Documentation complémentaire Wazuh
- 02-installation/install.txt
Liens internes conseillés
- Parcours Kubernetes si vous voulez relier Wazuh à la supervision de plateformes conteneurisées.
- Prometheus, Grafana et observabilité pour distinguer métriques, logs et alertes sécurité.
- RabbitMQ sur Kubernetes pour comparer supervision applicative, messaging et signaux de sécurité.
Pour poursuivre la progression, consultez aussi Wazuh 003 – Brute-force attack test on SSH.
FAQ
Wazuh est-il plutôt un SIEM ou un XDR ?
Wazuh couvre des usages SIEM comme la centralisation, la corrélation et l analyse de logs, mais aussi des usages XDR comme la détection endpoint, la réponse active, la conformité, le FIM, la sécurité conteneur et l intégration de sources externes.
Faut-il installer un agent partout ?
Pas forcément partout dès le début. Il faut prioriser les machines critiques, les serveurs exposés, les bastions, les workloads sensibles et les environnements de test. L agent apporte la visibilité endpoint, mais il faut gérer bruit, charge et configuration.
Pourquoi mes alertes Wazuh ne remontent-elles pas ?
Les causes courantes sont une source de log absente, un agent non connecté, un mauvais chemin dans la configuration, une règle non déclenchée, un filtre dashboard trop restrictif ou un événement qui n est pas décodé comme prévu.
Wazuh remplace-t-il Prometheus ou Grafana ?
Non. Wazuh est orienté sécurité, conformité et détection. Prometheus et Grafana sont orientés métriques, SLO, tableaux de bord techniques et observabilité. Les deux approches se complètent.
Conclusion
Cet épisode 2 ajoute une brique à la compréhension de Wazuh. La bonne méthode consiste à partir du signal brut, vérifier la collecte, lire les règles déclenchées, puis seulement interpréter l alerte dans un contexte de sécurité réel. Le dépôt Xavki donne le lab, la documentation Wazuh donne le cadre officiel, et le deep dive permet de transformer la démonstration en méthode de diagnostic.