Ir al contenido

WazuhのアーキテクチャとDocker Composeによるデプロイ

Wazuh 4.9のモジュール化デプロイガイド、複雑なアルファベット・数字の資格情報の割り当て、およびセキュリティポートのルーティングマップ。

0閲覧数

本ガイドでは、単一ノードのDocker化環境(single-node)へのWazuh 4.9展開の標準的な技術手順について詳しく説明します。このモジュールでは、リソース計画、ホスト環境の準備、docker-compose.ymlファイルの構成、およびセキュリティネットワークルーティングアーキテクチャについて扱います。


Dockerエンジンによるコンテナ初期化時(YAMLファイル内の$や*のような特殊文字の誤った解釈など)のパースエラーを回避し、Wazuhのセキュリティポリシーを厳密に遵守するために、主要サービス向けに高エントロピーの英数字クレデンシャルマトリックスを定義しました:

コンポーネント / サービスID / ユーザー架空の例のパスワード統合ノート
Wazuhインターフェース(インデクサー)adminzR9mK2vX5pW8qN3tY6cR4vB1メインのWeb管理アクセスアカウントです。
内部Wazuh APIwazuh-wuimP5nT8qB2vK9wR3xY6cS4dB9..ピリオドで終了が必須です(記号ポリシーに準拠するため)。
通信サービスkibanaserveryQ3wV8xR9pK2mN6tT5sR4vC1ノード間の内部通信に使用されるアカウントです。

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)をクローンしてください:

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

一時的なジェネレーターコンテナを初期化して、公開鍵インフラストラクチャ(PKI)とサービスのデジタル署名を自動プロビジョニングします:

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

3. プロダクション用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ファイルの構成が完了したら、バックグラウンドでインフラストラクチャを起動します:

Ventana de terminal
sudo docker compose up -d

セキュリティ警告

Dockerエンジンでコンテナが正しく初期化されたとしても、以下のドキュメントに記載された暗号化ハッシュが生成され注入されるまで、スーツは機能的またはセキュアではありません。