Troubleshooting und Monitoring von Wazuh
Behebung von Konfigurationsfehlern in Docker Compose, 5007-Ausnahmen bei unsicheren Passwörtern, Inode-Korruption und Blue-Team-Audit-Befehle.
Dieser technische Leitfaden fasst die kritischen Vorfälle zusammen, die während der Architektur-, Deployment- und Integrationsphasen der Sicherheitsplattform Wazuh 4.9 unter Docker festgestellt wurden, zusammen mit den entsprechenden Diagnoseflüssen und operativen Audit-Anweisungen für Blue Team-Analysten.
1. Protokoll kritischer Fehler und Architektur-Lösungen
Sección titulada «1. Bitácora de Errores Críticos y Resoluciones de Arquitectura»Vorfall 1: Authentifizierungsfehler durch Variableninterpolation ($)
Sección titulada «Incidencia 1: Fallo en Autenticación por Interpolación de Variables ($)»- Fehlersymptom: Die Container lehnten die initialen komplexen Passwörter ab und warfen kryptografische Ausnahmen in den Initialisierungs-Logs.
- Systemdiagnose: Die Docker-Compose-Engine interpretiert das Sonderzeichen
$in den YAML-Konfigurationsdateien nativ als Aufruf- oder Interpolationsdirektive für lokale Variablen des Host-Systems. Da der Admin-Schlüssel ein Sonderzeichen enthielt, wurde ein gekürztes Passwort injiziert. - Angewendete Lösung: Vollständiger Austausch des Schlüsselwörterbuchs durch komplexe alphanumerische Passwörter mit hoher Entropie ohne Escape-Symbole bei Konflikten.
Vorfall 2: Endlose Neustartschleife im Manager-Container (Fehler 5007)
Sección titulada «Incidencia 2: Bucle de Reinicio Infinito en Contenedor Manager (Error 5007)»- Fehler-Symptom: Die Container-Abfrage meldete den Manager
wazuh.managerin einer kontinuierlichen Neustart-Schleife. Die Protokollprüfung ergab die Ausnahme:wazuh.core.exception.WazuhError: Error 5007 - Insecure user password provided. - Systemdiagnose: Die Wazuh-Firmware schreibt ab Version 4.9 eine strikte Passwort-Härtungsrichtlinie (Password Hardening) für die REST-API vor. Sie erfordert zwingend die Kombination aus Großbuchstaben, Kleinbuchstaben, Ziffern und mindestens einem Sonderzeichen der Interpunktion.
- Angewendete Lösung: Änderung des API-Schlüssels (
mP5nT8qB2vK9wR3xY6cS4dB9.) durch Hinzufügen eines Punktes.am Ende, um die Anforderungen des nativen regulären Ausdrucks-Validators zu erfüllen.
Vorfall 3: Inode-bedingte Dateikorruption von internal_users.yml
Sección titulada «Incidencia 3: Corrupción por Inodos del Archivo internal_users.yml»- Fehlersymptom: Die OpenSearch-Engine lehnte die Synchronisationsbefehle ab mit der Begründung, dass die Identitäten in den Credential-Tabellen nicht existierten. Die Datei erschien innerhalb des Containers vollständig leer.
- Systemdiagnose: Inode-Kollision auf Dateisystemebene beim Versuch, eine Host-Datei live in ein Docker-Volume zu mounten und zu modifizieren. OpenSearch löschte die Metadaten, um sie neu zu schreiben, wodurch der physische Bezug verloren ging.
- Angewandte Lösung: Entwurf eines robusten asynchronen Prozesses:
- Bcrypt-Hashes isoliert im Container generieren.
- Die Originaldatei physisch direkt vom Host aus ändern.
- Erzwingen des Lesevorgangs unter Verwendung der SSL-Signatur des Skripts
securityadmin.sh.
Vorfall 4: Dauerhafter Ladehänger „Wazuh dashboard server is not ready yet“
Sección titulada «Incidencia 4: Cuelgue de Carga Perpetuo “Wazuh dashboard server is not ready yet”»- Fehlersymptom: Nach der Bereinigung der Systemvolumes war das Web-Frontend dauerhaft nicht erreichbar.
- Systemdiagnose: Der Befehl
down -vzerstört die auf dem Host gemounteten lokalen Datenbanken. Beim Hochfahren des Clusters wird OpenSearch mit seinen werkseitigen Standard-Hashes initialisiert, wodurch die Kommunikation mit dem Dashboard, das komplexe Schlüssel verwendet, unterbrochen wird. - Angewendete Lösung: Es ist zwingend erforderlich, nach jeder Volumenbereinigung des Clusters Schritt 1 (Synchronisierung kryptografischer Hashes) aus Modul 2 vollständig erneut auszuführen.
Vorfall 5: Crash-Loop des Dashboards wegen doppelter Schlüssel (Duplicated Mapping Key)
Sección titulada «Incidencia 5: Crash-Loop del Dashboard por Claves Duplicadas (Duplicated Mapping Key)»- Fehler-Symptom: Der Web-Container
wazuh.dashboardstoppte und warf in seiner Fehler-Trace:FATAL Error: Error getting configuration: duplicated mapping key at line 8 [...] hosts:. - Systemdiagnose: Die Web-Schnittstelle versucht, die Manager-Struktur in die Datei
wazuh.ymlselbst zu injizieren, falls sie diese bei der ersten Initialisierung nicht findet. Wenn der Administrator die Datei gleichzeitig manuell bearbeitet, werden zwei Header-Keyshosts:injiziert, was die YAML-Syntax ungültig macht. - Angewendete Lösung: Manuelle Intervention: Container stoppen, die Konfigurationsdatei mit einem einzigen sauberen Schlüssel
hosts:rekonstruieren und den Dienst neu starten.
2. Operatives Überwachungshandbuch (Analysten-Befehle)
Sección titulada «2. Manual Operativo de Monitorización (Comandos de Analista)»Empfohlene Befehle zur Überprüfung der Gesundheit und Leistung des SIEM während Intrusion-Simulationen oder alltäglichen Verwaltungsaufgaben:
A. Status der Container-Infrastruktur
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. Gesundheitsdiagnose der Datenbank (Indexer)
Sección titulada «B. Diagnóstico de Salud de la Base de Datos (Indexer)»Überprüfen Sie, ob die verteilte Datenbank Indexierungsprobleme oder ausgefallene Shards aufweist (muss den Schlüssel "status" : "green" zurückgeben):
sudo docker compose exec wazuh.indexer curl -X GET -k -u admin:zR9mK2vX5pW8qN3tY6cR4vB1 "https://localhost:9200/_cluster/health?pretty"C. Betriebsstatus der Analyse-Subprozesse (Manager)
Sección titulada «C. Estado Operativo de los Subprocesos de Análisis (Manager)»Überprüfen Sie den internen Status des Wazuh-Brains und stellen Sie sicher, dass alle Analyse-Queues und Log-Engines den Status 'aktiv' melden (running):
sudo docker compose exec wazuh.manager /var/ossec/bin/wazuh-control statusD. Forensische Spuren und Incident Response (Echtzeit-Logs)
Sección titulada «D. Trazas Forenses e Incident Response (Logs en Tiempo Real)»Wichtige Befehle zur Auditierung von Kommunikationsfehlern oder zur Live-Verfolgung von Netzwerksicherheitsvorfällen:
# 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
