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.
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.managernum 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:
- Gerar hashes bcrypt de forma isolada no contentor.
- Modificar fisicamente o ficheiro original diretamente a partir do host.
- 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 -vdestró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.dashboardparava 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.ymlse não o encontrar na primeira inicialização. Se o administrador editar manualmente o arquivo ao mesmo tempo, as duas chaves de cabeçalhohosts: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:
A. Estado da Infraestrutura de Contêineres
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. 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"):
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):
sudo docker compose exec wazuh.manager /var/ossec/bin/wazuh-control statusD. 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:
# 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
