Ir al contenido

Architecture de Wazuh et Déploiement avec Docker Compose

Guide de déploiement modulaire de Wazuh 4.9 dans des conteneurs Docker, attribution d'identifiants alphanumériques complexes et carte de routage des ports de sécurité.

0vues

Ce guide détaille la procédure technique standard pour le déploiement de Wazuh 4.9 dans un environnement Dockerisé à nœud unique (single-node). Ce module aborde la planification des ressources, la préparation de l'environnement hôte, la structuration du fichier docker-compose.yml et l'architecture de routage du réseau de sécurité.


1. Planification des identifiants et durcissement

Sección titulada «1. Planificación de Credenciales y Endurecimiento»

Pour éviter les erreurs d'analyse (parsing) lors de l'initialisation des conteneurs par le moteur Docker (telles que l'interprétation incorrecte de caractères spéciaux comme $ ou * dans les fichiers YAML) et pour respecter strictement les directives de sécurité de Wazuh, une matrice d'identifiants alphanumériques à haute entropie a été définie pour les services principaux :

Composant / ServiceIdentité / UtilisateurMot de passe fictif d'exempleNotes d'intégration
Interface de Wazuh (Indexer)adminzR9mK2vX5pW8qN3tY6cR4vB1Compte d'accès principal pour l'administration web.
API interne de Wazuhwazuh-wuimP5nT8qB2vK9wR3xY6cS4dB9.Obligatoire de terminer par un point . pour respecter la directive des symboles.
Service de communicationkibanaserveryQ3wV8xR9pK2mN6tT5sR4vC1Compte utilisé pour la communication interne entre les nœuds.

2. Provisionnement de l'environnement sur l'hôte (Ubuntu)

Sección titulada «2. Aprovisionamiento del Entorno en el Host (Ubuntu)»

Le déploiement complet sera consolidé sous le répertoire de l'hôte : /opt/wazuh-stack/single-node.

Wazuh nécessite des certificats SSL/TLS pour chiffrer de bout en bout les communications entre ses trois conteneurs principaux (Indexer, Manager et Dashboard). Accédez à votre console d'hôte et clonez la version exacte certifiée (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

B. Génération de l'autorité de certification et des certificats TLS

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

Initialisez le conteneur générateur temporaire pour provisionner automatiquement l'infrastructure à clé publique (PKI) et les signatures numériques des services :

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

Ce fichier contient la déclaration finale des services, les limites de mémoire du noyau optimisées et les identifiants statiques initiaux de l'environnement.

Chemin du fichier : /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. Carte de routage des ports (Réseau de sécurité)

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

Afin de permettre aux analystes de la Blue Team de configurer correctement les règles de filtrage périmétrique (telles que les pare-feu pfSense ou les politiques d'hôte), la fonction technique des ports mappés est détaillée ci-dessous :

  • 1514 (TCP/UDP) - Agents : Port de communication critique. Les agents collecteurs distants y envoient leurs logs déchiffrés et leurs métadonnées en temps réel.
  • 1515 (TCP) - Authd : Port du service d'enregistrement des agents. Utilisé exclusivement lors de l'appairage d'un nouveau nœud pour générer et transmettre la clé de chiffrement symétrique.
  • 514 (UDP) - Syslog : Service optionnel pour la collecte de logs réseau d'appareils ne prenant pas en charge d'agents natifs (tels que les routeurs, les pare-feu pfSense et les commutateurs).
  • 55000 (TCP) - API REST : Interface de contrôle du Manager. Elle est consommée par le Dashboard pour traiter les requêtes d'administration interne.
  • 9200 (TCP) - API OpenSearch : Port de lecture/écriture de la base de données d'indexation. Filebeat introduit les alertes ici et le Dashboard les récupère pour les afficher dans les graphiques.

C. Conteneur : wazuh.dashboard (Console Web)

Sección titulada «C. Contenedor: wazuh.dashboard (Consola Web)»
  • 443 ➔ 5601 (TCP) - Portail HTTPS : Le service interne utilise le port 5601, mais il est mappé dans Docker sur le port standard 443 (HTTPS) de l'hôte afin de permettre des accès propres et directs depuis le navigateur sans spécifier de ports atypiques.

Une fois le fichier docker-compose.yml structuré, lancez l'infrastructure en arrière-plan :

Ventana de terminal
sudo docker compose up -d

Avertissement de sécurité

Bien que les conteneurs s'initialisent correctement dans le moteur Docker, la suite ne sera ni fonctionnelle ni sécurisée tant que les hashs chiffrés détaillés dans le document suivant n'auront pas été générés et injectés.