Troubleshooting en monitoring van Wazuh
Oplossen van configuratiefouten in Docker Compose, 5007-uitzonderingen voor onveilige wachtwoorden, inode-corruptie en Blue Team-auditcommando's.
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.
1. Logboek van Kritieke Fouten en Architectuuroplossingen
Sección titulada «1. Bitácora de Errores Críticos y Resoluciones de Arquitectura»Incident 1: Authenticatiefout door variabele-interpolatie ($)
Sección titulada «Incidencia 1: Fallo en Autenticación por Interpolación de Variables ($)»- 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.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. - 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:
- Bcrypt-hashes geïsoleerd genereren in de container.
- Het originele bestand fysiek rechtstreeks vanaf de host wijzigen.
- 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 -vvernietigt 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.dashboardse 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.ymlte injecteren als deze bij de eerste initialisatie niet wordt gevonden. Als de beheerder het bestand tegelijkertijd handmatig bewerkt, worden er twee header-keyshosts: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:
A. Status van de Containerinfrastructuur
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. Gezondheidsdiagnose van de Database (Indexer)
Sección titulada «B. Diagnóstico de Salud de la Base de Datos (Indexer)»Controleer of de gedistribueerde database geen indexeringsproblemen of uitgevallen shards heeft (moet de key "status" : "green" retourneren):
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):
sudo docker compose exec wazuh.manager /var/ossec/bin/wazuh-control statusD. 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:
# 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
