WazuhのアーキテクチャとDocker Composeによるデプロイ
Wazuh 4.9のモジュール化デプロイガイド、複雑なアルファベット・数字の資格情報の割り当て、およびセキュリティポートのルーティングマップ。
本ガイドでは、単一ノードのDocker化環境(single-node)へのWazuh 4.9展開の標準的な技術手順について詳しく説明します。このモジュールでは、リソース計画、ホスト環境の準備、docker-compose.ymlファイルの構成、およびセキュリティネットワークルーティングアーキテクチャについて扱います。
1. 資格情報の計画とハーデニング
Sección titulada «1. Planificación de Credenciales y Endurecimiento»Dockerエンジンによるコンテナ初期化時(YAMLファイル内の$や*のような特殊文字の誤った解釈など)のパースエラーを回避し、Wazuhのセキュリティポリシーを厳密に遵守するために、主要サービス向けに高エントロピーの英数字クレデンシャルマトリックスを定義しました:
| コンポーネント / サービス | ID / ユーザー | 架空の例のパスワード | 統合ノート |
|---|---|---|---|
| Wazuhインターフェース(インデクサー) | admin | zR9mK2vX5pW8qN3tY6cR4vB1 | メインのWeb管理アクセスアカウントです。 |
| 内部Wazuh API | wazuh-wui | mP5nT8qB2vK9wR3xY6cS4dB9. | .ピリオドで終了が必須です(記号ポリシーに準拠するため)。 |
| 通信サービス | kibanaserver | yQ3wV8xR9pK2mN6tT5sR4vC1 | ノード間の内部通信に使用されるアカウントです。 |
2. ホスト環境のプロビジョニング(Ubuntu)
Sección titulada «2. Aprovisionamiento del Entorno en el Host (Ubuntu)»完全な展開は、ホストのディレクトリ/opt/wazuh-stack/single-nodeの下に統合されます。
A. 公式リポジトリブランチのクローン
Sección titulada «A. Clonar la Rama del Repositorio Oficial»Wazuhは、3つの主要コンテナー(Indexer、Manager、Dashboard)間の通信をエンドツーエンドで暗号化するためにSSL/TLS証明書を必要とします。ホストコンソールにアクセスし、認定された正確なバージョン(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. 証明機関とTLS証明書の生成
Sección titulada «B. Generación de la Autoridad de Certificación y Certificados TLS»一時的なジェネレーターコンテナを初期化して、公開鍵インフラストラクチャ(PKI)とサービスのデジタル署名を自動プロビジョニングします:
sudo docker compose -f generate-indexer-certs.yml run --rm generator3. プロダクション用Docker Composeファイル
Sección titulada «3. Archivo Docker Compose de Producción»このファイルには、最適化されたカーネルメモリ制限と環境の初期静的資格情報が含まれています。
ファイルパス:/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. ポートルーティングマップ(セキュリティネットワーク)
Sección titulada «4. Mapa de Enrutamiento de Puertos (Red de Seguridad)»ブルーチームの分析者が境界フィルタリングルール(pfSenseファイアウォールやホストポリシーなど)を正しく構成できるようにするため、マッピングされたポートの技術的機能が以下に記載されています:
A. コンテナー:wazuh.manager(分析の中核)
Sección titulada «A. Contenedor: wazuh.manager (Cerebro de Análisis)»1514(TCP/UDP) - エージェント:重要な通信ポートです。リモート収集エージェントが、復号化されたログとメタデータをリアルタイムでここに送信します。1515(TCP) - Authd:エージェント登録サービスのポートです。新しいノードをペアリングして対称暗号化キーを生成・送信する際にのみ使用されます。514(UDP) - Syslog:ネイティブエージェントをサポートしないデバイス(ルーター、pfSenseファイアウォール、スイッチなど)のネットワークログを収集するためのオプションサービスです。55000(TCP) - REST API:Managerの制御インターフェースです。ダッシュボードが内部管理クエリを処理するために使用します。
B. コンテナー:wazuh.indexer(ストレージ)
Sección titulada «B. Contenedor: wazuh.indexer (Almacenamiento)»9200(TCP) - OpenSearch API:インデックスデータベースの読み取り/書き込みポートです。Filebeatがアラートをここに投入し、ダッシュボードがそれを取得してグラフに表示します。
C. コンテナー:wazuh.dashboard(Webコンソール)
Sección titulada «C. Contenedor: wazuh.dashboard (Consola Web)»443 ➔ 5601(TCP) - HTTPSポータル:内部サービスはポート5601を使用しますが、Docker上でホストの標準ポート443 (HTTPS)にマッピングされ、ブラウザから特異なポートを指定せずにクリーンかつ直接アクセスできます。
docker-compose.ymlファイルの構成が完了したら、バックグラウンドでインフラストラクチャを起動します:
sudo docker compose up -dセキュリティ警告
Dockerエンジンでコンテナが正しく初期化されたとしても、以下のドキュメントに記載された暗号化ハッシュが生成され注入されるまで、スーツは機能的またはセキュアではありません。

