Rozwiązywanie problemów i monitorowanie Wazuh
Rozwiązywanie błędów konfiguracji w Docker Compose, wyjątki 5007 dotyczące niezabezpieczonych haseł, korupcja inodów oraz polecenia audytowe Blue Team.
Ten przewodnik techniczny gromadzi krytyczne incydenty wykryte podczas faz projektowania architektury, wdrażania i integracji platformy bezpieczeństwa Wazuh 4.9 w środowisku Docker, wraz z odpowiednimi przepływami diagnostycznymi i instrukcjami operacyjnymi audytu dla analityków Blue Team.
1. Dziennik błędów krytycznych i rozwiązań architektonicznych
Sección titulada «1. Bitácora de Errores Críticos y Resoluciones de Arquitectura»Incydent 1: Błąd uwierzytelniania spowodowany interpolacją zmiennych ($)
Sección titulada «Incidencia 1: Fallo en Autenticación por Interpolación de Variables ($)»- Objaw błędu: Kontenery odrzucały początkowe złożone hasła i generowały wyjątki kryptograficzne w logach inicjalizacyjnych.
- Diagnostyka systemowa: Silnik Docker Compose natywnie interpretuje specjalny znak
$w plikach konfiguracyjnych YAML jako dyrektywę wywołania lub interpolacji lokalnych zmiennych systemu hosta. Ponieważ klucz administratora zawierał znak specjalny, wstrzykiwane było skrócone hasło. - Zastosowane rozwiązanie: Całkowita wymiana słownika kluczy na złożone alfanumeryczne hasła o wysokiej entropii, bez znaków ucieczki powodujących konflikty.
Incydent 2: Nieskończona pętla restartów w kontenerze Manager (Błąd 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. - Diagnostyka systemowa: Firmware Wazuh, począwszy od wersji 4.9, narzuca ścisłą dyrektywę wzmacniania haseł (Password Hardening) dla API REST. Wymaga obowiązkowego połączenia wielkich i małych liter, cyfr oraz co najmniej jednego specjalnego znaku interpunkcyjnego.
- Zastosowane rozwiązanie: Modyfikacja klucza API (
mP5nT8qB2vK9wR3xY6cS4dB9.) poprzez dodanie kropki.na końcu, aby spełnić wymagania natywnego walidatora wyrażeń regularnych.
Incydent 3: Korupcja inodów pliku internal_users.yml
Sección titulada «Incidencia 3: Corrupción por Inodos del Archivo internal_users.yml»- Objaw błędu: Silnik OpenSearch odrzucał polecenia synchronizacji, twierdząc, że tożsamości nie istnieją w tabelach poświadczeń. Plik wewnątrz kontenera wydawał się całkowicie pusty.
- Diagnostyka systemowa: Kolizja inodów na poziomie systemu plików podczas próby montowania i modyfikacji na żywo pliku z hosta do wolumenu Docker. OpenSearch opróżniał metadane w celu ich nadpisania, tracąc odniesienie fizyczne.
- Zastosowane rozwiązanie: Projektowanie solidnego procesu asynchronicznego:
- Generowanie skrótów bcrypt w izolacji w kontenerze.
- Fizyczna modyfikacja oryginalnego pliku bezpośrednio z hosta.
- Wymuszanie odczytu przy użyciu podpisu SSL skryptu
securityadmin.sh.
Incydent 4: Ciągłe zawieszanie się ładowania „Wazuh dashboard server is not ready yet”
Sección titulada «Incidencia 4: Cuelgue de Carga Perpetuo “Wazuh dashboard server is not ready yet”»- Objaw błędu: Po wyczyszczeniu wolumenów systemu, frontend webowy pozostał stale niedostępny.
- Diagnostyka systemów: Instrukcja
down -vniszczy lokalne bazy danych zamontowane na hoście. Podczas uruchamiania klastra OpenSearch inicjalizuje się z domyślnymi hashami fabrycznymi, co przerywa komunikację z Dashboardem wykorzystującym złożone klucze. - Zastosowane rozwiązanie: Po każdym wyczyszczeniu wolumenu klastra konieczne jest całkowite powtórzenie Kroku 1 (Synchronizacja kryptograficznych hashy) z Modułu 2.
Incydent 5: Crash-Loop Dashboardu z powodu zduplikowanych kluczy (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:. - Diagnostyka systemów: Interfejs webowy próbuje automatycznie wstrzyknąć strukturę Managera do pliku
wazuh.yml, jeśli nie zlokalizuje go podczas pierwszej inicjalizacji. Jeśli administrator w tym samym czasie ręcznie edytuje plik, wstrzykiwane są dwa klucze nagłówkahosts:, co unieważnia składnię języka opisu YAML. - Zastosowane rozwiązanie: Interwencja manualna: zatrzymanie kontenera, przebudowanie pliku konfiguracyjnego z pojedynczym czystym kluczem
hosts:i ponowne uruchomienie usługi.
2. Instrukcja operacyjna monitorowania (Polecenia analityka)
Sección titulada «2. Manual Operativo de Monitorización (Comandos de Analista)»Zalecane polecenia do weryfikacji kondycji i wydajności SIEM podczas symulacji włamań lub codziennych zadań administracyjnych:
A. Stan infrastruktury kontenerów
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. Diagnostyka kondycji bazy danych (Indexer)
Sección titulada «B. Diagnóstico de Salud de la Base de Datos (Indexer)»Sprawdź, czy rozproszona baza danych nie ma problemów z indeksowaniem lub padniętych shardów (musi zwrócić klucz "status" : "green"):
sudo docker compose exec wazuh.indexer curl -X GET -k -u admin:zR9mK2vX5pW8qN3tY6cR4vB1 "https://localhost:9200/_cluster/health?pretty"C. Stan operacyjny podprocesów analitycznych (Manager)
Sección titulada «C. Estado Operativo de los Subprocesos de Análisis (Manager)»Sprawdź wewnętrzny stan mózgu Wazuh i upewnij się, że wszystkie kolejki analizy i silniki logów raportują stan aktywny (running):
sudo docker compose exec wazuh.manager /var/ossec/bin/wazuh-control statusD. Ślady kryminalistyczne i reagowanie na incydenty (logi w czasie rzeczywistym)
Sección titulada «D. Trazas Forenses e Incident Response (Logs en Tiempo Real)»Kluczowe polecenia do audytowania błędów komunikacji lub śledzenia incydentów bezpieczeństwa sieci na żywo:
# 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
