Ir al contenido

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.

0čtení

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.


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.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é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:
    1. Generovat bcrypt hashe izolovaně v kontejneru.
    2. Fyzicky upravit původní soubor přímo z hostitele.
    3. 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 -v ničí 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.dashboard se 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:

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

Ověřte, zda distribuovaná databáze nemá problémy s indexací nebo padlé shardy (musí vrátit klíč "status" : "green"):

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

Zkontrolujte interní stav jádra Wazuh a ověřte, zda všechny analyzační fronty a logovací motory hlásí aktivní stav (running):

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

D. 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:

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