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ů.
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.
1. Plánování pověření a zabezpečení
Sección titulada «1. Planificación de Credenciales y Endurecimiento»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žba | Identita / Uživatel | Fiktivní ukázkové heslo | Poznámky k integraci |
|---|---|---|---|
| Rozhraní Wazuh (Indexer) | admin | zR9mK2vX5pW8qN3tY6cR4vB1 | Hlavní přístupový účet pro webovou správu. |
| Interní API Wazuh | wazuh-wui | mP5nT8qB2vK9wR3xY6cS4dB9. | Povinné ukončit tečkou . pro dodržení pravidla o symbolech. |
| Komunikační služba | kibanaserver | yQ3wV8xR9pK2mN6tT5sR4vC1 | Účet používaný pro interní komunikaci mezi uzly. |
2. Zajištění prostředí na hostiteli (Ubuntu)
Sección titulada «2. Aprovisionamiento del Entorno en el Host (Ubuntu)»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):
# 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. Generování certifikační autority a certifikátů TLS
Sección titulada «B. Generación de la Autoridad de Certificación y Certificados TLS»Inicializujte dočasný generátorový kontejner pro automatické zajištění infrastruktury veřejných klíčů (PKI) a digitálních podpisů služeb:
sudo docker compose -f generate-indexer-certs.yml run --rm generator3. Produkční soubor Docker Compose
Sección titulada «3. Archivo Docker Compose de Producción»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ů:
A. Kontejner: wazuh.manager (Analytické jádro)
Sección titulada «A. Contenedor: wazuh.manager (Cerebro de Análisis)»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ů.
B. Kontejner: wazuh.indexer (Úložiště)
Sección titulada «B. Contenedor: wazuh.indexer (Almacenamiento)»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á port5601, 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.
5. Inicializace kontejnerů
Sección titulada «5. Inicialización de Contenedores»Jakmile je soubor docker-compose.yml strukturován, spustí se infrastruktura na pozadí:
sudo docker compose up -dBezpeč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.

