Bài 17 · Giai đoạn 3 — Bảo mật & Truy cập

Triển khai Wazuh SIEM + XDR

SIEM & XDR mã nguồn mở — phát hiện mối đe doạ thời gian thực.

VM280 · node1 Ubuntu Server 24.04 LTS 10.11.45.25 4 vCPU · 8 GB · 100 GB

Bối cảnh & Lý do triển khai

Vị trí trong chuỗi bài: Bài 17 thuộc Giai đoạn 3 — Bảo mật & Truy cập, nối tiếp Bài 16. Mailu Mail Server và đứng trước Bài 18. privacyIDEA MFA.
Mức độ cần thiết: 🔴 Bắt buộc — Security baseline của toàn hạ tầng

Trong môi trường có nhiều server và VM, log phân tán ở từng máy là "mù" bảo mật — khi bị tấn công không biết máy nào bị xâm nhập trước, không có bằng chứng để điều tra. Wazuh thu thập log tập trung, phân tích realtime và cảnh báo ngay khi có hành vi bất thường.

MụcNội dung
Ứng dụng trong DNSOC operations, incident response, audit log cho compliance (ISO 27001, PCI-DSS), phát hiện brute-force/lateral movement
Tác dụng chínhThu thập log từ 30 VM + 4 node PVE, phát hiện xâm nhập (IDS), file integrity monitoring, cảnh báo theo rule (chuyển tiếp sang TheHive ở bài 35 và Mattermost ở bài 37)
Nếu không triển khaiKhông có visibility khi bị tấn công, không đáp ứng yêu cầu audit, điều tra sự cố mất hàng ngày
Các service phụ thuộc vào đâyToàn bộ VM cài Wazuh agent để gửi log về
TrườngGiá trị
VMID280
Hostnamewazuh-siem
IP10.11.45.25/24
Gateway10.11.45.1
DNS10.11.45.53 (Pi-hole VM247)
VLANVLAN_MGMT (tag 45)
Node PVEnode1 (10.11.45.210)
vCPU4
RAM8 GB
Disk100 GB (Ceph pool vm-ceph)
OSUbuntu Server 24.04 LTS
ClusterHOATRANHUB (PVE 9.2.20)

Danh sách máy chủ & IP liên quan

Bảng dưới liệt kê các máy chủ mà bài này tạo hoặc kết nối tới. Địa chỉ, VMID, VLAN và node lấy từ bảng quy hoạch chung của lab, dùng thống nhất cho cả bộ bài lab.

Máy chủIPVLAN · NodeVai trò trong bài này
wazuh-siem (Wazuh SIEM) · VM28010.11.45.2545 (MGMT) · node1Máy chủ của bài — chạy Wazuh 4.14.9 (manager, indexer, dashboard) bằng Docker Compose; dashboard 443, agent 1514/1515, API 55000.
node1 (Proxmox VE)10.11.45.21045 (MGMT) · cluster HOATRANHUBNode Proxmox chứa VM280; tạo VM tại đây (qm create) và chạy vzdump backup thủ công lần đầu.
pihole (Pi-hole DNS) · VM24710.11.45.5345 (MGMT) · node3DNS của VM280; thêm bản ghi A wazuh-siem.hoatranlabs.local cho Wazuh (bài 12) để mở dashboard bằng tên.
ops01 (Ansible/OpenTofu + bastion) · VM29010.11.45.2045 (MGMT) · node2Máy quản trị/tự động hoá (bài 07, Ubuntu 24.04): cài Wazuh agent 4.14.9 như VM Linux thứ 31 (mục 7.5) và có thể chạy vòng lặp SSH cài agent hàng loạt.
pbs01 (PBS Primary) · VM10110.11.45.1745 (MGMT) · node4Nhận backup job VM280 (storage pbs-primary): snapshot daily 02:00, retention do Prune Job trên PBS quản lý; xác nhận bản backup trên PBS UI cổng 8007.
FortiGate (firewall)10.100.100.1Quản trị 10.100.100.0/24 · thiết bị mạngTạo rule cho agent về Wazuh: 1514 TCP từ các VLAN, 1515 enrollment, 443 dashboard và 55000 API từ VLAN 45; API quản lý qua HTTPS.

Gateway của mỗi VLAN là địa chỉ .1. Tên DNS nội bộ do Pi-hole phân giải (bài 12). Tên in đậm là hostname; FQDN = hostname + .hoatranlabs.local. Wazuh agent cài trên mọi VM (mục 7) và trỏ về Manager cổng 1514/1515, nên bảng không kê từng máy.

Phụ thuộc (Dependencies)

Pi-hole VM247 (10.11.45.53)  — KHÔNG bắt buộc khi cài, nhưng cần có để resolve wazuh-siem.hoatranlabs.local
PBS pbs01 VM101 (10.11.45.17) — cần có trước khi cấu hình backup job
FortiGate (10.100.100.1)     — cần mở port trước khi agent các VM khác có thể kết nối

Thứ tự triển khai khuyến nghị:

  1. Pi-hole (VM247) — DNS nội bộ
  2. PBS (pbs01, VM101) — backup
  3. Wazuh SIEM (VM280) ← file này
  4. Các agent cài sau khi VM280 đã hoạt động
01

Tổng Quan

Ba thành phần chính · Wazuh Agent · Phiên bản phần mềm sử dụng

Wazuh là nền tảng SIEM/XDR (Security Information and Event Management / Extended Detection & Response) mã nguồn mở, được dùng để thu thập, phân tích, và phản hồi các sự kiện bảo mật trong hạ tầng.

Ba thành phần chính

Thành phầnVai trò
wazuh-managerNhận log từ agent, phân tích, kích hoạt rule, lưu event vào indexer
wazuh-indexerLưu trữ dữ liệu dựa trên OpenSearch (Elasticsearch fork của Amazon)
wazuh-dashboardGiao diện web dựa trên OpenSearch Dashboards (fork của Kibana)

Wazuh Agent

Agent được cài trên mỗi VM trong hạ tầng, chạy nền, thu thập log hệ thống, file integrity, process monitor, và gửi về wazuh-manager qua port 1514.

Phiên bản phần mềm sử dụng

