Ir al contenido

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.

0lecturas

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.


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žbaIdentita / PoužívateľFiktívne vzorové hesloPoznámky k integrácii
Rozhranie Wazuh (Indexer)adminzR9mK2vX5pW8qN3tY6cR4vB1Hlavný prístupový účet pre webovú správu.
Interné API Wazuhwazuh-wuimP5nT8qB2vK9wR3xY6cS4dB9.Je povinné skončiť bodkou . na dodržanie smernice o symboloch.
Komunikačná službakibanaserveryQ3wV8xR9pK2mN6tT5sR4vC1Účet používaný na internú komunikáciu medzi uzlami.

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):

Ventana de terminal
# 1. Crear el directorio y clonar el repositorio oficial de despliegue
sudo mkdir -p /opt/wazuh-stack
sudo chown -R $USER:$USER /opt/wazuh-stack
git clone https://github.com/wazuh/wazuh-docker.git -b v4.9.0 /opt/wazuh-stack
# 2. Posicionarse en el directorio del nodo único
cd /opt/wazuh-stack/single-node

Inicializujte dočasný generátorový kontajner na automatické zabezpečenie infraštruktúry verejných kľúčov (PKI) a digitálnych podpisov služieb:

Ventana de terminal
sudo docker compose -f generate-indexer-certs.yml run --rm generator

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:

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:

  • 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.
  • 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 port 5601, 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.

Po vytvorení štruktúry súboru docker-compose.yml spustite infraštruktúru na pozadí:

Ventana de terminal
sudo docker compose up -d

Bezpeč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.