Ir al contenido

Architektura Wazuh a nasazení pomocí Docker Compose

Průvodce modulárním nasazením Wazuh 4.9 v kontejnerech Docker, přiřazování složitých alfanumerických přihlašovacích údajů a mapa směrování bezpečnostních portů.

0čtení

Esta guía detalla el procedimiento técnico estándar para el despliegue de Wazuh 4.9 en un entorno Dockerizado de nodo único (single-node). Este módulo aborda la planificación de recursos, la preparación del entorno del host, la estructuración del archivo docker-compose.yml y la arquitectura de enrutamiento de red de seguridad.


Aby se předešlo chybám při parsování během inicializace kontejnerů motorem Docker (jako je nesprávná interpretace speciálních znaků, jako jsou $ nebo *, ve souborech YAML) a aby byly přísně dodrženy bezpečnostní pokyny Wazuh, byla pro hlavní služby definována matice alfanumerických přihlašovacích údajů s vysokou entropií:

Komponenta / SlužbaIdentita / UživatelFiktivní ukázkové hesloPoznámky k integraci
Rozhraní Wazuh (Indexer)adminzR9mK2vX5pW8qN3tY6cR4vB1Hlavní přístupový účet pro webovou správu.
Interní API Wazuhwazuh-wuimP5nT8qB2vK9wR3xY6cS4dB9.Povinné ukončit tečkou . pro dodržení pravidla o symbolech.
Komunikační službakibanaserveryQ3wV8xR9pK2mN6tT5sR4vC1Účet používaný pro interní komunikaci mezi uzly.

Celé nasazení bude konsolidováno pod adresářem hostitele: /opt/wazuh-stack/single-node.

A. Klonování větve oficiálního repozitáře

Sección titulada «A. Clonar la Rama del Repositorio Oficial»

Wazuh vyžaduje certifikáty SSL/TLS pro koncové šifrování komunikace mezi svými třemi hlavními kontejnery (Indexer, Manager a Dashboard). Přistupte ke své konzoli hostitele a naklonujte přesnou certifikovanou verzi (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ý kontejner pro automatické zajištění infrastruktury veřejných klíčů (PKI) a digitálních podpisů služeb:

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

Tento soubor obsahuje konečnou deklaraci služeb, optimalizované limity paměti jádra a počáteční statická pověření prostředí.

Cesta k souboru: /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 směrování portů (Bezpečnostní síť)

Sección titulada «4. Mapa de Enrutamiento de Puertos (Red de Seguridad)»

Aby analytici Blue Teamu mohli správně nakonfigurovat pravidla síťové ochrany (jako jsou firewally pfSense nebo zásady hostitele), zde je podrobný technický popis mapovaných portů:

  • 1514 (TCP/UDP) - Agenté: Kritický komunikační port. Vzdálení sběrací agenti zde v reálném čase odesílají své dešifrované logy a metadata.
  • 1515 (TCP) - Authd: Port služby registrace agentů. Používá se výhradně při párování nového uzlu pro generování a přenos symetrického šifrovacího klíče.
  • 514 (UDP) - Syslog: Volitelná služba pro sběr síťových logů ze zařízení, která nepodporují nativní agenty (jako jsou routery, firewally pfSense a přepínače).
  • 55000 (TCP) - API REST: Řídicí rozhraní manažera. Dashboard jej využívá ke zpracování interních administrativních dotazů.
  • 9200 (TCP) - OpenSearch API: Port pro čtení/zápis indexovací databáze. Filebeat sem vkládá upozornění a Dashboard je následně odebírá pro jejich zobrazení v grafech.

C. Kontejner: wazuh.dashboard (Webová konzole)

Sección titulada «C. Contenedor: wazuh.dashboard (Consola Web)»
  • 443 ➔ 5601 (TCP) - HTTPS portál: Interní služba využívá port 5601, ale v Dockeru je mapována na standardní port 443 (HTTPS) hostitele, což umožňuje čistý a přímý přístup z prohlížeče bez nutnosti specifikovat neobvyklé porty.

Jakmile je soubor docker-compose.yml strukturován, spustí se infrastruktura na pozadí:

Ventana de terminal
sudo docker compose up -d

Bezpečnostní varování

I když se kontejnery v Docker enginu úspěšně inicializují, sada nebude funkční ani bezpečná, dokud nebudou vygenerovány a vloženy šifrované hashe podrobně popsané v následující dokumentaci.