Ir al contenido

Troubleshooting a monitorovanie Wazuh

Riešenie chýb konfigurácie v docker compose, výnimky 5007 pre nezabezpečené heslo, poškodenie inodeov a auditačné príkazy pre Blue Team.

0lecturas

Táto technická príručka zbiera kritické incidenty zistené počas fáz architektúry, nasadenia a integrácie bezpečnostnej platformy Wazuh 4.9 pod Dockerom, spolu s ich príslušnými diagnostickými postupmi a prevádzkovými pokynmi na auditu pre analytikov Blue Team.


Incident 1: Chyba autentifikácie spôsobená interpoláciou premenných ($)

Sección titulada «Incidencia 1: Fallo en Autenticación por Interpolación de Variables ($)»
  • Príznak chyby: Kontajnery odmietali počiatočné komplexné heslá a v iniciálnych logoch vyhadzovali kryptografické výnimky.
  • Diagnostika systémov: Engine Docker Compose natívne interpretuje špeciálny znak $ vo YAML konfiguračných súboroch ako smernicu volania alebo interpoláciu lokálnych premenných hostitelského systému. Keďže admin kľúč obsahoval špeciálny znak, dochádzalo k injekcii skráteného hesla.
  • Uplatnené riešenie: Komplexná výmena slovníka kľúčov za vysoko entropické alfanumerické komplexné heslá bez potreby únikových znakov pri konfliktoch.

Incident 2: Nekonečná slučka reštartov v kontajneri Manager (Chyba 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.
  • Diagnostika systémov: Firmware Wazuh od verzie 4.9 vynucuje prísnu smernicu na zabezpečenie hesiel (Password Hardening) pre REST API. Vyžaduje kombináciu veľkých a malých písmen, čísel a aspoň jedného špeciálneho interpunkčného symbolu.
  • Uplatnené riešenie: Úprava API kľúča (mP5nT8qB2vK9wR3xY6cS4dB9.) zavedením bodky . na jeho konci, aby sa splnili požiadavky natívneho validátora regulárnych výrazov.

Incident č. 3: Korupcia súboru spôsobená inode internal_users.yml

Sección titulada «Incidencia 3: Corrupción por Inodos del Archivo internal_users.yml»
  • Príznak chyby: Engine OpenSearch odmietaval synchronizačné príkazy s tvrdením, že identity neexistujú v tabuľkách priechodov. Súbor sa vo vnútri kontajnera objavoval úplne prázdny.
  • Diagnostika systémov: Kolízia inode na úrovni súborového systému pri pokuse o živé namontovanie a úpravu súboru z hostiteľa do Docker volúmu. OpenSearch vymazával metadáta, aby ich zapísal znova, čím strácal fyzický odkaz.
  • Aplikované riešenie: Návrh robustného asynchrónneho procesu:
    1. Generovať bcrypt hashe izolovane v kontajneri.
    2. Fyzicky upraviť pôvodný súbor priamo z hostiteľa.
    3. Vynútiť čítanie pomocou SSL podpisu skriptu securityadmin.sh.

Incident 4: Nekonečné načítavanie „Wazuh dashboard server is not ready yet“

Sección titulada «Incidencia 4: Cuelgue de Carga Perpetuo “Wazuh dashboard server is not ready yet”»
  • Príznak chyby: Po vyčistení systémových sväzkov zostal webový frontend navždy nedostupný.
  • Systémová diagnostika: Príkaz down -v zničí lokálne databázy namontované na hostiteľa. Pri spustení clusteru sa OpenSearch inicializuje s predvolenými továrnymi hashmi, čo preruší komunikáciu s Dashboardom, ktorý využíva komplexné kľúče.
  • Aplikované riešenie: Je nevyhnutné úplne zopakovať Krok 1 (Synchronizácia kryptografických hashov z modulu 2 po každom vyčistení sväzkov clusteru.

Incident 5: Crash-Loop Dashboardu kvôli duplicitným kľúčom (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:.
  • Systémová diagnostika: Webové rozhranie sa pokúša automaticky injektovať štruktúru Managera do súboru wazuh.yml, ak ho pri prvej inicializácii nenájde. Ak administrátor súčasne manuálne upraví súbor, injektujú sa dve hlavičkové kľúče hosts:, čo spôsobí neplatnú syntaxu YAML popisného jazyka.
  • Aplikované riešenie: Manuálna intervencia: Zastaviť kontejner, obnoviť konfiguračný súbor s jedným čistým kľúčom hosts: a znovu spustiť službu.

2. Operačný manuál monitorovania (Príkazy analytika)

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

Odporúčané príkazy na overenie zdravia a výkonu SIEM počas simulácií narušenia alebo každodenných úloh správy:

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

Skontrolujte, či distribuovaná databáza nemá problémy s indexáciou alebo padnuté shardy (deve sa vrátiť kľúč "status" : "green"):

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

C. Prevádzkový stav analytických podprocesov (Manager)

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

Skontrolujte interný stav mozgu Wazuh a overte, či všetky analytické fronty a logovacie motory hlásia aktívny stav (running):

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

D. Forenzné stopy a reakcia na incidenty (Logy v reálnom čase)

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

Kľúčové príkazy na audit chýb komunikácie alebo sledovanie bezpečnostných incidentov v sieti za behu:

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