Đã xác minh 2026-10-15 (nguồn: documentation.wazuh.com/current/release-notes, github.com/wazuh/wazuh-docker/releases, Docker Hub wazuh/*, packages.wazuh.com/4.x/apt, Docker Engine repo noble). Bài này nâng Wazuh từ 4.9.2 lên 4.14.9, bản stable mới nhất của dòng 4.14:

Thành phầnPhiên bảnGhi chú
Hệ điều hành VM280Ubuntu Server 24.04 LTS "Noble Numbat" (ISO ubuntu-24.04.5-live-server-amd64.iso)Kernel 6.8, systemd 255, netplan 1.0, APT 2.7, hỗ trợ chuẩn tới 04/2029. Bản point mới nhất thấy trên releases.ubuntu.com/24.04 là 24.04.5 (cần kiểm lại khi tải ISO). Tài liệu Wazuh 4.14 (quickstart) liệt kê Ubuntu 24.04 trong các OS khuyến nghị cho thành phần trung tâm (bài này chạy các thành phần trong container).
Docker Engine + plugin Compose29.9.1 (docker-ce, đăng lên repo ngày 2026-10-14) + plugin Compose 5.6.0, từ repo download.docker.com/linux/ubuntu noble stableGói docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin, lệnh docker compose. Số bản đọc từ thư mục dists/noble/pool/stable/amd64/ của repo ngày 2026-10-15 (containerd.io 2.4.2-2, buildx 0.38.0-1); apt sẽ lấy bản mới nhất trong repo lúc cài nên có thể cao hơn. Tài liệu Wazuh Docker yêu cầu Docker Engine và Compose bản stable mới nhất, Git, host tối thiểu 4 core, 8 GB RAM, 50 GB đĩa (single-node). Docker rootful nên không bị giới hạn user namespace của AppArmor 4.
Wazuh manager, indexer, dashboard4.14.9 (phát hành 2026-10-14; repo wazuh-docker, tag v4.14.9; image wazuh/wazuh-manager:4.14.9, wazuh/wazuh-indexer:4.14.9, wazuh/wazuh-dashboard:4.14.9)Bản stable mới nhất của dòng 4.14 (4.14.7 ngày 2026-07-29, 4.14.8 ngày 2026-09-23). Wazuh 5.0 mới ở mức beta/rc (v5.0.0-rc1 ngày 2026-10-05) nên không dùng. Mọi thành phần trung tâm phải cùng số phiên bản, kể cả số patch. Lý do chọn 4.14.9: xem hộp "Vì sao 4.14.9" bên dưới.
Công cụ sinh chứng chỉwazuh/wazuh-certs-generator:0.0.4 (biến CERT_TOOL_VERSION=4.14 có sẵn trong generate-indexer-certs.yml)Bản 4.9.2 dùng generator 0.0.2.
Wazuh agent4.14.9-1 (wazuh-agent=4.14.9-1, apt-mark hold)Phải khớp (không mới hơn) manager. Đã kiểm chỉ mục dists/stable/main/binary-amd64/Packages của repo APT Wazuh có wazuh-agent 4.14.9-1 (phụ thuộc libc6, lsb-release, debconf, adduser, procps, đều có trên noble). Trang cài agent Linux của tài liệu Wazuh 4.14 không nêu riêng Ubuntu 24.04; chạy agent .deb thực tế trên 24.04 cần kiểm lại trên máy thật.
Repo APT của agenthttps://packages.wazuh.com/4.x/apt/ suite stable, khóa GPG-KEY-WAZUHKhông dùng codename Ubuntu nên không đổi theo noble. Nguồn deb822 + Signed-By. Khóa có vân tay 0DCF CA55 47B1 9D2A 6099 5060 96B3 EE5F 2911 1145, hết hạn 2027-05-15 (đã kiểm lại ngày 2026-10-15; lấy lại khóa nếu apt update báo EXPKEYSIG/NO_PUBKEY sau ngày đó).
Windows agentwazuh-agent-4.14.9-1.msiCài cho máy Windows (mục 7.5); dịch vụ tên WazuhSvc. Đã kiểm tệp tồn tại trên packages.wazuh.com/4.x/windows/.
Vì sao 4.14.9 (không phải 4.9.2, cũng không dừng ở 4.14.7): ngày 2026-10-13 trang GitHub Security Advisories của wazuh/wazuh công bố 15 advisory (3 Critical, 5 High, 7 Medium); tất cả ghi bản vá là 4.14.8. Phạm vi ảnh hưởng ghi trong advisory bao gồm 4.9.2 ở 14/15 advisory; ba advisory Critical là CVE-2026-74040 (cluster worker ghi đè tệp trên master, manager từ 3.9.0), CVE-2026-74043 (path traversal ở hàm upload của cluster, manager từ 4.1.1) và CVE-2026-74041 (RCE root qua PUT /manager/configuration, chỉ manager từ 4.14.3 trở đi nên 4.14.3 đến 4.14.7 cũng dính). Advisory CVE-2026-74036 ảnh hưởng cả agent từ 4.3.0 (RCE root qua chính sách SCA) và cũng chỉ được vá từ 4.14.8, nên agent cũng phải nâng. Trước đó, CVE-2026-41424 (manager 4.9.0 đến trước 4.10.4) và CVE-2026-39359 (authd, manager đến 4.14.4) cũng bao gồm 4.9.2. Wazuh 4.14.9 (2026-10-14) là bản tích lũy sau 4.14.8 (release notes ghi mọi bản cập nhật của Wazuh đều có tính tích lũy), nên bài chọn 4.14.9. Dù đã vá, vẫn nên chỉ cho phép truy cập API 55000 từ VLAN quản trị (mục 8). Nguồn: github.com/wazuh/wazuh/security/advisories và documentation.wazuh.com/current/release-notes/release-4-14-9.html.

Kiến trúc triển khai trong lab này

[VM Agent trên các VLAN]
        │  port 1514/TCP    (agent)
        │  port 1515/TCP    (enrollment)
        ▼
[VM280 wazuh-siem - VLAN_MGMT 10.11.45.25]
  ┌───────────────────────────────────────┐
  │  wazuh-manager   (nhận, xử lý log)   │
  │  wazuh-indexer   (OpenSearch store)   │
  │  wazuh-dashboard (UI port 443)        │
  └───────────────────────────────────────┘
        │  port 55000/TCP  (API)
        ▼
  [FortiGate / Admin truy cập]
02

Thông Số VM

Thông sốGiá trị
VMID280
Hostnamewazuh-siem
vCPU4
RAM8 GB (8192 MiB)
Disk100 GB (vm-ceph RBD)
OSUbuntu Server 24.04 LTS
IP10.11.45.25/24
Gateway10.11.45.1
DNS10.11.45.53
VLANVLAN_MGMT, tag 45
Bridgevmbr0
Nodenode1 (10.11.45.210)

Cổng dịch vụ:

PortProtocolMục đích
443TCPWazuh Dashboard (HTTPS)
1514TCPKênh kết nối của Wazuh agent
1515TCPAgent enrollment (đăng ký)
55000TCPWazuh REST API
9200TCPWazuh indexer API (compose publish ra host; chỉ dùng nội bộ VM280, không mở ra mạng, xem mục 5.3)
514UDPSyslog (compose có publish nhưng manager mặc định không bật <remote> syslog; không dùng trong bài)
Lưu ý: 1514 là cổng riêng của Wazuh agent (không phải HTTP, không nhận webhook/POST). VM khác muốn đưa log vào Wazuh phải cài Wazuh agent (mục 7) và đọc log cục bộ, hoặc gọi REST API ở cổng 55000 (HTTPS).
Cổng 1514 chỉ dùng TCP: theo tài liệu Wazuh, 1514/UDP là tùy chọn và tắt mặc định; manager trong wazuh-docker 4.14.9 chỉ khai báo một khối <remote> kiểu secure, giao thức tcp, cổng 1514, còn docker-compose.yml publish 1514, 1515, 55000 (TCP) cùng 514/udp. Rule FortiGate vì thế không cần mở 1514/UDP hay 514/UDP. Cổng 1516 (cluster giữa các manager) chỉ nằm bên trong container, không publish.
Sizing: bảng quickstart của Wazuh 4.14 gợi ý 4 vCPU / 8 GiB / 50 GB cho 1 đến 25 agent và 8 vCPU / 8 GiB / 100 GB cho 26 đến 50 agent (lưu 90 ngày). Bài giữ VM280 theo bảng quy hoạch chung của lab (4 vCPU, 8 GB, 100 GB); với 35 agent, nếu CPU của VM280 thường xuyên cao thì nâng vCPU (tùy chọn). Heap mặc định của indexer trong compose là -Xms1g -Xmx1g; tài liệu nâng cấp Wazuh Docker cho phép tăng biến OPENSEARCH_JAVA_OPTS khi cần thêm RAM cho indexer (ví dụ -Xms2g -Xmx2g, giá trị gợi ý, cần kiểm lại trên máy thật).
Dung lượng đĩa trong lab: dựng bằng create-lab-vms.sh (bài 07) thì VM280 có scsi0 = 60 GB trên SSD vm-ceph (thin provisioning) và không có đĩa dữ liệu scsi1 (xdisk = 0); indexer cần IOPS ngẫu nhiên nên ở lại SSD. Số 100 GB ở bài này là trần danh nghĩa/khuyến nghị cho môi trường thật (lưu 90 ngày); với 60 GB, hãy giữ chỉ mục alert 30 ngày bằng chính sách ISM ở mục 5.6 (bài 07, mục 8.6 ước tính khoảng 23 GB cho 30 ngày, cộng hệ điều hành + Docker ≈ 7 GB và image ≈ 3 GB; số ước tính, cần đo lại trên máy thật).
03

Tạo VM Trên PVE

Chạy lệnh tạo VM · Cài đặt Ubuntu qua Console · Sau khi Ubuntu boot lần đầu

3.1 Chạy lệnh tạo VM

Đăng nhập SSH vào node1 (10.11.45.210) với quyền root:

Tạo VM280:

Cách 1: Web UI Proxmox (GUI)

1
Đăng nhập Proxmox Web UI → chọn Node: node1 → nhấn Create VM (góc trên phải)
2
General:
  • VM ID: 280
  • Name: wazuh-siem
  • Bỏ tick Start after created
3
OS:
  • Storage: local (hoặc nơi chứa ISO)
  • ISO Image: ubuntu-24.04.5-live-server-amd64.iso
  • Guest OS Type: Linux, Version: 6.x - 2.6 Kernel
4
System:
  • Machine: q35
  • SCSI Controller: VirtIO SCSI single
  • BIOS: SeaBIOS
  • Qemu Agent: ☑
5
Disks:
  • Bus/Device: SCSI 0, Storage: vm-ceph (thường là vm-ceph)
  • Disk size: 100 GiB, Cache: Write back, Discard: ☑
6
CPU:
  • Sockets: 1, Cores: 4, Type: x86-64-v2-AES
7
Memory:
  • Memory (MiB): 8192
8
Network:
  • Bridge: vmbr0, VLAN Tag: 45, Model: VirtIO (paravirtualized), Firewall: ☐
9
Confirm: Xem lại → Finish → Start VM → Console để bắt đầu cài Ubuntu.
Proxmox Create VM → tab Confirm: VM 280 wazuh-siem trên node1, 4 core x86-64-v2-AES, 8192 MiB, scsi0 vm-ceph 100G, net0 vmbr0 tag=45.
Proxmox Create VM → tab Confirm: VM 280 wazuh-siem trên node1, 4 core x86-64-v2-AES, 8192 MiB, scsi0 vm-ceph 100G, net0 vmbr0 tag=45.

Cách 2: CLI (qm create)

qm create 280 --name wazuh-siem \
  --memory 8192 --cores 4 \
  --net0 virtio,bridge=vmbr0,tag=45 \
  --scsi0 vm-ceph:100 \
  --scsihw virtio-scsi-pci \
  --ide2 local:iso/ubuntu-24.04.5-live-server-amd64.iso,media=cdrom \
  --boot "order=ide2;scsi0" \
  --ostype l26 \
  --agent enabled=1
qm start 280
Lưu ý: ISO ubuntu-24.04.5-live-server-amd64.iso phải đã được upload vào storage local của node1 trước. Nếu chưa có, upload qua Proxmox Web UI: Datacenter → node1 → local → ISO Images → Upload.

3.2 Cài đặt Ubuntu qua Console

1
Mở PVE Web UI → node1 → VM 280 → Console
2
Chọn Install Ubuntu Server
3
Cấu hình:
  • Hostname: wazuh-siem
  • Username: sysadmin (hoặc tùy chọn)
  • Network:
  • Interface: ens18 hoặc enp6s18 (tên NIC hiển thị trong trình cài đặt; kiểm bằng ip -br link)
  • IP: 10.11.45.25/24
  • Gateway: 10.11.45.1
  • DNS: 10.11.45.53
  • Disk: chọn toàn bộ 100 GB, không LVM tùy chọn
  • Cài OpenSSH Server: có
4
Hoàn thành cài đặt, khởi động lại VM

3.3 Sau khi Ubuntu boot lần đầu

# SSH từ máy quản trị
ssh [email protected]

# Kiểm tra kết nối mạng
ip a
ping -c 3 10.11.45.1
ping -c 3 google.com
04

Cài Đặt OS Ban Đầu

Đặt hostname và cập nhật hệ thống · Cấu hình IP tĩnh (nếu chưa set khi cài) · Cài đặt Docker và công cụ cần thiết

4.1 Đặt hostname và cập nhật hệ thống

# Ubuntu 24.04 có needrestart: tránh hộp thoại hỏi khi apt chạy trong script
export NEEDRESTART_MODE=a DEBIAN_FRONTEND=noninteractive

sudo hostnamectl set-hostname wazuh-siem
sudo apt update && sudo apt upgrade -y

4.2 Cấu hình IP tĩnh (nếu chưa set khi cài)

Xem tên NIC và file netplan hiện có. Trên VM q35, NIC thường là ens18 hoặc enp6s18; Ubuntu 24.04 (netplan 1.0) thường có /etc/netplan/50-cloud-init.yaml do cloud-init sinh ra (trình cài đặt cũ ghi 00-installer-config.yaml):

ip -br link
ls -l /etc/netplan/
sudo nano /etc/netplan/50-cloud-init.yaml

Nội dung file (đổi ens18 cho đúng tên NIC; file phải có quyền 600, netplan sẽ cảnh báo nếu quyền quá rộng):

network:
  version: 2
  ethernets:
    ens18:
      dhcp4: false
      addresses:
        - 10.11.45.25/24
      routes:
        - to: default
          via: 10.11.45.1
      nameservers:
        addresses:
          - 10.11.45.53
          - 8.8.8.8

Áp dụng (dùng try khi đang SSH để tự hoàn tác nếu mất kết nối; nhấn Enter để giữ cấu hình mới):

sudo chmod 600 /etc/netplan/50-cloud-init.yaml
sudo netplan try
Để cloud-init không ghi đè cấu hình mạng ở lần khởi động sau, có thể tắt phần mạng của nó: echo 'network: {config: disabled}' | sudo tee /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg.

4.3 Cài đặt Docker và công cụ cần thiết

Dùng repo chính thức của Docker cho Ubuntu 24.04 "noble" (nguồn deb822 docker.sources, theo docs.docker.com/engine/install/ubuntu), không dùng gói docker.io/docker-compose-v2 của Ubuntu:

sudo apt install -y curl wget git ca-certificates

# Gỡ gói Docker không chính thức nếu có (bỏ qua lỗi nếu chưa cài)
sudo apt remove -y docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc || true

sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

sudo tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker
sudo usermod -aG docker $USER
docker --version && docker compose version
Terminal VM280 (Ubuntu 24.04): `ip -br link` hiện NIC ens18/enp6s18 và `docker --version`, `docker compose version` in ra Docker Engine 29.9.1 từ repo noble sau khi cài xong.
Terminal VM280 (Ubuntu 24.04): `ip -br link` hiện NIC ens18/enp6s18 và `docker --version`, `docker compose version` in ra Docker Engine 29.9.1 từ repo noble sau khi cài xong.
Sau lệnh usermod, đăng xuất và đăng nhập lại để áp dụng nhóm docker.

4.4 Cấu hình vm.max_map_count (bắt buộc cho OpenSearch)

OpenSearch (wazuh-indexer) yêu cầu vm.max_map_count tối thiểu 262144 (mặc định của Linux là 65530). Nếu không set, indexer có thể không khởi động được. Cài đặt này áp dụng cho host Docker (VM280), không phải bên trong container, và mất khi khởi động lại nếu không ghi vào tệp cấu hình. Theo tài liệu Wazuh Docker, ghi vào một tệp riêng trong /etc/sysctl.d/:

echo 'vm.max_map_count=262144' | sudo tee /etc/sysctl.d/99-wazuh-max-map-count.conf
sudo sysctl --system
# Xác nhận
sysctl vm.max_map_count
# Kết quả mong đợi: vm.max_map_count = 262144

4.5 Cấu hình swap (tùy chọn nhưng khuyến nghị)

Trình cài đặt Ubuntu 24.04 thường đã tạo sẵn /swap.img: kiểm tra bằng swapon --show; nếu đã có swap đủ dùng thì bỏ qua mục này.

sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
05

Cài Đặt Wazuh 4.14.9 Bằng Docker Compose

Clone repo và chuyển vào thư mục single-node · Sinh chứng chỉ TLS nội bộ · Kiểm tra mật khẩu mặc định và thu hẹp cổng 9200

Wazuh cung cấp bộ Docker Compose chính thức trong repo wazuh-docker. Phiên bản sử dụng: v4.14.9 (tag của repo trùng số phiên bản Wazuh). Bài dùng triển khai single-node theo tài liệu "Wazuh Docker deployment": mỗi thành phần (manager, indexer, dashboard) là một container, dữ liệu nằm trong Docker volume. Lệnh thao tác chạy trong thư mục single-node; tên dự án Compose lấy từ tên thư mục này nên tên container, tên volume có tiền tố single-node.

Nếu VM280 đang chạy bản cũ 4.9.x (bài cũ của series), đừng chạy lại mục 5.1 đến 5.4 mà làm theo mục 5.7 (nâng cấp, giữ dữ liệu).

5.1 Clone repo và chuyển vào thư mục single-node

cd /opt
sudo git clone https://github.com/wazuh/wazuh-docker.git -b v4.14.9
sudo chown -R $USER:$USER /opt/wazuh-docker
cd /opt/wazuh-docker/single-node
git describe --tags
# Kết quả mong đợi: v4.14.9

5.2 Sinh chứng chỉ TLS nội bộ

Bước này tạo các certificate được dùng để mã hóa kênh truyền giữa wazuh-manager, indexer, và dashboard (tự ký). Compose chạy container wazuh/wazuh-certs-generator:0.0.4 theo generate-indexer-certs.yml và danh sách nút trong config/certs.yml (wazuh.indexer, wazuh.manager, wazuh.dashboard).

docker compose -f generate-indexer-certs.yml run --rm generator

Container generator tải công cụ wazuh-certs-tool.sh từ https://packages.wazuh.com/4.14/ lúc chạy (đã kiểm tệp tồn tại), nên VM280 phải ra được Internet tới packages.wazuh.com ở bước này; nếu không, lệnh dừng với dòng ERROR: certificates were not created.

Sau khi chạy xong, thư mục config/wazuh_indexer_ssl_certs/ có các file .pem: root-ca.pem, root-ca-manager.pem, admin.pem, admin-key.pem, wazuh.indexer.pem, wazuh.indexer-key.pem, wazuh.manager.pem, wazuh.manager-key.pem, wazuh.dashboard.pem, wazuh.dashboard-key.pem. Generator đặt quyền 400 và chủ sở hữu UID 1000 (indexer, dashboard) hoặc 999 (manager) cho các file này, nên muốn xem/sao chép phải dùng sudo. Các file được mount vào container (xem docker-compose.yml); tài liệu Wazuh cho phép dùng chứng chỉ riêng bằng cách đặt đúng các tên file này vào thư mục thay vì chạy generator (bài này dùng chứng chỉ tự ký của generator; nếu dùng CA riêng thì tên chủ thể trong config/wazuh_indexer/wazuh.indexer.yml phải khớp, cần kiểm lại trên máy thật). Thư mục này nằm trong .gitignore của repo nên git không ghi đè khi nâng cấp.

5.3 Kiểm tra mật khẩu mặc định và thu hẹp cổng 9200

# Xem các biến mật khẩu trong compose
grep -n "PASSWORD" /opt/wazuh-docker/single-node/docker-compose.yml

docker-compose.yml của wazuh-docker 4.14.9 mang sẵn các mật khẩu mặc định công khai của Wazuh (ai cũng đọc được trong repo), dùng cho ba tài khoản:

Tài khoảnDùng choGiá trị mặc địnhNơi khai báo
adminĐăng nhập Dashboard; Filebeat trong manager ghi alert vào indexerSecretPasswordBiến INDEXER_PASSWORD (service wazuh.manager và wazuh.dashboard) + hash trong config/wazuh_indexer/internal_users.yml
kibanaserverDashboard kết nối indexerkibanaserverBiến DASHBOARD_PASSWORD + hash trong config/wazuh_indexer/internal_users.yml
wazuh-wuiDashboard gọi API của manager (cổng 55000)MyS3cr37P450r.*-Biến API_PASSWORD (service wazuh.manager và wazuh.dashboard) + password trong config/wazuh_dashboard/wazuh.yml

Đổi cả ba trước khi đưa vào dùng thật (mục 6.3); ghi mật khẩu mới vào kho mật khẩu nội bộ của lab (Vaultwarden, bài 19).

Compose publish cổng 9200:9200 (indexer) ra mọi giao diện của VM280 và indexer dùng chính mật khẩu admin ở trên. Manager và dashboard nói chuyện với indexer qua mạng Docker (https://wazuh.indexer:9200) chứ không qua cổng publish này, nên có thể thu hẹp về chính VM280 (tùy chọn, khuyến nghị). Lưu ý Docker publish cổng bằng iptables nên ufw không chặn được cổng đã publish (tài liệu Docker, mục "Docker and ufw"):

cd /opt/wazuh-docker/single-node
sed -i 's|- "9200:9200"|- "127.0.0.1:9200:9200"|' docker-compose.yml
grep -n "9200:9200" docker-compose.yml
# Kết quả mong đợi: - "127.0.0.1:9200:9200"

Thay đổi này lệch khỏi compose gốc của Wazuh nên phải nhớ áp lại khi nâng cấp (mục 5.7); cần kiểm lại trên máy thật.

5.4 Khởi động Wazuh stack

cd /opt/wazuh-docker/single-node
docker compose up -d

Lần đầu chạy sẽ pull image từ Docker Hub (VM280 cần ra Internet qua HTTPS; ba image cỡ 0,5 đến 1,1 GB), cần vài phút. Sau đó kiểm tra:

docker compose ps

Kết quả mong đợi — tất cả container ở trạng thái Up/running (các cột COMMAND, CREATED, PORTS đã lược bớt):

NAME                            IMAGE                              STATUS
single-node-wazuh.indexer-1     wazuh/wazuh-indexer:4.14.9         Up
single-node-wazuh.manager-1     wazuh/wazuh-manager:4.14.9         Up
single-node-wazuh.dashboard-1   wazuh/wazuh-dashboard:4.14.9       Up
Terminal VM280: docker compose ps trong /opt/wazuh-docker/single-node, 3 container single-node-wazuh.indexer-1, single-node-wazuh.manager-1, single-node-wazuh.dashboard-1 (image 4.14.9) đều Up.
Terminal VM280: docker compose ps trong /opt/wazuh-docker/single-node, 3 container single-node-wazuh.indexer-1, single-node-wazuh.manager-1, single-node-wazuh.dashboard-1 (image 4.14.9) đều Up.

Cột PORTS của manager phải có 1514-1515->1514-1515/tcp, 514->514/udp và 55000->55000/tcp; của dashboard là 443->5601/tcp. Xác nhận phiên bản thực đang chạy trong container manager:

docker exec single-node-wazuh.manager-1 /var/ossec/bin/wazuh-control info
# Kết quả mong đợi: WAZUH_VERSION="v4.14.9"

5.5 Theo dõi log khi khởi động lần đầu

# Theo dõi log indexer (mất 1-2 phút để OpenSearch sẵn sàng)
docker compose logs -f wazuh.indexer

# Theo dõi log manager
docker compose logs -f wazuh.manager

# Theo dõi log dashboard
docker compose logs -f wazuh.dashboard

Trong khoảng 1 phút đầu (lúc indexer chưa lên) log dashboard có thể lặp lại các dòng kiểu Failed to connect to Wazuh indexer port 9200 hoặc Wazuh dashboard server is not ready yet; đây là hành vi bình thường, dashboard tự thử lại cho đến khi indexer sẵn sàng (theo tài liệu Wazuh Docker). Dashboard sẵn sàng khi log hiển thị dòng tương tự:

Server running at https://0.0.0.0:5601

(Dashboard lắng nghe cổng 5601 bên trong container; docker-compose.yml ánh xạ cổng 443 của VM280 vào 5601 của container nên bạn truy cập bằng https://10.11.45.25 không cần ghi cổng.)

5.6 Ghi chú về lưu trữ dữ liệu

Dữ liệu Wazuh được lưu trong Docker volumes trên VM280. Thư mục lưu trữ:

# Xem các volume
docker volume ls | grep single-node

# Volume chứa dữ liệu indexer
docker volume inspect single-node_wazuh-indexer-data

Compose khai báo 14 volume (tiền tố single-node_). Nhóm cần giữ khi sao lưu/nâng cấp: wazuh-indexer-data (chỉ mục alert, inventory), wazuh_etc (client.keys, rules/decoders tùy biến, authd.pass), wazuh_queue (cơ sở dữ liệu agent), wazuh_logs, wazuh_integrations, wazuh_api_configuration và wazuh-dashboard-config. Chứng chỉ TLS và các tệp cấu hình mount nằm trong thư mục /opt/wazuh-docker/single-node/config/ trên host (không nằm trong volume), nên backup VM280 bằng PBS (mục 10) là bao trọn cả hai.

Tên container và đường dẫn dùng chung cho các bài khác (bài 35, 36, 37): Wazuh manager KHÔNG cài trực tiếp trên host VM280 nên thư mục /var/ossec/... chỉ tồn tại bên trong container manager; không có service wazuh-manager trên host để quản lý bằng systemctl.

Thành phầnTên container (cho docker exec, docker restart)Tên service trong compose (cho docker compose ...)
Managersingle-node-wazuh.manager-1wazuh.manager
Indexersingle-node-wazuh.indexer-1wazuh.indexer
Dashboardsingle-node-wazuh.dashboard-1wazuh.dashboard
Đường dẫn trong container managerVolume / file tương ứng trên host VM280
/var/ossec/etc (ossec.conf, authd.pass, rules, decoders)volume single-node_wazuh_etc (/var/lib/docker/volumes/single-node_wazuh_etc/_data)
/var/ossec/integrations (script tích hợp, ví dụ custom-*)volume single-node_wazuh_integrations (/var/lib/docker/volumes/single-node_wazuh_integrations/_data)
/var/ossec/active-response/binvolume single-node_wazuh_active_response
/var/ossec/logs (ossec.log, alerts/alerts.json)volume single-node_wazuh_logs
/wazuh-config-mount/etc/ossec.conf (cấu hình manager gốc, được copy vào /var/ossec/etc/ossec.conf mỗi lần container khởi động)file /opt/wazuh-docker/single-node/config/wazuh_cluster/wazuh_manager.conf

Cách thao tác chuẩn:

# Chạy lệnh Wazuh trong container manager
docker exec -it single-node-wazuh.manager-1 /var/ossec/bin/wazuh-control status

# Sửa cấu hình manager (ossec.conf): sửa file trên host rồi restart container
sudo nano /opt/wazuh-docker/single-node/config/wazuh_cluster/wazuh_manager.conf
docker restart single-node-wazuh.manager-1

Giới hạn dung lượng chỉ mục (retention) cho đĩa 60 GB của lab. Chỉ mục alert wazuh-alerts-* được tạo theo ngày và không tự bị xóa, nên đĩa đầy dần. Theo tài liệu Wazuh ("Index lifecycle management"), dùng chính sách Index State Management (ISM) để xóa chỉ mục quá tuổi; ví dụ của Wazuh đặt 90 ngày, lab này đặt 30 ngày. Đo dung lượng thật của các chỉ mục (thay <INDEXER_PASSWORD> bằng giá trị ở mục 6.2):

docker exec -it single-node-wazuh.dashboard-1 \
  curl -k -s -u admin:<INDEXER_PASSWORD> "https://wazuh.indexer:9200/_cat/indices/wazuh-alerts-*?v&h=index,store.size&s=index"

Sau khi đăng nhập Dashboard (mục 6): ☰ → Indexer management → Index Management → State management policies → Create policy → JSON editor → Continue, đặt Policy ID wazuh-alert-retention-policy rồi dán nội dung dưới (đổi min_index_age theo thời gian lưu mong muốn) và bấm Create:

{
  "policy": {
    "policy_id": "wazuh-alert-retention-policy",
    "description": "Wazuh alerts retention policy (lab: 30 days)",
    "schema_version": 17,
    "error_notification": null,
    "default_state": "retention_state",
    "states": [
      {
        "name": "retention_state",
        "actions": [],
        "transitions": [
          { "state_name": "delete_alerts", "conditions": { "min_index_age": "30d" } }
        ]
      },
      {
        "name": "delete_alerts",
        "actions": [
          { "retry": { "count": 3, "backoff": "exponential", "delay": "1m" }, "delete": {} }
        ],
        "transitions": []
      }
    ],
    "ism_template": [
      { "index_patterns": ["wazuh-alerts-*"], "priority": 1 }
    ]
  }
}

ism_template chỉ tự gắn chính sách cho chỉ mục tạo sau khi chính sách tồn tại. Chỉ mục đã có thì gắn tay: Index Management → Indices → chọn các chỉ mục wazuh-alerts-* → Actions → Apply policy → chọn wazuh-alert-retention-policy → Apply. Cảnh báo: chính sách xóa vĩnh viễn chỉ mục có tuổi lớn hơn min_index_age; kiểm danh sách chỉ mục bằng lệnh trên trước khi gắn. Tên menu theo tài liệu Wazuh hiện hành, cần kiểm lại trên Dashboard 4.14.9 của bạn.

5.7 Nâng cấp từ Wazuh 4.9.x lên 4.14.9 (giữ dữ liệu)

Mục này dành cho VM280 đang chạy stack 4.9.x dựng bằng wazuh-docker (bản cũ của bài). Theo tài liệu "Upgrading Wazuh Docker", nâng cấp là chuyển repo sang tag mới rồi docker compose up -d; dữ liệu nằm trong volume và trong thư mục config/ trên host nên được giữ. Làm tuần tự từng bước, bước trước xong mới sang bước sau. Thứ tự bắt buộc: manager, indexer, dashboard trước; agent sau (agent không được mới hơn manager).

Không hạ cấp được: từ 4.12.0 indexer dùng Apache Lucene mới nên không thể quay về 4.11 trở xuống tại chỗ (tài liệu nâng cấp Wazuh). Đường lui duy nhất là khôi phục VM280 từ bản backup PBS ở Bước 1. Tài liệu Wazuh Docker mô tả nâng thẳng lên 4.14.9 bằng tag mới và không yêu cầu qua bản trung gian; tuy vậy chưa có tài liệu riêng cho đường 4.9.2 đến 4.14.9 trên Docker, nên hãy thử trước trên bản clone khôi phục từ PBS (cần kiểm lại trên máy thật). Cảnh báo khác của tài liệu: từ 4.14.1, trường JSON tên user khi giải mã sự kiện được ánh xạ sang dstuser; dashboard, truy vấn hay script tùy biến đang dùng data.user cần rà lại.
  1. Sao lưu

Trước hết (khuyến nghị), xuất tùy biến của Dashboard: Dashboard management → Dashboards Management → Saved objects → Export all objects và lưu tệp ra máy quản trị.

Tiếp theo, trên VM280: ghi lại bản đang chạy, sao chép toàn bộ thư mục repo (compose, cấu hình, chứng chỉ, mật khẩu đã đổi) và dừng stack:

cd /opt/wazuh-docker/single-node
docker compose images                                     # ghi lại tag đang chạy (4.9.x)
sudo cp -a /opt/wazuh-docker /opt/wazuh-docker.bak-4.9
docker compose down                                       # KHÔNG thêm -v: -v xóa volume dữ liệu

Sau đó, trên node1: backup VM280 khi stack đã dừng (bản sạch, dùng để quay lui), rồi xác nhận bản backup có trên PBS như mục 10.3 trước khi sang bước sau:

vzdump 280 --storage pbs-primary --mode snapshot --compress zstd
  1. Chuyển repo sang tag v4.14.9
cd /opt/wazuh-docker
git status --short                    # các tệp bạn đã sửa tay
git stash push -m "local-4.9"         # cất chỉnh sửa cục bộ (đã có bản sao ở /opt/wazuh-docker.bak-4.9)
git fetch --all --tags
git checkout v4.14.9
git describe --tags                   # kết quả mong đợi: v4.14.9
cd single-node

(Thư mục config/wazuh_indexer_ssl_certs/ do generator tạo thuộc root, quyền 500, nên git status có thể in cảnh báo Permission denied cho thư mục đó; cảnh báo này vô hại vì các tệp trong đó nằm trong .gitignore.)

  1. Áp lại chỉnh sửa cục bộ. Không chép đè file cũ lên file mới (compose 4.14.9 đã đổi đường dẫn mount của indexer, từ /usr/share/wazuh-indexer/certs/... sang /usr/share/wazuh-indexer/config/certs/..., opensearch.yml và internal_users.yml nằm dưới config/, và bỏ khóa version:). Chỉ sửa lại đúng các điểm sau trên file mới (đối chiếu bằng diff -u /opt/wazuh-docker.bak-4.9/single-node/<tệp> <tệp>):
Tệp trong single-node/Cần áp lại
docker-compose.ymlMật khẩu INDEXER_PASSWORD, DASHBOARD_PASSWORD, API_PASSWORD nếu đã đổi (ở mọi chỗ xuất hiện); dòng 127.0.0.1:9200:9200 (mục 5.3); OPENSEARCH_JAVA_OPTS nếu đã chỉnh. Image đã là 4.14.9
config/wazuh_indexer/internal_users.ymlChuỗi hash của user đã đổi mật khẩu (mục 6.3) và user tùy biến nếu có
config/wazuh_dashboard/wazuh.ymlpassword của wazuh-wui nếu đã đổi; giữ run_as: true của bản mới
config/wazuh_cluster/wazuh_manager.confLấy tệp của tag v4.14.9 làm nền (có thêm ba danh sách malicious-ioc và <ports all="yes"> ở syscollector), rồi thêm lại đúng các khối bạn đã thêm: <use_password>yes</use_password> (mục 7.4), <integration> của TheHive (bài 35) và của Mattermost (bài 37), <localfile> tự thêm

config/wazuh_dashboard/opensearch_dashboards.yml của 4.14.9 khai báo rõ thời hạn phiên Dashboard 15 phút (opensearch_security.cookie.ttl và session.ttl đều 900000 ms, session.keepalive: true); các dòng này không có trong bản 4.9.2. Sau khi nâng phải đăng nhập lại; muốn phiên dài hơn thì chỉnh các giá trị này.

  1. Sinh lại chứng chỉ bằng generator mới. generate-indexer-certs.yml của tag 4.14.9 đã dùng wazuh-certs-generator:0.0.4 và biến CERT_TOOL_VERSION=4.14; tài liệu nâng cấp Wazuh yêu cầu sinh lại chứng chỉ sau thay đổi này (VM280 cần ra Internet, xem mục 5.2):
docker compose -f generate-indexer-certs.yml run --rm generator
  1. Khởi động bản mới và kiểm tra
docker compose pull
docker compose up -d
docker compose ps
docker compose logs -f wazuh.indexer          # Ctrl+C khi indexer đã chạy ổn
docker exec single-node-wazuh.manager-1 /var/ossec/bin/wazuh-control info
# Kết quả mong đợi: WAZUH_VERSION="v4.14.9"
docker exec single-node-wazuh.manager-1 /var/ossec/bin/agent_control -l

Lần khởi động đầu có thể lâu hơn bình thường: release notes 4.14.1 ghi nhận cải tiến nâng cấp chỉ mục lỗ hổng bằng reindex tự động, nên hãy chờ vài phút và theo dõi log trước khi kết luận lỗi. Các agent 4.9.2 hiện có vẫn kết nối được vì manager mới hơn agent. Đăng nhập Dashboard tại https://10.11.45.25, kiểm tra dữ liệu cũ (alert, agent) còn nguyên. Nếu lỗi, xem mục 11.5.

  1. Nâng agent lên 4.14.9-1. Chỉ làm sau khi manager đã ổn. Trên mỗi VM Linux đang giữ wazuh-agent bản 4.9.2 (apt -y không đổi được gói đang bị giữ nên phải bỏ giữ trước):
sudo apt-mark unhold wazuh-agent
sudo apt-get update && sudo apt-get install -y wazuh-agent=4.14.9-1
sudo apt-mark hold wazuh-agent

Với 35 máy, dùng lại vòng lặp ở mục 7.5 (đã có apt-mark unhold và ghim 4.14.9-1). Máy Windows: tải wazuh-agent-4.14.9-1.msi (URL ở mục 7.5) và chạy .\wazuh-agent-4.14.9-1.msi /q bằng quyền Administrator (lệnh nâng cấp theo tài liệu Wazuh). Tài liệu Wazuh còn cho phép nâng agent từ xa bằng agent_upgrade hoặc từ Dashboard; bài dùng nâng cục bộ bằng apt (cách từ xa cần kiểm lại trên máy thật).

  1. Dọn dẹp và quay lui. Sau vài ngày ổn định, xóa image cũ và bản sao lưu cục bộ: docker image rm wazuh/wazuh-manager:4.9.2 wazuh/wazuh-indexer:4.9.2 wazuh/wazuh-dashboard:4.9.2 và sudo rm -rf /opt/wazuh-docker.bak-4.9. Nếu phải quay lui: tắt VM280, khôi phục từ bản backup PBS ở Bước 1 (mục 10), không cố chạy lại image 4.9.2 trên dữ liệu đã nâng.
06

Truy Cập Dashboard

Mở trình duyệt · Thông tin đăng nhập mặc định · Đổi mật khẩu mặc định sau lần đăng nhập đầu

6.1 Mở trình duyệt

Truy cập: https://10.11.45.25 hoặc https://wazuh-siem.hoatranlabs.local (sau khi cấu hình DNS)

Browser sẽ cảnh báo chứng chỉ self-signed — chấp nhận exception để tiếp tục.
Trình duyệt mở https://10.11.45.25: cảnh báo chứng chỉ self-signed trước khi chấp nhận exception để vào Wazuh Dashboard.
Trình duyệt mở https://10.11.45.25: cảnh báo chứng chỉ self-signed trước khi chấp nhận exception để vào Wazuh Dashboard.

6.2 Thông tin đăng nhập mặc định

TrườngGiá trị
Usernameadmin
PasswordMặc định SecretPassword (giá trị INDEXER_PASSWORD trong docker-compose.yml); đổi ngay theo mục 6.3

Xem giá trị đang dùng:

grep "INDEXER_PASSWORD" /opt/wazuh-docker/single-node/docker-compose.yml
Màn hình đăng nhập Wazuh Dashboard tại https://10.11.45.25: user admin, mật khẩu là giá trị INDEXER_PASSWORD trong docker-compose.yml (mặc định SecretPassword khi mới cài, đổi theo mục 6.3).
Màn hình đăng nhập Wazuh Dashboard tại https://10.11.45.25: user admin, mật khẩu là giá trị INDEXER_PASSWORD trong docker-compose.yml (mặc định SecretPassword khi mới cài, đổi theo mục 6.3).

6.3 Đổi mật khẩu mặc định sau lần đăng nhập đầu

Trong triển khai Docker, mật khẩu admin nằm ở nhiều nơi cùng lúc (biến INDEXER_PASSWORD của manager và dashboard, chuỗi hash trong internal_users.yml nạp vào indexer). Manager (Filebeat) và dashboard đăng nhập indexer bằng biến trong docker-compose.yml, nên nếu chỉ đổi mật khẩu admin trên giao diện Dashboard thì Filebeat ở manager sẽ không ghi được alert vào indexer. Vì vậy dùng quy trình chuẩn của tài liệu Wazuh Docker dưới đây (đổi một user mỗi lần; làm trong /opt/wazuh-docker/single-node):

  1. Đăng xuất khỏi Dashboard trước khi đổi (cookie phiên cũ sẽ gây lỗi khi vào lại).
  2. Mở docker-compose.yml, thay mọi chỗ mật khẩu cũ bằng mật khẩu mới: INDEXER_PASSWORD ở service wazuh.manager và wazuh.dashboard. Nếu mật khẩu có ký tự $ thì viết $$ (ví dụ Secret$Password thành Secret$$Password).
  3. Dừng stack và sinh hash cho mật khẩu mới (nhập mật khẩu khi được hỏi, rồi sao chép chuỗi hash):
docker compose down
docker run --rm -ti wazuh/wazuh-indexer:4.14.9 bash /usr/share/wazuh-indexer/plugins/opensearch-security/tools/hash.sh
Terminal VM280 (mục 6.3): lệnh docker run --rm -ti wazuh/wazuh-indexer:4.14.9 bash .../hash.sh hỏi mật khẩu mới (không hiện khi gõ) rồi in ra chuỗi băm (hash) của mật khẩu để dán vào internal_users.yml.
Terminal VM280 (mục 6.3): lệnh docker run --rm -ti wazuh/wazuh-indexer:4.14.9 bash .../hash.sh hỏi mật khẩu mới (không hiện khi gõ) rồi in ra chuỗi băm (hash) của mật khẩu để dán vào internal_users.yml.
  1. Mở config/wazuh_indexer/internal_users.yml, tìm khối admin: và thay giá trị hash: "<HASH>" bằng chuỗi vừa sinh (giữ nguyên các user khác; user tùy biến phải nằm trong file này, nếu không sẽ bị xóa khi áp dụng).
  2. Khởi động lại stack, chờ indexer sẵn sàng (1 đến 5 phút), rồi áp cấu hình bảo mật vào indexer:
docker compose up -d
docker exec -it single-node-wazuh.indexer-1 bash

Trong shell của container indexer:

export INSTALLATION_DIR=/usr/share/wazuh-indexer
export CONFIG_DIR=$INSTALLATION_DIR/config
CACERT=$CONFIG_DIR/certs/root-ca.pem
KEY=$CONFIG_DIR/certs/admin-key.pem
CERT=$CONFIG_DIR/certs/admin.pem
export JAVA_HOME=/usr/share/wazuh-indexer/jdk
bash /usr/share/wazuh-indexer/plugins/opensearch-security/tools/securityadmin.sh -cd $CONFIG_DIR/opensearch-security/ -nhnv -cacert $CACERT -cert $CERT -key $KEY -p 9200 -icl
exit
  1. Tải lại Dashboard và đăng nhập bằng mật khẩu mới.

Lặp lại cho user kibanaserver (biến DASHBOARD_PASSWORD ở service wazuh.dashboard và khối kibanaserver: trong internal_users.yml).

User API wazuh-wui (Dashboard gọi API manager): mật khẩu dài 8 đến 64 ký tự, có chữ hoa, chữ thường, số và ký hiệu (nếu không đáp ứng, manager không khởi động). Sửa password trong config/wazuh_dashboard/wazuh.yml và API_PASSWORD ở service wazuh.manager và wazuh.dashboard trong docker-compose.yml, rồi docker compose down && docker compose up -d.

Nguồn: https://documentation.wazuh.com/current/deployment-options/docker/changing-default-password.html.

07

Cài Wazuh Agent Trên Các VM Khác

Phương pháp nhanh — Deploy Agent từ Dashboard · Cài thủ công trên Ubuntu 24.04 · Kiểm tra agent đã kết nối

Agent cần được cài trên tất cả VM trong cụm để Wazuh có thể thu thập log.

7.1 Phương pháp nhanh — Deploy Agent từ Dashboard

1
Đăng nhập Wazuh Dashboard
2
Menu trái → Agents management → Summary → Deploy new agent (tên menu theo tài liệu Wazuh 4.14, cần kiểm lại trên máy thật)
3
Chọn OS, nhập địa chỉ Manager: 10.11.45.25
4
Dashboard tạo lệnh cài đặt sẵn — copy và chạy trên VM đích. Lệnh do Dashboard sinh không ghim phiên bản; với bài này hãy dùng lệnh ở mục 7.2 (ghim 4.14.9-1 khớp manager)
Wazuh Dashboard → Agents management → Summary → Deploy new agent: chọn OS, Server address 10.11.45.25 và lệnh cài đặt do Dashboard sinh sẵn.
Wazuh Dashboard → Agents management → Summary → Deploy new agent: chọn OS, Server address 10.11.45.25 và lệnh cài đặt do Dashboard sinh sẵn.

7.2 Cài thủ công trên Ubuntu 24.04

Chạy các lệnh sau trên VM đích (không phải VM280):

# Thêm GPG key Wazuh (khóa ASCII-armored, dùng trực tiếp trong Signed-By, không cần apt-key)
sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://packages.wazuh.com/key/GPG-KEY-WAZUH -o /etc/apt/keyrings/wazuh.asc
sudo chmod 644 /etc/apt/keyrings/wazuh.asc
# Kiểm vân tay: 0DCF CA55 47B1 9D2A 6099 5060 96B3 EE5F 2911 1145 (khóa hết hạn 2027-05-15)
gpg --show-keys --with-fingerprint /etc/apt/keyrings/wazuh.asc

# Thêm repo (nguồn deb822; repo dùng suite `stable` nên không phụ thuộc codename noble)
sudo tee /etc/apt/sources.list.d/wazuh.sources > /dev/null <<EOF
Types: deb
URIs: https://packages.wazuh.com/4.x/apt/
Suites: stable
Components: main
Signed-By: /etc/apt/keyrings/wazuh.asc
EOF

# Cài đặt agent — ghim đúng phiên bản manager (4.14.9): Wazuh chỉ đảm bảo tương thích khi agent cùng phiên bản hoặc cũ hơn manager,
# còn `apt install wazuh-agent` không ghim sẽ lấy bản mới nhất trong repo (sẽ mới hơn manager khi Wazuh ra bản kế tiếp, ví dụ 4.14.10)
sudo apt update && sudo apt install wazuh-agent=4.14.9-1 -y
sudo apt-mark hold wazuh-agent

# Cấu hình manager address
sudo sed -i 's/<address>MANAGER_IP<\/address>/<address>10.11.45.25<\/address>/' \
  /var/ossec/etc/ossec.conf

# Khởi động và enable
sudo systemctl restart wazuh-agent
sudo systemctl enable wazuh-agent
Dạng nguồn deb822 + khóa .asc ở trên theo quy ước chung của series cho Ubuntu 24.04; tài liệu Wazuh 4.14 vẫn hướng dẫn dạng một dòng /etc/apt/sources.list.d/wazuh.list với khóa gnupg-ring:/usr/share/keyrings/wazuh.gpg (cùng repo, cùng khóa). Chạy apt update trên noble với nguồn deb822 này cần kiểm lại trên máy thật. Tài liệu Wazuh khuyến nghị tắt repo hoặc giữ gói để tránh nâng agent lên cao hơn manager; bài dùng apt-mark hold.
Ubuntu 24.04 bản Server tiêu chuẩn có rsyslog nên các file /var/log/auth.log, /var/log/syslog mà cấu hình mặc định của agent đọc vẫn tồn tại; nếu VM dựng từ ảnh tối giản (không có rsyslog) thì các file này không có: cài rsyslog hoặc dùng <localfile> với log_format journald (Wazuh 4.9 hỗ trợ) — cần kiểm lại trên máy thật.

7.3 Kiểm tra agent đã kết nối

# Trên VM280 (wazuh-siem)
docker exec -it single-node-wazuh.manager-1 \
  /var/ossec/bin/agent_control -l

Hoặc kiểm tra trên Dashboard: Agents management → Summary → danh sách hiển thị trạng thái Active.

Wazuh Dashboard → Agents management → Summary: danh sách agent với trạng thái Active sau khi cài agent lên VM test.
Wazuh Dashboard → Agents management → Summary: danh sách agent với trạng thái Active sau khi cài agent lên VM test.

Kiểm tra phiên bản của một agent (thay 001 bằng ID trong danh sách; dòng Client version phải là Wazuh v4.14.9, không được cao hơn manager):

docker exec -it single-node-wazuh.manager-1 /var/ossec/bin/agent_control -i 001

7.4 Enrollment tự động với password (tùy chọn)

Để tăng bảo mật khi enroll agent, cấu hình enrollment password:

# Trên wazuh-manager container
docker exec -it single-node-wazuh.manager-1 bash
echo "MyEnrollmentPass123!" > /var/ossec/etc/authd.pass
chmod 640 /var/ossec/etc/authd.pass
chown root:wazuh /var/ossec/etc/authd.pass
exit

Bật yêu cầu mật khẩu ở manager: trong file /opt/wazuh-docker/single-node/config/wazuh_cluster/wazuh_manager.conf (mục 5.6), khối <auth>, đổi <use_password>no</use_password> thành <use_password>yes</use_password>, rồi docker restart single-node-wazuh.manager-1. Nếu để no, manager không đòi mật khẩu khi agent enroll.

Trên agent, tạo file mật khẩu (cùng giá trị với manager):

echo "MyEnrollmentPass123!" | sudo tee /var/ossec/etc/authd.pass > /dev/null
sudo chmod 640 /var/ossec/etc/authd.pass
sudo chown root:wazuh /var/ossec/etc/authd.pass

Trên agent, thêm vào /var/ossec/etc/ossec.conf:

<client>
  <server>
    <address>10.11.45.25</address>
    <port>1514</port>
    <protocol>tcp</protocol>
  </server>
  <enrollment>
    <manager_address>10.11.45.25</manager_address>
    <authorization_pass_path>/var/ossec/etc/authd.pass</authorization_pass_path>
  </enrollment>
</client>

Sau đó sudo systemctl restart wazuh-agent để agent enroll bằng mật khẩu.

7.5 Cài Agent Hàng Loạt Cho VM Linux, Node PVE Và Windows

Thay vì cài tay từng máy, chạy vòng lặp SSH từ máy quản trị (đã có SSH key vào user sysadmin của các VM, sysadmin dùng sudo không hỏi mật khẩu; node PVE đăng nhập root). Các bước giống mục 7.2 (repo Wazuh, ghim wazuh-agent=4.14.9-1 theo phiên bản manager) và đúng trình tự trong hướng dẫn cài agent bằng gói APT của Wazuh; biến WAZUH_MANAGER chỉ có tác dụng lúc apt-get install. Danh sách là 30 VM Linux của lab (gồm cả VM280 và VM250 dc1 là Samba AD DC chạy Ubuntu 24.04 ở bài 25; không có pbs01/pdm01), thêm ops01 (VM290, 10.11.45.20, máy quản trị/tự động hoá Ubuntu 24.04 tạo ở bài 07, nằm ngoài 30 VM lõi) và 4 node PVE của cụm; nếu đã bật mật khẩu enrollment ở 7.4, thêm WAZUH_REGISTRATION_PASSWORD="<mật khẩu>" trước apt-get install.

INSTALL='
export DEBIAN_FRONTEND=noninteractive NEEDRESTART_MODE=a
install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://packages.wazuh.com/key/GPG-KEY-WAZUH -o /etc/apt/keyrings/wazuh.asc && chmod 644 /etc/apt/keyrings/wazuh.asc
printf "%s\n" "Types: deb" "URIs: https://packages.wazuh.com/4.x/apt/" "Suites: stable" "Components: main" "Signed-By: /etc/apt/keyrings/wazuh.asc" > /etc/apt/sources.list.d/wazuh.sources
apt-get update
# bỏ giữ gói cũ (nếu đang nâng agent 4.9.2): apt -y không đổi được gói đang bị hold; lần cài mới thì lệnh này vô hại
apt-mark unhold wazuh-agent >/dev/null 2>&1 || true
WAZUH_MANAGER="10.11.45.25" apt-get install -y wazuh-agent=4.14.9-1
apt-mark hold wazuh-agent
systemctl daemon-reload
systemctl enable --now wazuh-agent
'

# 30 VM Linux (bảng quy hoạch chung của lab): wazuh-siem, privacyidea, authentik, step-ca, vaultwarden, openvas, vault, thehive,
# headscale, crowdsec, mailu, prometheus, grafana, harbor, gitea, netbox, pihole, mediamtx, dc1, samba01, mattermost, k3s x6, sonarqube, nexus, s3
# + ops01 (VM290, 10.11.45.20, ngoài 30 VM lõi). Nếu chạy vòng lặp NGAY TRÊN ops01 thì dòng 10.11.45.20 tự SSH vào chính nó:
# cần khóa công khai của ops01 trong authorized_keys của sysadmin, hoặc bỏ IP này khỏi danh sách và chạy tại chỗ: sudo bash -c "$INSTALL"
LINUX_VMS="10.11.45.25 10.11.25.30 10.11.25.40 10.11.25.42 10.11.25.43 10.11.25.44 10.11.25.10 10.11.25.11
10.11.35.10 10.11.35.20 10.11.35.46 10.11.45.35 10.11.45.36 10.11.45.39 10.11.45.40 10.11.45.45 10.11.45.53
10.11.65.41 10.11.65.50 10.11.65.51 10.11.65.57 10.11.65.60 10.11.65.61 10.11.65.62 10.11.65.63 10.11.65.64 10.11.65.65
10.11.65.66 10.11.65.67 10.11.85.10 10.11.45.20"
PVE_NODES="10.11.45.210 10.11.45.211 10.11.45.212 10.11.45.213"   # node1..node4 (node5/node6 làm tương tự nếu có đường về VLAN 45)

for ip in $LINUX_VMS; do
  echo "=== $ip"
  ssh -o StrictHostKeyChecking=accept-new sysadmin@$ip "sudo -n bash -c '$INSTALL'" || echo "!!! LỖI $ip"
done
for ip in $PVE_NODES; do
  echo "=== $ip (PVE)"
  ssh -o StrictHostKeyChecking=accept-new root@$ip "bash -c '$INSTALL'" || echo "!!! LỖI $ip"
done

Máy Windows (không thuộc 30 VM lõi của lab, ví dụ trạm domain WIN10-PC01 ở bài 25 hoặc WIFI-DC01 10.11.65.52 ở bài 39) cài bằng PowerShell chạy với quyền Administrator:

Invoke-WebRequest -Uri https://packages.wazuh.com/4.x/windows/wazuh-agent-4.14.9-1.msi -OutFile ${env:tmp}\wazuh-agent.msi
msiexec.exe /i ${env:tmp}\wazuh-agent.msi /q WAZUH_MANAGER="10.11.45.25"
NET START WazuhSvc

Tên dịch vụ Windows theo tài liệu Wazuh 4.14 là WazuhSvc (PowerShell: Start-Service wazuhsvc); tệp cài mặc định nằm ở C:\Program Files (x86)\ossec-agent. Máy Windows đã có agent 4.9.2 thì nâng bằng .\wazuh-agent-4.14.9-1.msi /q (mục 5.7, Bước 6) thay vì cài mới.

Kiểm tra bằng mục 7.3: sau khi xong phải có 35 agent Active (30 VM Linux, ops01, 4 node PVE), chưa kể agent 000 là chính manager và mỗi máy Windows đã cài thêm ở trên.

Wazuh Dashboard → Agents management → Summary sau khi chạy vòng lặp cài hàng loạt (mục 7.5): 35 agent Active gồm 30 VM Linux, ops01 và 4 node PVE (chưa kể agent 000 là manager).
Wazuh Dashboard → Agents management → Summary sau khi chạy vòng lặp cài hàng loạt (mục 7.5): 35 agent Active gồm 30 VM Linux, ops01 và 4 node PVE (chưa kể agent 000 là manager).
08

Cấu Hình Firewall (FortiGate)

Bảng các rule cần tạo · Tạo rule qua FortiGate API

FortiGate tại 10.100.100.1 cần có rule cho phép các VM agent kết nối về Wazuh.

8.1 Bảng các rule cần tạo

Tên RuleSourceDestinationPort(s)Action
Allow-Wazuh-DashboardVLAN_MGMT10.11.45.25443/TCPAccept
Allow-Wazuh-APIVLAN_MGMT10.11.45.2555000/TCPAccept
Allow-Wazuh-AgentVLAN_MGMT10.11.45.251514/TCPAccept
Allow-Wazuh-AgentVLAN_SEC10.11.45.251514/TCPAccept
Allow-Wazuh-AgentVLAN_SRV10.11.45.251514/TCPAccept
Allow-Wazuh-AgentVLAN_DMZ10.11.45.251514/TCPAccept
Allow-Wazuh-EnrollALL VLANs10.11.45.251515/TCPAccept

Không tạo rule cho 9200/TCP (indexer API), 514/UDP và 1516/TCP: các cổng này không dành cho agent hoặc người dùng. Sau các advisory ngày 2026-10-13, giữ API 55000 chỉ mở từ VLAN quản trị (dòng Allow-Wazuh-API).

Chiều ra Internet của VM280 (chính sách FortiGate cho nguồn 10.11.45.25) cần HTTPS tới: Docker Hub và repo Docker (kéo image, cài Docker), packages.wazuh.com (generator chứng chỉ ở mục 5.2, repo agent) và cti.wazuh.com (nguồn dữ liệu CVE cho tính năng vulnerability detection mà wazuh_manager.conf bật mặc định; nếu VM280 không ra Internet thì xem trang "offline update" của tài liệu Wazuh). Tên miền CDN cụ thể của Docker Hub cần kiểm lại trên máy thật.

8.2 Tạo rule qua FortiGate API

FortiGate 10.100.100.1 quản lý qua HTTPS API (SSH đóng). Ví dụ tạo rule cho VLAN_SRV → Wazuh:

# Lấy API token trước từ FortiGate GUI
# Policy & Objects → Addresses → tạo address object cho Wazuh SIEM
curl -k -X POST "https://10.100.100.1/api/v2/cmdb/firewall/address" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "wazuh-siem",
    "type": "ipmask",
    "subnet": "10.11.45.25/32"
  }'
Khuyến nghị: tạo rule qua FortiGate Web GUI để dễ kiểm soát hơn. Vào Policy & Objects → Firewall Policy → Create New.
FortiGate → Policy & Objects → Firewall Policy: các rule Allow-Wazuh-Dashboard, -API, -Agent, -Enroll tới 10.11.45.25.
FortiGate → Policy & Objects → Firewall Policy: các rule Allow-Wazuh-Dashboard, -API, -Agent, -Enroll tới 10.11.45.25.
09

Pi-hole DNS

Thêm A record trong Pi-hole · Xác nhận DNS

Thêm DNS record để truy cập Wazuh qua hostname thay vì IP.

9.1 Thêm A record trong Pi-hole

Pi-hole (VM247) chạy trong Docker (bài 12), nên thêm record qua Admin UI: http://10.11.45.53/admin → Settings → Local DNS Records:

wazuh-siem.hoatranlabs.local    →    10.11.45.25

9.2 Xác nhận DNS

Từ máy quản trị hoặc bất kỳ VM nào dùng Pi-hole làm DNS:

nslookup wazuh-siem.hoatranlabs.local 10.11.45.53
# Kết quả mong đợi: Address: 10.11.45.25
Terminal: nslookup wazuh-siem.hoatranlabs.local 10.11.45.53 trả về Address: 10.11.45.25.
Terminal: nslookup wazuh-siem.hoatranlabs.local 10.11.45.53 trả về Address: 10.11.45.25.

Sau khi DNS hoạt động, truy cập Dashboard tại: https://wazuh-siem.hoatranlabs.local

Trình duyệt tại https://wazuh-siem.hoatranlabs.local: trang chính Wazuh Dashboard sau đăng nhập, thanh địa chỉ hiện hostname.
Trình duyệt tại https://wazuh-siem.hoatranlabs.local: trang chính Wazuh Dashboard sau đăng nhập, thanh địa chỉ hiện hostname.
10

Backup PBS

Tạo backup job trong Proxmox Web UI · Chạy backup thủ công lần đầu · Xác nhận backup trong PBS Web UI

Cấu hình backup VM280 vào Proxmox Backup Server (PBS) pbs01 (VM101, 10.11.45.17).

10.1 Tạo backup job trong Proxmox Web UI

1
Đăng nhập Proxmox Web UI
2
Datacenter → Backup → Add
3
Cấu hình:
  • Storage: chọn PBS storage đã kết nối (pbs-primary; namespace st-20 đã gắn sẵn trong storage nên không khai báo Namespace ở cấp job)
  • Schedule: 02:00 (daily)
  • Selection: chọn VM 280
  • Mode: Snapshot (không interrupt dịch vụ)
  • Retention: để mặc định (retention do Prune Job trên PBS quản lý, bài 04 mục 7)
4
Click Create
Proxmox Datacenter → Backup: job mới cho VM 280 trong danh sách — storage pbs-primary, lịch daily 02:00, mode Snapshot, Keep Last 7 (không khai báo Namespace ở cấp job vì st-20 đã gắn sẵn trong storage).
Proxmox Datacenter → Backup: job mới cho VM 280 trong danh sách — storage pbs-primary, lịch daily 02:00, mode Snapshot, Keep Last 7 (không khai báo Namespace ở cấp job vì st-20 đã gắn sẵn trong storage).

10.2 Chạy backup thủ công lần đầu

# Trên node1
vzdump 280 --storage pbs-primary --mode snapshot --compress zstd

10.3 Xác nhận backup trong PBS Web UI

Truy cập PBS UI tại https://pbs01.hoatranlabs.local:8007 → Datastore → tìm VM 280 trong danh sách backup.

PBS Web UI (https://pbs01.hoatranlabs.local:8007) → Datastore syno-primary, namespace st-20: nhóm backup vm/280 với bản snapshot vừa tạo bằng vzdump.
PBS Web UI (https://pbs01.hoatranlabs.local:8007) → Datastore syno-primary, namespace st-20: nhóm backup vm/280 với bản snapshot vừa tạo bằng vzdump.
11

Troubleshooting

Indexer không khởi động · Dashboard không load hoặc hiển thị lỗi · Agent không kết nối về Manager

11.1 Indexer không khởi động

Triệu chứng: docker compose ps hiển thị wazuh.indexer ở trạng thái Exiting hoặc Restarting.

Nguyên nhân thường gặp: vm.max_map_count chưa được set đủ.

# Kiểm tra giá trị hiện tại
sysctl vm.max_map_count

# Nếu < 262144, set lại ngay lập tức (không cần reboot)
sudo sysctl -w vm.max_map_count=262144

# Đảm bảo persistent sau reboot (tệp tạo ở mục 4.4)
cat /etc/sysctl.d/99-wazuh-max-map-count.conf
# Nếu chưa có tệp này, tạo lại:
echo 'vm.max_map_count=262144' | sudo tee /etc/sysctl.d/99-wazuh-max-map-count.conf
sudo sysctl --system

# Khởi động lại indexer
cd /opt/wazuh-docker/single-node
docker compose restart wazuh.indexer
docker compose logs -f wazuh.indexer

11.2 Dashboard không load hoặc hiển thị lỗi

# Xem log dashboard
cd /opt/wazuh-docker/single-node
docker compose logs wazuh.dashboard --tail=50

# Xem log indexer (thường dashboard lỗi do indexer chưa sẵn sàng)
docker compose logs wazuh.indexer --tail=50

# Kiểm tra kết nối giữa dashboard và indexer (indexer bật xác thực nên phải kèm user admin;
# thay <INDEXER_PASSWORD> bằng giá trị lấy ở mục 6.2)
docker exec -it single-node-wazuh.dashboard-1 \
  curl -k -s -u admin:<INDEXER_PASSWORD> "https://wazuh.indexer:9200/_cluster/health?pretty"

Nếu status là red, indexer cần thêm thời gian hoặc có vấn đề với data directory. Trong khoảng 1 phút đầu sau khi khởi động, log dashboard có các dòng Wazuh dashboard server is not ready yet hoặc Failed to connect to Wazuh indexer port 9200: đó là bình thường. Nếu đăng nhập báo lỗi sau khi đổi mật khẩu admin, xem mục 11.6.

11.3 Agent không kết nối về Manager

# Trên VM có agent — kiểm tra trạng thái
sudo systemctl status wazuh-agent
sudo tail -f /var/ossec/logs/ossec.log

# Kiểm tra kết nối network tới Wazuh
nc -zv 10.11.45.25 1514
nc -zv 10.11.45.25 1515

# Nếu nc báo lỗi — kiểm tra firewall FortiGate
# Nếu nc thành công nhưng agent vẫn không kết nối:
sudo /var/ossec/bin/agent-auth -m 10.11.45.25

# Kiểm tra phiên bản agent so với manager (agent KHÔNG được mới hơn manager 4.14.9)
sudo /var/ossec/bin/wazuh-control info
dpkg -l wazuh-agent | tail -1

Nếu agent mới hơn manager (ví dụ lỡ chạy apt install wazuh-agent không ghim khi repo đã có bản 4.14.10 còn manager vẫn 4.14.9), Wazuh chỉ đảm bảo tương thích khi manager cùng phiên bản hoặc mới hơn agent, nên agent có thể không kết nối hoặc chạy không ổn định. Cách xử lý: nâng manager trước (mục 5.7) hoặc đưa agent về đúng bản manager: sudo apt-mark unhold wazuh-agent && sudo apt-get install --allow-downgrades -y wazuh-agent=4.14.9-1 && sudo apt-mark hold wazuh-agent (hạ cấp agent bằng apt cần kiểm lại trên máy thật).

11.4 Không truy cập được Dashboard từ bên ngoài

# Trên VM280 — xác nhận container đang bind port 443
docker compose ps
# Kiểm tra port bind:
ss -tlnp | grep 443

# Nếu port không mở — restart stack
cd /opt/wazuh-docker/single-node
docker compose down && docker compose up -d

11.5 Sau khi nâng cấp từ 4.9.x: container lỗi hoặc không đọc được chứng chỉ

Triệu chứng: sau mục 5.7, indexer hoặc dashboard thoát ngay, log báo không tìm thấy hoặc không đọc được tệp chứng chỉ (.pem), hoặc manager không kết nối được indexer.

Nguyên nhân thường gặp: docker-compose.yml hoặc config/wazuh_indexer/wazuh.indexer.yml còn là bản 4.9.x (mount ở /usr/share/wazuh-indexer/certs/...) trong khi image 4.14.9 đọc chứng chỉ từ /usr/share/wazuh-indexer/config/certs/...; hoặc chứng chỉ chưa được sinh lại bằng generator 0.0.4.

cd /opt/wazuh-docker/single-node
grep -n "usr/share/wazuh-indexer" docker-compose.yml config/wazuh_indexer/wazuh.indexer.yml
# Mọi đường dẫn chứng chỉ phải có /config/certs/ (ví dụ /usr/share/wazuh-indexer/config/certs/root-ca.pem)
sudo ls -l config/wazuh_indexer_ssl_certs/
docker compose -f generate-indexer-certs.yml run --rm generator
docker compose down && docker compose up -d

Nếu vẫn lỗi, khôi phục VM280 từ bản backup PBS đã tạo ở mục 5.7 Bước 1 rồi làm lại, dùng đúng compose của tag v4.14.9 (không trộn tệp 4.9.2 và 4.14.9).

11.6 Không đăng nhập được Dashboard sau khi đổi mật khẩu

Triệu chứng: sau mục 6.3, Dashboard báo lỗi xác thực hoặc trang trắng; hoặc alert không còn xuất hiện (Filebeat ở manager không ghi được vào indexer).

Kiểm tra theo thứ tự: (1) tài liệu Wazuh yêu cầu đăng xuất Dashboard trước khi đổi mật khẩu; cookie phiên cũ gây lỗi, hãy mở cửa sổ ẩn danh hoặc xóa cookie của https://10.11.45.25; (2) INDEXER_PASSWORD phải giống nhau ở cả service wazuh.manager và wazuh.dashboard và khớp với hash đã đặt trong internal_users.yml; (3) bước securityadmin.sh trong container indexer đã chạy thành công; (4) mật khẩu có ký tự $ phải viết $$ trong docker-compose.yml. Log manager (docker compose logs wazuh.manager --tail=100) cho thấy Filebeat có kết nối được indexer hay không.

12

Checklist Hoàn Thành

  • VM280 tạo thành công trên node1 với 4vCPU / 8GB RAM / 100GB Ceph
  • Ubuntu Server 24.04 LTS cài xong, IP tĩnh 10.11.45.25/24 hoạt động
  • vm.max_map_count=262144 đã set và persistent trong /etc/sysctl.d/99-wazuh-max-map-count.conf
  • Docker Engine và plugin docker compose (repo noble chính thức của Docker, không dùng docker.io) cài đặt thành công
  • Wazuh 4.14.9 (tag v4.14.9, image wazuh/*:4.14.9) khởi động đủ 3 container (indexer, manager, dashboard) ở trạng thái Up; wazuh-control info báo WAZUH_VERSION="v4.14.9"
  • Truy cập được Dashboard tại https://10.11.45.25 với user admin
  • Đã đổi mật khẩu mặc định của admin, kibanaserver và wazuh-wui (mục 6.3); cổng 9200 chỉ bind 127.0.0.1 (mục 5.3)
  • (Nếu nâng cấp từ 4.9.x) Đã backup VM280 lên PBS trước khi nâng, đã áp lại cấu hình cục bộ, dữ liệu cũ còn nguyên (mục 5.7)
  • DNS A record wazuh-siem.hoatranlabs.local → 10.11.45.25 đã thêm vào Pi-hole VM247
  • Ít nhất 1 agent test đã cài (wazuh-agent=4.14.9-1, khớp manager) và hiển thị Active trên Dashboard
  • Rule FortiGate đã mở port 443, 1514, 1515, 55000 từ đúng nguồn
  • Backup job PBS đã tạo cho VM280, schedule daily 02:00, retention do Prune Job trên PBS
  • Chạy backup thủ công lần đầu thành công và xác nhận trong PBS UI

Tài liệu cập nhật: 2026-10-15 | Cluster: HOATRANHUB PVE 9.2.20 | Ubuntu Server 24.04 LTS | Wazuh 4.14.9

Zalo