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.
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.
1. Záznam kritických chýb a riešení architektúry
Sección titulada «1. Bitácora de Errores Críticos y Resoluciones de Arquitectura»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.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. - 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:
- Generovať bcrypt hashe izolovane v kontajneri.
- Fyzicky upraviť pôvodný súbor priamo z hostiteľa.
- 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 -vzničí 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.dashboardse 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ľúčehosts:, č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:
A. Stav infraštruktúry kontajnerov
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. Diagnostika stavu databázy (Indexer)
Sección titulada «B. Diagnóstico de Salud de la Base de Datos (Indexer)»Skontrolujte, či distribuovaná databáza nemá problémy s indexáciou alebo padnuté shardy (deve sa vrátiť kľúč "status" : "green"):
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):
sudo docker compose exec wazuh.manager /var/ossec/bin/wazuh-control statusD. 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:
# 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
