Ir al contenido

Arquitetura de Wazuh e Implantação com Docker Compose

Guia de implantação modular do Wazuh 4.9 em containers Docker, atribuição de credenciais alfanuméricas complexas e mapa de roteamento de portas de segurança.

0lecturas

Este guia detalha o procedimento técnico padrão para a implantação do Wazuh 4.9 em um ambiente Dockerizado de nó único (single-node). Este módulo aborda o planejamento de recursos, a preparação do ambiente do host, a estruturação do arquivo docker-compose.yml e a arquitetura de roteamento de rede de segurança.


Para evitar erros de parsing durante a inicialização dos containers pelo motor Docker (como a interpretação incorreta de caracteres especiais como $ ou * em arquivos YAML) e cumprir estritamente as diretivas de segurança do Wazuh, foi definida uma matriz de credenciais alfanuméricas de alta entropia para os serviços principais:

Componente / ServiçoIdentidade / UsuárioSenha Fictícia de ExemploNotas de Integração
Interface do Wazuh (Indexer)adminzR9mK2vX5pW8qN3tY6cR4vB1Conta de acesso principal de administração web.
API Interna de Wazuhwazuh-wuimP5nT8qB2vK9wR3xY6cS4dB9.Obrigatório terminar em ponto . para cumprir a diretiva de símbolos.
Serviço de ComunicaçãokibanaserveryQ3wV8xR9pK2mN6tT5sR4vC1Conta utilizada para a comunicação interna entre nós.

O despliegue completo se consolidará sob o diretório do host: /opt/wazuh-stack/single-node

A. Clonar a Branch do Repositório Oficial

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

Wazuh requiere certificados SSL/TLS

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

B. Geração da Autoridade de Certificação e Certificados TLS

Sección titulada «B. Generación de la Autoridad de Certificación y Certificados TLS»

Inicialize o contêiner temporário gerador para provisionar automaticamente a infraestrutura de chaves públicas (PKI) e as assinaturas digitais dos serviços:

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

Este arquivo contém a declaração final de serviços, limites de memória de kernel otimizados e as credenciais estáticas iniciais do ambiente.

Ruta do arquivo: /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 de Roteamento de Portas (Rede de Segurança)

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

Para permitir que os analistas do Blue Team configurem corretamente as regras de filtrado perimetral (tais como firewalls pfSense ou políticas do host), se detalha a função técnica dos puertos mapeados:

A. Contenedor: wazuh.manager (Cerebro de Análisis)

Sección titulada «A. Contenedor: wazuh.manager (Cerebro de Análisis)»
  • 1514 (TCP/UDP) - Agentes: Puerto de comunicação crítico. Os agentes recopiladores remotos enviam por aqui seus logs descifrados e metadados em tempo real.
  • 1515 (TCP) - Authd: Puerto do serviço de registro de agentes. É utilizado exclusivamente ao emparejar um novo nodo para gerar e transmitir a chave de cifrado simétrico simétrica.
  • 514 (UDP) - Syslog: Servicio opcional
  • 55000 (TCP) - API REST: Interfaz de controle do Manager. É consumida pelo Dashboard para processar consultas de administração interna.

B. Contenedor: wazuh.indexer (Almacenamiento)

Sección titulada «B. Contenedor: wazuh.indexer (Almacenamiento)»
  • 9200 (TCP) - OpenSearch API: Puerto de lectura/escritura da base de dados de indexação. Filebeat introduz as alertas aqui e o Dashboard as recupera para mostrar as em gráficos.

C. Contenedor: wazuh.dashboard (Consola Web)

Sección titulada «C. Contenedor: wazuh.dashboard (Consola Web)»
  • 443 ➔ 5601 (TCP) - Portal HTTPS: O serviço interno utiliza o puerto 5601, mas é mapeado em Docker para o porto estándar 443 (HTTPS) no anfitrião para permitir acessos limpos e diretos do navegador sem especificar portos atípicos.

Uma vez estruturado o arquivo docker-compose.yml, levante a infraestrutura em segundo plano:

Ventana de terminal
sudo docker compose up -d

Aviso de Segurança

Ainda que os contenedores inicialicem corretamente no motor de Docker, a suite não será funcional nem segura até que se gerem e injetem os hashes encriptados detalhados no seguinte documento.