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é.
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 / Service | Identité / Utilisateur | Mot de passe fictif d'exemple | Notes d'intégration |
|---|---|---|---|
| Interface de Wazuh (Indexer) | admin | zR9mK2vX5pW8qN3tY6cR4vB1 | Compte d'accès principal pour l'administration web. |
| API interne de Wazuh | wazuh-wui | mP5nT8qB2vK9wR3xY6cS4dB9. | Obligatoire de terminer par un point . pour respecter la directive des symboles. |
| Service de communication | kibanaserver | yQ3wV8xR9pK2mN6tT5sR4vC1 | Compte 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.
A. Cloner la branche du dépôt officiel
Sección titulada «A. Clonar la Rama del Repositorio Oficial»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):
# 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. 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 :
sudo docker compose -f generate-indexer-certs.yml run --rm generator3. Fichier Docker Compose de production
Sección titulada «3. Archivo Docker Compose de Producción»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 :
A. Conteneur : wazuh.manager (Cerveau d'analyse)
Sección titulada «A. Contenedor: wazuh.manager (Cerebro de Análisis)»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.
B. Conteneur : wazuh.indexer (Stockage)
Sección titulada «B. Contenedor: wazuh.indexer (Almacenamiento)»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 port5601, 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.
5. Initialisation des conteneurs
Sección titulada «5. Inicialización de Contenedores»Une fois le fichier docker-compose.yml structuré, lancez l'infrastructure en arrière-plan :
sudo docker compose up -dAvertissement 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.

