Ir al contenido

Troubleshooting en monitoring van Wazuh

Oplossen van configuratiefouten in Docker Compose, 5007-uitzonderingen voor onveilige wachtwoorden, inode-corruptie en Blue Team-auditcommando's.

0lecturas

Deze technische gids verzamelt de kritieke incidenten die zijn gedetecteerd tijdens de architectuur-, implementatie- en integratiefasen van het beveiligingsplatform Wazuh 4.9 onder Docker, samen met de respectievelijke diagnostische workflows en operationele auditinstructies voor Blue Team-analisten.


  • Foutsymptoom: De containers weigerden de initiële complexe wachtwoorden en gaven cryptografische uitzonderingen in de initialisatielogs.
  • Systeemdiagnose: De Docker Compose-engine interpreteert het speciale karakter $ in de YAML-configuratiefbestanden van nature als een aanroep- of interpolatie-instructie voor lokale variabelen van het host-systeem. Omdat de admin-sleutel een speciaal teken bevatte, werd een afgekapte wachtwoord geïnjecteerd.
  • Toegepaste oplossing: Volledige vervanging van de sleutelset door complexe alfanumerieke wachtwoorden met een hoge entropie zonder escape-symbolen die conflicten veroorzaken.

Incident 2: Oneindige Herstartlus in Manager-container (Fout 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.manager en un bucle continuo de reinicio. La auditoría de logs arrojaba la excepción: wazuh.core.exception.WazuhError: Error 5007 - Insecure user password provided.
  • Systeemdiagnose: De Wazuh-firmware legt vanaf versie 4.9 een strikte wachtwoordverhardingsrichtlijn (Password Hardening) op voor de REST-API. Het vereist verplicht de gecombineerde aanwezigheid van hoofdletters, kleine letters, cijfers en ten minste één speciaal leesteken.
  • Toegepaste oplossing: Modificatie van de API-sleutel (mP5nT8qB2vK9wR3xY6cS4dB9.) door een punt . aan het einde toe te voegen om te voldoen aan de vereisten van de native regex-validator.

Incident 3: Corruptie door inode van het bestand internal_users.yml

Sección titulada «Incidencia 3: Corrupción por Inodos del Archivo internal_users.yml»
  • Foutsymptoom: De OpenSearch-engine weigerde de synchronisatiecommando's met de melding dat de identiteiten niet bestonden in de credential-tabellen. Het bestand leek volledig leeg in de container.
  • Systeemdiagnose: Inode-botsing op bestandssysteemniveau bij het proberen live te mounten en wijzigen van een hostbestand naar een Docker-volume. OpenSearch maakte de metadata leeg om deze te herschrijven, waardoor de fysieke referentie verloren ging.
  • Toegepaste oplossing: Het ontwerp van een robuust asynchroon proces:
    1. Bcrypt-hashes geïsoleerd genereren in de container.
    2. Het originele bestand fysiek rechtstreeks vanaf de host wijzigen.
    3. De leesactie forceren met behulp van de SSL-handtekening van het script securityadmin.sh.

Incident 4: Oneindig Vastlopen tijdens Laden “Wazuh dashboard server is not ready yet”

Sección titulada «Incidencia 4: Cuelgue de Carga Perpetuo “Wazuh dashboard server is not ready yet”»
  • Foutsymptoom: Na het wissen van de systeemvolumes bleef de webfrontend permanent ontoegankelijk.
  • Systeemdiagnose: Het instructie down -v vernietigt de lokaal op de host gemounte databases. Bij het opstarten van de cluster initialiseert OpenSearch met de standaard fabrieks-hashes, waardoor de communicatie met het Dashboard, dat complexe sleutels gebruikt, wordt verbroken.
  • Toegepaste oplossing: Het is verplicht om Stap 1 (Synchronisatie van cryptografische hashes) van Module 2 volledig opnieuw uit te voeren na elke purgering van een cluster-volume.

Incident 5: Crash-Loop van Dashboard door Dubbele Sleutels (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.dashboard se detenía arrojando en su traza de error: FATAL Error: Error getting configuration: duplicated mapping key at line 8 [...] hosts:.
  • Systeemdiagnose: De webinterface probeert de Manager-structuur automatisch in het bestand wazuh.yml te injecteren als deze bij de eerste initialisatie niet wordt gevonden. Als de beheerder het bestand tegelijkertijd handmatig bewerkt, worden er twee header-keys hosts: geïnjecteerd, waardoor de YAML-beschrijvingssyntax ongeldig wordt.
  • Toegepaste oplossing: Handmatige interventie: Stop de container, reconstruheer het configuratiebestand met een enkele schone hosts: key, en start de service opnieuw op.

2. Operationele Handleiding voor Monitoring (Analistencommando's)

Sección titulada «2. Manual Operativo de Monitorización (Comandos de Analista)»

Aanbevolen commando's om de gezondheid en prestaties van het SIEM te verifiëren tijdens inbraaksimulaties of dagelijkse beheertaken:

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

Controleer of de gedistribueerde database geen indexeringsproblemen of uitgevallen shards heeft (moet de key "status" : "green" retourneren):

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

C. Operationele Status van de Analysesubprocessen (Manager)

Sección titulada «C. Estado Operativo de los Subprocesos de Análisis (Manager)»

Controleer de interne status van de Wazuh-engine en verifieer of alle analysequeues en log-engines een actieve status rapporteren (running):

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

D. Forensische Sporen en Incident Response (Realtime Logs)

Sección titulada «D. Trazas Forenses e Incident Response (Logs en Tiempo Real)»

Belangrijkste commando's voor het auditen van communicatiefouten of het live volgen van netwerkbeveiligingsincidenten:

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