Ir al contenido

Troubleshooting und Monitoring von Wazuh

Behebung von Konfigurationsfehlern in Docker Compose, 5007-Ausnahmen bei unsicheren Passwörtern, Inode-Korruption und Blue-Team-Audit-Befehle.

0Lesungen

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.


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.manager in 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:
    1. Bcrypt-Hashes isoliert im Container generieren.
    2. Die Originaldatei physisch direkt vom Host aus ändern.
    3. 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 -v zerstö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.dashboard stoppte 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.yml selbst zu injizieren, falls sie diese bei der ersten Initialisierung nicht findet. Wenn der Administrator die Datei gleichzeitig manuell bearbeitet, werden zwei Header-Keys hosts: 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.

Empfohlene Befehle zur Überprüfung der Gesundheit und Leistung des SIEM während Intrusion-Simulationen oder alltäglichen Verwaltungsaufgaben:

Ventana de terminal
# Comprobar estado de encendido de todos los servicios
sudo docker compose ps
# Monitorizar el consumo de recursos de CPU y RAM de cada contenedor
sudo docker stats

Überprüfen Sie, ob die verteilte Datenbank Indexierungsprobleme oder ausgefallene Shards aufweist (muss den Schlüssel "status" : "green" zurückgeben):

Ventana de terminal
sudo docker compose exec wazuh.indexer curl -X GET -k -u admin:zR9mK2vX5pW8qN3tY6cR4vB1 "https://localhost:9200/_cluster/health?pretty"

Ü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):

Ventana de terminal
sudo docker compose exec wazuh.manager /var/ossec/bin/wazuh-control status

D. 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:

Ventana de terminal
# Monitorizar trazas de conexión del Portal Web
sudo docker compose logs -f wazuh.dashboard
# Monitorizar trazas de enlace y alertas del Indexer con el Manager
sudo docker compose logs -f wazuh.manager
# Inspeccionar logs internos de alertas caídas o bloqueos de agentes
sudo 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