Dépannage et surveillance de Wazuh
Résolution d'erreurs de configuration dans Docker Compose, exceptions 5007 de mot de passe non sécurisé, corruption d'inodes et commandes d'audit Blue Team.
Ce guide technique récapitule les incidents critiques détectés lors des phases d'architecture, de déploiement et d'intégration de la plateforme de sécurité Wazuh 4.9 sous Docker, ainsi que leurs flux de diagnostic respectifs et les instructions opérationnelles d'audit pour les analystes du Blue Team.
1. Journal des Erreurs Critiques et Résolutions d'Architecture
Sección titulada «1. Bitácora de Errores Críticos y Resoluciones de Arquitectura»Incident 1 : Échec d'authentification par interpolation de variables ($)
Sección titulada «Incidencia 1: Fallo en Autenticación por Interpolación de Variables ($)»- Symptôme d'erreur : Les conteneurs rejetaient les mots de passe complexes initiaux et généraient des exceptions cryptographiques dans les journaux d'initialisation.
- Diagnostic système : Le moteur Docker Compose interprète nativement le caractère spécial
$dans les fichiers de configuration YAML comme une directive d'appel ou d'interpolation de variables locales du système hôte. Comme la clé admin contenait un caractère spécial, un mot de passe tronqué était injecté. - Résolution appliquée : Remplacement intégral du dictionnaire de clés par des mots de passe alphanumériques complexes à haute entropie, sans symboles d'échappement conflictuels.
Incident 2 : Boucle de Redémarrage Infinie dans le Conteneur Manager (Erreur 5007)
Sección titulada «Incidencia 2: Bucle de Reinicio Infinito en Contenedor Manager (Error 5007)»- Síntoma de Error: La consulta de contenedores reportaba al gestor
wazuh.manageren un bucle continuo de reinicio. La auditoría de logs arrojaba la excepción:wazuh.core.exception.WazuhError: Error 5007 - Insecure user password provided. - Diagnostic système : Le firmware de Wazuh, à partir de la version 4.9, impose une directive de renforcement de mot de passe (Password Hardening) stricte pour l'API REST. Il nécessite obligatoirement la combinaison de majuscules, minuscules, chiffres et au moins un symbole de ponctuation spécial.
- Résolution appliquée : Modification de la clé de l'API (
mP5nT8qB2vK9wR3xY6cS4dB9.) en introduisant un point.à la fin de celle-ci pour satisfaire aux exigences du validateur d'expressions régulières natif.
Incident 3 : Corruption d'inodes du fichier internal_users.yml
Sección titulada «Incidencia 3: Corrupción por Inodos del Archivo internal_users.yml»- Symptôme d'erreur : Le moteur OpenSearch rejetait les commandes de synchronisation en alléguant que les identités n'existaient pas dans les tables d'identification. Le fichier apparaissait complètement vide à l'intérieur du conteneur.
- Diagnostic système : Collision d'inodes au niveau du système de fichiers lors d'une tentative de montage et de modification en direct d'un fichier hôte vers un volume Docker. OpenSearch vidait les métadonnées pour les réécrire, perdant ainsi la référence physique.
- Résolution appliquée : Conception d'un processus asynchrone robuste :
- Générer des hachages bcrypt de manière isolée dans le conteneur.
- Modifier physiquement le fichier original directement depuis l'hôte.
- Forcer la lecture en utilisant la signature SSL du script
securityadmin.sh.
Incident 4 : Blocage de Chargement Perpétuel "Wazuh dashboard server is not ready yet"
Sección titulada «Incidencia 4: Cuelgue de Carga Perpetuo “Wazuh dashboard server is not ready yet”»- Symptôme d'erreur : Après la purge des volumes du système, le frontend web est resté perpétuellement inaccessible.
- Diagnostic système : L'instruction
down -vdétruit les bases de données locales montées sur l'hôte. Lors du démarrage du cluster, OpenSearch s'initialise avec ses hashs par défaut d'usine, rompant la communication avec le Dashboard qui utilise les clés complexes. - Résolution appliquée : Il est impératif de réexécuter entièrement l' Étape 1 (Synchronisation des hashs cryptographiques) du Module 2 après chaque purge de volume du cluster.
Incident 5 : Crash-Loop du Dashboard pour Clés Dupliquées (Duplicated Mapping Key)
Sección titulada «Incidencia 5: Crash-Loop del Dashboard por Claves Duplicadas (Duplicated Mapping Key)»- Síntoma de Error: El contenedor web
wazuh.dashboardse detenía arrojando en su traza de error:FATAL Error: Error getting configuration: duplicated mapping key at line 8 [...] hosts:. - Diagnostic système : L'interface web tente d'auto-injecter la structure du Manager dans le fichier
wazuh.ymlsi elle ne le localise pas lors de sa première initialisation. Si l'administrateur édite manuellement le fichier au même moment, deux clés d'en-têtehosts:sont injectées, invalidant la syntaxe du langage de description YAML. - Résolution appliquée : Intervention manuelle : Arrêter le conteneur, reconstruire le fichier de configuration avec une seule clé
hosts:propre, et redémarrer le service.
2. Manuel Opérationnel de Surveillance (Commandes d'Analyste)
Sección titulada «2. Manual Operativo de Monitorización (Comandos de Analista)»Commandes recommandées pour vérifier la santé et les performances du SIEM lors de simulations d'intrusion ou de tâches d'administration quotidiennes :
A. État de l'infrastructure des conteneurs
Sección titulada «A. Estado de la Infraestructura de Contenedores»# Comprobar estado de encendido de todos los serviciossudo docker compose ps
# Monitorizar el consumo de recursos de CPU y RAM de cada contenedorsudo docker statsB. Diagnostic de santé de la base de données (Indexer)
Sección titulada «B. Diagnóstico de Salud de la Base de Datos (Indexer)»Vérifiez que la base de données distribuée ne présente pas de problèmes d'indexation ou de shards tombés (doit retourner la clé "status" : "green") :
sudo docker compose exec wazuh.indexer curl -X GET -k -u admin:zR9mK2vX5pW8qN3tY6cR4vB1 "https://localhost:9200/_cluster/health?pretty"C. État opérationnel des sous-processus d'analyse (Manager)
Sección titulada «C. Estado Operativo de los Subprocesos de Análisis (Manager)»Vérifiez l'état interne du moteur de Wazuh et assurez-vous que toutes les files d'attente d'analyse et les moteurs de logs signalent un état actif (running) :
sudo docker compose exec wazuh.manager /var/ossec/bin/wazuh-control statusD. Traces forensiques et réponse aux incidents (Logs en temps réel)
Sección titulada «D. Trazas Forenses e Incident Response (Logs en Tiempo Real)»Commandes clés pour auditer les erreurs de communication ou suivre à chaud les incidents de sécurité réseau :
# Monitorizar trazas de conexión del Portal Websudo docker compose logs -f wazuh.dashboard
# Monitorizar trazas de enlace y alertas del Indexer con el Managersudo docker compose logs -f wazuh.manager
# Inspeccionar logs internos de alertas caídas o bloqueos de agentessudo docker compose exec wazuh.manager tail -f /var/ossec/logs/ossec.log
# Visualización analítica de Alertas en Caliente (Ideal para Incident Response)sudo docker compose exec wazuh.manager tail -f /var/ossec/logs/alerts/alerts.json
