Ir al contenido

Troubleshooting y Monitorización de Wazuh

Resolución de errores de configuración en docker compose, excepciones 5007 de contraseña insegura, corrupción de inodos y comandos de auditoría Blue Team.

0lectures

Esta guía técnica recopila las incidencias críticas detectadas durante las fases de arquitectura, despliegue e integración de la plataforma de seguridad Wazuh 4.9 bajo Docker, junto con sus respectivos flujos de diagnóstico e instrucciones operativas de auditoría para analistas del Blue Team.


1. Bitácora de Errores Críticos y Resoluciones de Arquitectura

Sección titulada «1. Bitácora de Errores Críticos y Resoluciones de Arquitectura»

Incidencia 1: Fallo en Autenticación por Interpolación de Variables ($)

Sección titulada «Incidencia 1: Fallo en Autenticación por Interpolación de Variables ($)»
  • Síntoma de Error: Los contenedores rechazaban las contraseñas complejas iniciales y arrojaban excepciones criptográficas en los logs de inicialización.
  • Diagnóstico de Sistemas: El motor de Docker Compose interpreta nativamente el carácter especial $ en los archivos de configuración YAML como una directiva de llamada o interpolación de variables locales del sistema anfitrión. Al contener la clave del admin un carácter especial, se inyectaba una contraseña truncada.
  • Resolución Aplicada: Reemplazo integral del diccionario de claves por contraseñas complejas alfanuméricas de alta entropía sin símbolos de escape en conflictos.
  • Síntoma d'error: La consulta de contenidors informava al gestor wazuh.manager en un bucle continu de reinici. L'auditoria de logs mostrava l'excepció: wazuh.core.exception.WazuhError: Error 5007 - Insecure user password provided.
  • Diagnòstic de Sistemes: El firmware de Wazuh a partir de la seva versió 4.9 impone una directiva de duresa de contrassenya (Password Hardening) estricta per a la API REST. Requereix obligatoriament la presencia combinada de majuscula, minúscula, dígits i almenys un símbol especial de puntuació.
  • Resolució Aplicada: Modificació de la clau de la API (mP5nT8qB2vK9wR3xY6cS4dB9.) introduint un punt . al final de la mateixa per complir els requisits del validador d'expressions regulares nativa.

Incidència 3: Corrupció per Inodos del Arxiu internal_users.yml

Sección titulada «Incidencia 3: Corrupción por Inodos del Archivo internal_users.yml»
  • Síntoma d'Error: El motor OpenSearch rechazava els comandos de sincronització alegant que les identitats no existien en les taules de credenciales. L'arxiu apareixia completament buit en l'interior del contenedor.
  • Diagnòstic de Sistemes: Col·lisió d'inodos a nivell de sistema de fitxers al intentar montar i modificar en viu un arxiu de host cap a un volum de Docker. OpenSearch vaciava els metadats per reescriurels, perdia la referència física.
  • Resolución Aplicada: Diseño de un proceso asíncrono robusto:
    1. Generar hashes bcrypt de forma aislada en el contenedor.
    2. Modificar físicament l'arxiu original directament des del host.
    3. Forzar la lectura utilizando la firma SSL del script securityadmin.sh.

Incidència 4: Cuelgue de Carga Perpetu “Wazuh dashboard server is not ready yet”

Sección titulada «Incidencia 4: Cuelgue de Carga Perpetuo “Wazuh dashboard server is not ready yet”»
  • Síntoma d'Error: Tras la purga de volumens del sistema, el frontend web permanecia inaccesible de forma perpetua.
  • Diagnòstic de Sistemes: La instrucció down -v destrueix les bases de dades locals montades en el host. Al levantar el clúster, OpenSearch es inicialitza amb les seves hashes predeterminades de fàbrica, rompint la comunicació amb el Dashboard que utilitza les claus complexes.
  • Resolució Aplicada: Es mandatori re-ejecutar per complet el Paso 1 (Sincronització de Hashes Criptogràfics) del Mòdul 2 tras cada purga de volum de clúster.

Incidència 5: Crash-Loop del Dashboard per Claus Duplicades (Duplicated Mapping Key)

Sección titulada «Incidencia 5: Crash-Loop del Dashboard por Claves Duplicadas (Duplicated Mapping Key)»
  • Síntoma d'error: El contènidor web wazuh.dashboard s'aturava emetint a la seva traça d'error: FATAL Error: Error getting configuration: duplicated mapping key at line 8 [...] hosts:.
  • Diagnòstic de Sistemes: La interfície web intenta auto-injectar la estructura del Manager en l'arxiu wazuh.yml si no el localitza en la primera inicialització. Si l'administrador edita manualment l'arxiu a la vegada, es injecten dues claus de capçalera hosts:, invalidant la sintaxi del llenguatge de descripció YAML.
  • Resolució Aplicada: Intervenció manual: Detenir el contenedor, reconstruir l'arxiu de configuració amb una única clau hosts: limpia, i tornar a arrancar el servei.

2. Manual Operatiu de Monitorització (Comandos de Analista)

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

Comandos recomanats per verificar la salut i el rendiment del SIEM durant simulacions d'intrusió o tàctiques cotidianes de administració:

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

B. Diagnòstic de Salut de la Base de Dades (Indexer)

Sección titulada «B. Diagnóstico de Salud de la Base de Datos (Indexer)»

Verifica que la base de dades distribuïda no té problemes d'indexació o shards caïts (deu devolver la clau "status" : "verd"):

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

C. Estat Operatiu dels Subprocessos d'Anàlisi (Manager)

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

Verifica el estado interno del cerebro de Wazuh y verifica que todas las colas de análisis y motores de logs reportan estado activo (running):

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

D. Trazas Forenses e Incident Response (Logs en Tiempo Real)

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

Comands clau per auditar errors de comunicació o realitzar un seguiment d'incidents de seguretat de xarxa en calent:

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