Architektúra Wazuh a nasadenie s Docker Compose
Sprievodca modulárnou inštaláciou Wazuh 4.9 v Docker kontajneroch, pridelením zložitých alfanumerických prihlasovacích údajov a mapa presmerovania bezpečnostných portov.
Táto príručka podrobne popisuje štandardný technický postup nasadenia Wazuh 4.9 v Dockerizovanom prostredí s jedným uzlom (single-node). Tento modul sa zaoberá plánovaním zdrojov, prípravou prostredia hostiteľa, štruktúrou súboru docker-compose.yml a architektúrou presmerovania bezpečnej sietovej komunikácie.
1. Plánovanie poverení a zabezpečenie
Sección titulada «1. Planificación de Credenciales y Endurecimiento»Aby sa predišlo chybám pri parsovaní počas inicializácie kontajnerov Docker engine (ako napríklad nesprávna interpretácia špeciálnych znakov $ alebo * vo súboroch YAML) a aby sa prísne dodržali bezpečnostné pokyny Wazuh, bola definovaná matica alfanumerických prihlasovacích údajov s vysokou entropiou pre hlavné služby:
| Komponent / Služba | Identita / Používateľ | Fiktívne vzorové heslo | Poznámky k integrácii |
|---|---|---|---|
| Rozhranie Wazuh (Indexer) | admin | zR9mK2vX5pW8qN3tY6cR4vB1 | Hlavný prístupový účet pre webovú správu. |
| Interné API Wazuh | wazuh-wui | mP5nT8qB2vK9wR3xY6cS4dB9. | Je povinné skončiť bodkou . na dodržanie smernice o symboloch. |
| Komunikačná služba | kibanaserver | yQ3wV8xR9pK2mN6tT5sR4vC1 | Účet používaný na internú komunikáciu medzi uzlami. |
2. Príprava prostredia na hostiteľovi (Ubuntu)
Sección titulada «2. Aprovisionamiento del Entorno en el Host (Ubuntu)»Celé nasadenie sa zkonsoliduje pod adresárom hostiteľa: /opt/wazuh-stack/single-node.
A. Klonovanie vetvy oficiálneho repozitára
Sección titulada «A. Clonar la Rama del Repositorio Oficial»Wazuh vyžaduje certifikáty SSL/TLS na šifrovanie komunikácie end-to-end medzi tromi hlavnými kontejnermi (Indexer, Manager a Dashboard). Prihláste sa do konzoly hostiteľa a sklonujte presnú certifikovanú verziu (v4.9.0):
# 1. Crear el directorio y clonar el repositorio oficial de desplieguesudo mkdir -p /opt/wazuh-stacksudo chown -R $USER:$USER /opt/wazuh-stackgit clone https://github.com/wazuh/wazuh-docker.git -b v4.9.0 /opt/wazuh-stack
# 2. Posicionarse en el directorio del nodo únicocd /opt/wazuh-stack/single-nodeB. Generovanie certifikačnej autority a TLS certifikátov
Sección titulada «B. Generación de la Autoridad de Certificación y Certificados TLS»Inicializujte dočasný generátorový kontajner na automatické zabezpečenie infraštruktúry verejných kľúčov (PKI) a digitálnych podpisov služieb:
sudo docker compose -f generate-indexer-certs.yml run --rm generator3. Produkčný súbor Docker Compose
Sección titulada «3. Archivo Docker Compose de Producción»Tento súbor obsahuje konečnú deklaráciu služieb, optimalizované limity pamäte jadra a počiatočné statické poverenia prostredia.
Cesta k súboru: /opt/wazuh-stack/single-node/docker-compose.yml
# Wazuh App Copyright (C) 2017, Wazuh Inc. (License GPLv2)services: wazuh.manager: image: wazuh/wazuh-manager:4.9.0 hostname: wazuh.manager restart: always ports: - "1514:1514" - "1515:1515" - "514:514/udp" - "55000:55000" ulimits: memlock: soft: -1 hard: -1 nofile: soft: 655360 hard: 655360 environment: - INDEXER_URL=https://wazuh.indexer:9200 - INDEXER_USERNAME=admin - INDEXER_PASSWORD=zR9mK2vX5pW8qN3tY6cR4vB1 - FILEBEAT_SSL_VERIFICATION_MODE=full - SSL_CERTIFICATE_AUTHORITIES=/etc/ssl/root-ca.pem - SSL_CERTIFICATE=/etc/ssl/filebeat.pem - SSL_KEY=/etc/ssl/filebeat.key - API_USERNAME=wazuh-wui - API_PASSWORD=mP5nT8qB2vK9wR3xY6cS4dB9. - TZ=Europe/Madrid volumes: - wazuh_api_configuration:/var/ossec/api/configuration - wazuh_etc:/var/ossec/etc - wazuh_logs:/var/ossec/logs - wazuh_queue:/var/ossec/queue - wazuh_var_multigroups:/var/ossec/var/multigroups - wazuh_integrations:/var/ossec/integrations - wazuh_active_response:/var/ossec/active-response/bin - wazuh_agentless:/var/ossec/agentless - wazuh_wodles:/var/ossec/wodles - filebeat_etc:/etc/filebeat - filebeat_var:/var/lib/filebeat - ./config/wazuh_indexer_ssl_certs/root-ca-manager.pem:/etc/ssl/root-ca.pem - ./config/wazuh_indexer_ssl_certs/wazuh.manager.pem:/etc/ssl/filebeat.pem - ./config/wazuh_indexer_ssl_certs/wazuh.manager-key.pem:/etc/ssl/filebeat.key - ./config/wazuh_cluster/wazuh_manager.conf:/wazuh-config-mount/etc/ossec.conf
wazuh.indexer: image: wazuh/wazuh-indexer:4.9.0 hostname: wazuh.indexer restart: always ports: - "9200:9200" environment: - "OPENSEARCH_JAVA_OPTS=-Xms1g -Xmx1g" - TZ=Europe/Madrid ulimits: memlock: soft: -1 hard: -1 nofile: soft: 65536 hard: 65536 volumes: - wazuh-indexer-data:/var/lib/wazuh-indexer - ./config/wazuh_indexer_ssl_certs/root-ca.pem:/usr/share/wazuh-indexer/certs/root-ca.pem - ./config/wazuh_indexer_ssl_certs/wazuh.indexer-key.pem:/usr/share/wazuh-indexer/certs/wazuh.indexer.key - ./config/wazuh_indexer_ssl_certs/wazuh.indexer.pem:/usr/share/wazuh-indexer/certs/wazuh.indexer.pem - ./config/wazuh_indexer_ssl_certs/admin.pem:/usr/share/wazuh-indexer/certs/admin.pem - ./config/wazuh_indexer_ssl_certs/admin-key.pem:/usr/share/wazuh-indexer/certs/admin-key.pem - ./config/wazuh_indexer/wazuh.indexer.yml:/usr/share/wazuh-indexer/opensearch.yml - ./config/wazuh_indexer/internal_users.yml:/usr/share/wazuh-indexer/opensearch-security/internal_users.yml
wazuh.dashboard: image: wazuh/wazuh-dashboard:4.9.0 hostname: wazuh.dashboard restart: always ports: - "443:5601" environment: - INDEXER_USERNAME=admin - INDEXER_PASSWORD=zR9mK2vX5pW8qN3tY6cR4vB1 - WAZUH_API_URL=https://wazuh.manager - DASHBOARD_USERNAME=kibanaserver - DASHBOARD_PASSWORD=yQ3wV8xR9pK2mN6tT5sR4vC1 - API_USERNAME=wazuh-wui - API_PASSWORD=mP5nT8qB2vK9wR3xY6cS4dB9. - TZ=Europe/Madrid volumes: - ./config/wazuh_indexer_ssl_certs/wazuh.dashboard.pem:/usr/share/wazuh-dashboard/certs/wazuh-dashboard.pem - ./config/wazuh_indexer_ssl_certs/wazuh.dashboard-key.pem:/usr/share/wazuh-dashboard/certs/wazuh-dashboard-key.pem - ./config/wazuh_indexer_ssl_certs/root-ca.pem:/usr/share/wazuh-dashboard/certs/root-ca.pem - ./config/wazuh_dashboard/opensearch_dashboards.yml:/usr/share/wazuh-dashboard/config/opensearch_dashboards.yml - ./config/wazuh_dashboard/wazuh.yml:/usr/share/wazuh-dashboard/data/wazuh/config/wazuh.yml - wazuh-dashboard-config:/usr/share/wazuh-dashboard/data/wazuh/config - wazuh-dashboard-custom:/usr/share/wazuh-dashboard/plugins/wazuh/public/assets/custom depends_on: - wazuh.indexer links: - wazuh.indexer:wazuh.indexer - wazuh.manager:wazuh.manager
networks: default: name: wazuh_local
volumes: wazuh_api_configuration: wazuh_etc: wazuh_logs: wazuh_queue: wazuh_var_multigroups: wazuh_integrations: wazuh_active_response: wazuh_agentless: wazuh_wodles: filebeat_etc: filebeat_var: wazuh-indexer-data: wazuh-dashboard-config: wazuh-dashboard-custom:4. Mapa smerovania portov (Bezpečnostná sieť)
Sección titulada «4. Mapa de Enrutamiento de Puertos (Red de Seguridad)»Aby analytici Blue Teamu mohli správne nakonfigurovať pravidlá perimeter filtračnej bezpečnosti (ako napríklad pfSense firewall alebo hostiteľské politiky), uvádza sa technická funkcia namapovaných portov:
A. Kontejner: wazuh.manager (Analytické jadro)
Sección titulada «A. Contenedor: wazuh.manager (Cerebro de Análisis)»1514(TCP/UDP) - Agenti: Kritický komunikačný port. Vzdialené zberné agenty sem posielajú svoje dešifrované logy a metadáta v reálnom čase.1515(TCP) - Authd: Port služby registrácie agentov. Používa sa výhradne pri párovaní nového uzla na vygenerovanie a prenos symetrického šifrovacieho kľúča.514(UDP) - Syslog: Voliteľná služba na zber sieťových logov z zariadení, ktoré nepodporujú natívne agenty (ako sú routery, pfSense firewally a prepínače).55000(TCP) - API REST: Kontrolné rozhranie manažéra. Používa ho dashboard na spracovanie interných administratívnych požiadaviek.
B. Kontejner: wazuh.indexer (Úložište)
Sección titulada «B. Contenedor: wazuh.indexer (Almacenamiento)»9200(TCP) - OpenSearch API: Port na čítanie/zápis indexovacej databázy. Filebeat sem vkladá upozornenia a dashboard ich získava na zobrazenie v grafoch.
C. Kontejner: wazuh.dashboard (Webová konzola)
Sección titulada «C. Contenedor: wazuh.dashboard (Consola Web)»443 ➔ 5601(TCP) - HTTPS portál: Interná služba využíva port5601, ale v Dockeri je namapovaná na štandardný port 443 (HTTPS) hostiteľa, aby umožnila čistý a priamy prístup z prehliadača bez nutnosti špecifikovať atypické porty.
5. Inicializácia kontajnerov
Sección titulada «5. Inicialización de Contenedores»Po vytvorení štruktúry súboru docker-compose.yml spustite infraštruktúru na pozadí:
sudo docker compose up -dBezpečnostné upozornenie
Aj keď kontajnery správne inicializujú v motore Docker, suite nebude funkčná ani bezpečná, kým sa vygenerujú a neinjektujú podrobné šifrované hashovacie hodnoty uvedené v nasledujúcom dokumente.

