Troubleshooting a monitoring Wazuh
Řešení konfiguračních chyb v Docker Compose, výjimky 5007 pro slabá hesla, korupce inodeů a příkazy pro audit Blue Team.
Tato technická příručka shromažďuje kritické incidenty zjištěné během fází architektury, nasazení a integrace bezpečnostní platformy Wazuh 4.9 pod Dockerem, spolu s jejich příslušnými diagnostickými postupy a provozními pokyny pro audit pro analytiky Blue Teamu.
1. Záznam kritických chyb a řešení architektury
Sección titulada «1. Bitácora de Errores Críticos y Resoluciones de Arquitectura»Incident 1: Chyba autentizace v důsledku interpolace proměnných ($)
Sección titulada «Incidencia 1: Fallo en Autenticación por Interpolación de Variables ($)»- Projev chyby: Kontejnery odmítaly počáteční složitá hesla a v logech inicializace vyvolávaly kryptografické výjimky.
- Systémová diagnostika: Engine Docker Compose interpretuje speciální znak
$ve konfiguračních souborech YAML nativně jako direktivu pro volání nebo interpolaci lokálních proměnných hostitelského systému. Protože správcovský klíč obsahoval speciální znak, docházelo k injekci zkratovaného hesla. - Aplikované řešení: Úplná výměna slovníku klíčů za složitá alfanumerická hesla s vysokou entropií bez escapovacích symbolů způsobujících konflikty.
Incident 2: Nekonečná smyčka restartů v kontejneru 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ému: Firmware Wazuh od verze 4.9 vynucuje přísnou politiku utvrzení hesel (Password Hardening) pro REST API. Vyžaduje povinnou kombinaci velkých a malých písmen, číslic a alespoň jednoho speciálního interpunkčního symbolu.
- Aplikované řešení: Úprava API klíče (
mP5nT8qB2vK9wR3xY6cS4dB9.) přidáním tečky.na konec, aby byla splněna omezení nativního validátoru regulárních výrazů.
Incidenta 3: Poškození souboru způsobené inody internal_users.yml
Sección titulada «Incidencia 3: Corrupción por Inodos del Archivo internal_users.yml»- Projev chyby: Engine OpenSearch odmítal synchronizační příkazy s tím, že identity neexistovaly v tabulkách přihlašovacích údajů. Soubor se uvnitř kontejneru jevil jako zcela prázdný.
- Diagnostika systému: Kolize inodů na úrovni souborového systému při pokusu o live montáž a úpravu souboru z hostitele do Docker voluminu. OpenSearch vymazával metadata, aby je mohl přepsat, čímž docházelo ke ztrátě fyzického odkazu.
- Resolución Aplicada: Diseño de un proceso asíncrono robusto:
- Generovat bcrypt hashe izolovaně v kontejneru.
- Fyzicky upravit původní soubor přímo z hostitele.
- Vynutit čtení pomocí SSL podpisu skriptu
securityadmin.sh.
Incident 4: Nekonečné načítání „Wazuh dashboard server is not ready yet“
Sección titulada «Incidencia 4: Cuelgue de Carga Perpetuo “Wazuh dashboard server is not ready yet”»- Symptom chyby: Po vyčištění systémových svazků zůstal webový frontend trvale nedostupný.
- Diagnostika systémů: Instrukce
down -vničí lokální databáze připojené k hostiteli. Při spuštění clusteru se OpenSearch inicializuje s výchozími továrními hashi, což přerušuje komunikaci s Dashboardem, který používá komplexní klíče. - Použitá řešení: Je nezbytné po každém vyčištění svazků clusteru zcela znovu provést Krok 1 (Synchronizace kryptografických hashů) modulu 2.
Incident 5: Crash-Loop Dashboardu kvůli duplicitním klíčům (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:. - Diagnostika systémů: Webové rozhraní se při první inicializaci pokouší automaticky injektovat strukturu manažera do souboru
wazuh.yml, pokud jej nenajde. Pokud administrátor soubor v tu samou chvíli ručně upraví, dojde k injekci dvou hlavičkových klíčůhosts:, čímž se narušuje syntaktická správnost popisného jazyka YAML. - Použitá řešení: Manuální zásah: Zastavit kontejner, znovu sestavit konfigurační soubor s jedním čistým klíčem
hosts:a znovu spustit službu.
2. Provozní manuál monitorování (Příkazy analytika)
Sección titulada «2. Manual Operativo de Monitorización (Comandos de Analista)»Doporučené příkazy pro ověření stavu a výkonu SIEM během simulací narušení nebo každodenních úloh správy:
A. Stav kontejnerové infrastruktury
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áze (Indexer)
Sección titulada «B. Diagnóstico de Salud de la Base de Datos (Indexer)»Ověřte, zda distribuovaná databáze nemá problémy s indexací nebo padlé shardy (musí vrátit klíč "status" : "green"):
sudo docker compose exec wazuh.indexer curl -X GET -k -u admin:zR9mK2vX5pW8qN3tY6cR4vB1 "https://localhost:9200/_cluster/health?pretty"C. Provozní stav analytických subprocesů (Manager)
Sección titulada «C. Estado Operativo de los Subprocesos de Análisis (Manager)»Zkontrolujte interní stav jádra Wazuh a ověřte, zda všechny analyzační fronty a logovací motory hlásí aktivní stav (running):
sudo docker compose exec wazuh.manager /var/ossec/bin/wazuh-control statusD. Forenzní stopy a reakce na incidenty (Logy v reálném čase)
Sección titulada «D. Trazas Forenses e Incident Response (Logs en Tiempo Real)»Klíčové příkazy pro audit chyb komunikace nebo sledování bezpečnostních síťových incidentů za běhu:
# 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
