Ir al contenido

Troubleshooting e Monitorização de Wazuh

Resolução de erros de configuracao em docker compose, excecoes 5007 de senha insegura, corrupção de inodos e comandos de auditoria Blue Team.

0lecturas

Esta guia técnica recopila as incidências críticas detectadas durante as fases de arquitectura, despliegue e integracao da plataforma de segurança Wazuh 4.9 sob Docker, junto com seus respectivos flujos de diagnóstico e instruccoes operativas de auditoria para analistas do Blue Team.


1. Registo de Erros Críticos e Resoluções de Arquitetura

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

Incidencia 1: Falho em Autenticacao por Interpolacao de Variaveis ($)

Sección titulada «Incidencia 1: Fallo en Autenticación por Interpolación de Variables ($)»
  • Síntoma de Erro: Os contenedores rechazavam as senhas complexas iniciais e arrojavam excecoes criptograficas nos logs de inicializacao.
  • Diagnóstico de Sistemas: O motor de Docker Compose interpreta nativamente o caractere especial $ nos arquivos de configuracao YAML como uma directiva de chamada ou interpolacao de variaveis locais do sistema anfitriao. Ao contener a chave do admin um caractere especial, se injetava uma senha truncada.
  • Resolucao Aplicada: Reemplaco integral do diccionario de chaves por senhas complexas alfanumericas de alta entropia sem simbolos de escape em conflitos.

Incidente 2: Loop de Reinicialização Infinito no Contentor Manager (Erro 5007)

Sección titulada «Incidencia 2: Bucle de Reinicio Infinito en Contenedor Manager (Error 5007)»
  • Síntoma de Error: A consulta de contenedores reportava ao gestor wazuh.manager num ciclo contínuo de reinício. A auditoria de logs apresentava a exceção: wazuh.core.exception.WazuhError: Error 5007 - Insecure user password provided.
  • Diagnóstico de Sistemas: O firmware de Wazuh a partir de sua versao 4.9 impoe uma directiva de dureza de senha (Senha Hardening) estricta para a API REST. Requere obrigatoriamente a presenca combinada de maiusculas, minusculas, digitos e ao menos um símbolo especial de puntuacao.
  • Resolução Aplicada: Modificação da chave da API (mP5nT8qB2vK9wR3xY6cS4dB9.) introduzindo um ponto . ao final dela para atender aos requisitos do validador de expressões regulares nativo.

Incidente 3: Corrupção por Inodes do Arquivo internal_users.yml

Sección titulada «Incidencia 3: Corrupción por Inodos del Archivo internal_users.yml»
  • Sintoma de Erro: O motor OpenSearch rejeitava os comandos de sincronização alegando que as identidades não existiam nas tabelas de credenciais. O arquivo aparecia completamente vazio dentro do contêiner.
  • Diagnóstico de Sistemas: Colisão de inodes a nível de sistema de arquivos ao tentar montar e modificar em tempo real um arquivo do host para um volume Docker. O OpenSearch esvaziava os metadados para reescrevê-los, perdendo a referência física.
  • Resolução Aplicada: Desenho de um processo assíncrono robusto:
    1. Gerar hashes bcrypt de forma isolada no contentor.
    2. Modificar fisicamente o ficheiro original diretamente a partir do host.
    3. Forçar a leitura utilizando a assinatura SSL do script securityadmin.sh.

Incidente 4: Bloqueio de Carregamento Perpétuo “Wazuh dashboard server is not ready yet”

Sección titulada «Incidencia 4: Cuelgue de Carga Perpetuo “Wazuh dashboard server is not ready yet”»
  • Sintoma de Erro: Após a purga de volumes do sistema, o frontend web permanecia inacessível de forma perpétua.
  • Diagnóstico de Sistemas: A instrução down -v destrói os bancos de dados locais montados no host. Ao subir o cluster, o OpenSearch é inicializado com seus hashes padrão de fábrica, quebrando a comunicação com o Dashboard que utiliza as chaves complexas.
  • Reexecução Obrigatória: É obrigatório reexecutar por completo o Passo 1 (Sincronização de Hashes Criptográficos) do Módulo 2 após cada purga de volume do clúster.

Incidente 5: Crash-Loop do Dashboard por Chaves Duplicadas (Duplicated Mapping Key)

Sección titulada «Incidencia 5: Crash-Loop del Dashboard por Claves Duplicadas (Duplicated Mapping Key)»
  • Síntoma de Error: O contenedor web wazuh.dashboard parava apresentando no seu registo de erro: FATAL Error: Error getting configuration: duplicated mapping key at line 8 [...] hosts:.
  • Diagnóstico de Sistemas: A interface web tenta auto-injetar a estrutura do Manager no arquivo wazuh.yml se não o encontrar na primeira inicialização. Se o administrador editar manualmente o arquivo ao mesmo tempo, as duas chaves de cabeçalho hosts: são injetadas, invalidando a sintaxe do YAML.
  • Resolução Aplicada: Intervenção manual: Parar o contêiner, reconstruir o arquivo de configuração com uma única chave hosts: limpa e reiniciar o serviço.

2. Manual Operacional de Monitorização (Comandos de Analista)

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

Comandos recomendados para verificar a saúde e o desempenho do SIEM durante simulações de intrusão ou tarefas quotidianas de administração:

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óstico de Saúde do Banco de Dados (Indexer)

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

Verifique que a base de dados distribuída não apresenta problemas de indexação ou shards caídos (deve retornar a chave "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. Estado Operacional dos Subprocessos de Análise (Manager)

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

Verifique o estado interno do cerebro de Wazuh e certifique-se de que todas as filas de análise e motores de logs reportam estado ativo (running):

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

D. Trilhas Forenses e Incident Response (Logs em Tempo Real)

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

Comandos principais para auditar erros de comunicação ou rastrear incidentes de segurança de rede em tempo real:

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