Ir al contenido

Wazuhのトラブルシューティングとモニタリング

docker composeの設定エラーの解決、セキュアでないパスワードの例外5007、inodeの破損、ブルーチーム監査コマンド。

0閲覧数

この技術ガイドは、Docker下での<strong>Wazuh 4.9</strong>セキュリティプラットフォームのアーキテクチャ、デプロイ、統合フェーズで検出された重要なインシデントをまとめたもので、<strong>ブルーチーム</strong>アナリスト向けの診断フローと運用監査手順が含まれています。


1. クリティカルエラーログとアーキテクチャ解決策

Sección titulada «1. Bitácora de Errores Críticos y Resoluciones de Arquitectura»

インシデント1:変数補間による認証エラー($)

Sección titulada «Incidencia 1: Fallo en Autenticación por Interpolación de Variables ($)»
  • <strong>エラーサイムプト</strong>: コンテナは初期の複雑なパスワードを拒否し、初期化ログで暗号化例外をスローしました。
  • システム診断:Docker Composeエンジンは、YAML設定ファイル内の特殊文字$を、ホストのローカルシステム変数の呼び出しまたは補間の指示としてネイティブに解釈します。管理者キーに特殊文字が含まれていたため、切り詰められたパスワードが注入されました。
  • <strong>適用された解決策</strong>: 複雑なエントロピーを持つアルファベット数字パスワードにキーディクショナリを完全に置き換えることで、衝突するエスケープ記号を回避しました。

インシデント2: マネージャーコンテナの無限再起動ループ(エラー5007)

Sección titulada «Incidencia 2: Bucle de Reinicio Infinito en Contenedor Manager (Error 5007)»
  • エラー症状:コンテナの問い合わせは、マネージャーwazuh.managerが継続的な再起動ループにあることを報告しました。ログ監査では次の例外が示されました: wazuh.core.exception.WazuhError: Error 5007 - Insecure user password provided。
  • <strong>システム診断</strong>: 4.9バージョンから、WazuhファームウェアはREST APIに対して厳格な<em>パスワードハードニング</em>指示を課しています。大文字、小文字、数字、および少なくとも1つの<strong>特殊記号</strong>の組み合わせが必須です。
  • 適用された解決策:ネイティブ正規表現バリデーターの要件を満たすため、APIキー(mP5nT8qB2vK9wR3xY6cS4dB9.)の末尾にドット(.)を追加して修正しました。

インシデント3:internal_users.ymlファイルのiノード破損

Sección titulada «Incidencia 3: Corrupción por Inodos del Archivo internal_users.yml»
  • <strong>エラーサイムプト</strong>: OpenSearchエンジンは同期コマンドを拒否し、資格証明テーブルにIDが存在しないと主張しました。ファイルはコンテナ内に完全に空っぽに見えました。
  • <strong>システム診断</strong>: ファイルシステムレベルでのインオード衝突。ホストファイルをDockerボリュームにマウントおよびライブ変更しようとしたときに発生しました。OpenSearchはメタデータを空にし、物理的な参照を失いました。
  • 適用された解決策:堅牢な非同期プロセスの設計:
    1. コンテナ内で隔離されたbcryptハッシュを生成。
    2. ホストから直接元のファイルを物理的に変更。
    3. スクリプトsecurityadmin.shのSSL署名を使用して強制的に読み込みます。

インシデント4: 無限ロードハング「Wazuhダッシュボードサーバーはまだ準備ができていません」

Sección titulada «Incidencia 4: Cuelgue de Carga Perpetuo “Wazuh dashboard server is not ready yet”»
  • <strong>エラーサイムプト</strong>: システムボリュームを削除した後、Webフロントエンドは永続的にアクセスできなくなりました。
  • システム診断:down -v命令は、ホストにマウントされたローカルデータベースを破壊します。クラスターを起動すると、OpenSearchは工場出荷時のデフォルトハッシュで初期化され、複雑なキーを使用するダッシュボードとの通信が途絶えます。
  • 適用された解決策: クラスタボリュームの全削除後、モジュール2のステップ1 (暗号ハッシュの同期)を完全に再実行することが必須です。

インシデント5: 重複マッピングキーによるダッシュボードのクラッシュループ

Sección titulada «Incidencia 5: Crash-Loop del Dashboard por Claves Duplicadas (Duplicated Mapping Key)»
  • エラー症状:Webコンテナーwazuh.dashboardが停止し、エラートレースに次を出力しました: FATAL Error: Error getting configuration: duplicated mapping key at line 8 [...] hosts:。
  • システム診断:Webインターフェースは、初回初期化時にファイルwazuh.yml内でマネージャー構造を見つけられない場合、自動注入を試みます。管理者が同時にファイルを手動で編集すると、2つのヘッダーキーhosts:が注入され、YAML記述言語の構文が無効になります。
  • 適用された解決策:手動介入:コンテナーを停止し、単一のクリーンなhosts:キーで設定ファイルを再構築し、サービスを再起動します。

2. オペレーションモニタリングマニュアル (アナリストコマンド)

Sección titulada «2. Manual Operativo de Monitorización (Comandos de Analista)»

インシデントシミュレーションまたは日常的な管理作業中のSIEMの健全性とパフォーマンスを確認するための推奨コマンド:

A. コンテナインフラストラクチャの状態

Sección titulada «A. Estado de la Infraestructura de Contenedores»
Ventana de terminal
# Comprobar estado de encendido de todos los servicios
sudo docker compose ps
# Monitorizar el consumo de recursos de CPU y RAM de cada contenedor
sudo docker stats

B. データベースの健全性診断 (インデクサ)

Sección titulada «B. Diagnóstico de Salud de la Base de Datos (Indexer)»

分散データベースにインデックス問題やダウンしたシャードがないことを確認します(キー"status" : "green"を返す必要があります):

Ventana de terminal
sudo docker compose exec wazuh.indexer curl -X GET -k -u admin:zR9mK2vX5pW8qN3tY6cR4vB1 "https://localhost:9200/_cluster/health?pretty"

C. 分析プロセスの運用状態 (マネージャー)

Sección titulada «C. Estado Operativo de los Subprocesos de Análisis (Manager)»

Wazuhの内部状態を確認し、すべての分析キューとログエンジンがアクティブ状態を報告していることを確認します(running):

Ventana de terminal
sudo docker compose exec wazuh.manager /var/ossec/bin/wazuh-control status

D. フォレンジックトレースとインシデント対応 (リアルタイムログ)

Sección titulada «D. Trazas Forenses e Incident Response (Logs en Tiempo Real)»

通信エラーの監査やリアルタイムネットワークセキュリティインシデントのトラッキングに使用するキーコマンド:

Ventana de terminal
# Monitorizar trazas de conexión del Portal Web
sudo docker compose logs -f wazuh.dashboard
# Monitorizar trazas de enlace y alertas del Indexer con el Manager
sudo docker compose logs -f wazuh.manager
# Inspeccionar logs internos de alertas caídas o bloqueos de agentes
sudo docker compose exec wazuh.manager tail -f /var/ossec/logs/ossec.log
# Visualización analítica de Alertas en Caliente (Ideal para Incident Response)
sudo docker compose exec wazuh.manager tail -f /var/ossec/logs/alerts/alerts.json