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.
Bối cảnh & Lý do triển khai
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ục | Nội dung |
|---|---|
| Ứng dụng trong DN | SOC operations, incident response, audit log cho compliance (ISO 27001, PCI-DSS), phát hiện brute-force/lateral movement |
| Tác dụng chính | Thu 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 khai | Khô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 đây | Toàn bộ VM cài Wazuh agent để gửi log về |
| Trường | Giá trị |
|---|---|
| VMID | 280 |
| Hostname | wazuh-siem |
| IP | 10.11.45.25/24 |
| Gateway | 10.11.45.1 |
| DNS | 10.11.45.53 (Pi-hole VM247) |
| VLAN | VLAN_MGMT (tag 45) |
| Node PVE | node1 (10.11.45.210) |
| vCPU | 4 |
| RAM | 8 GB |
| Disk | 100 GB (Ceph pool vm-ceph) |
| OS | Ubuntu Server 24.04 LTS |
| Cluster | HOATRANHUB (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ủ | IP | VLAN · Node | Vai trò trong bài này |
|---|---|---|---|
| wazuh-siem (Wazuh SIEM) · VM280 | 10.11.45.25 | 45 (MGMT) · node1 | Má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.210 | 45 (MGMT) · cluster HOATRANHUB | Node 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) · VM247 | 10.11.45.53 | 45 (MGMT) · node3 | DNS 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) · VM290 | 10.11.45.20 | 45 (MGMT) · node2 | Má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) · VM101 | 10.11.45.17 | 45 (MGMT) · node4 | Nhậ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.1 | Quản trị 10.100.100.0/24 · thiết bị mạng | Tạ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ị:
- Pi-hole (VM247) — DNS nội bộ
- PBS (pbs01, VM101) — backup
- Wazuh SIEM (VM280) ← file này
- Các agent cài sau khi VM280 đã hoạt động
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ần | Vai trò |
|---|---|
| wazuh-manager | Nhận log từ agent, phân tích, kích hoạt rule, lưu event vào indexer |
| wazuh-indexer | Lưu trữ dữ liệu dựa trên OpenSearch (Elasticsearch fork của Amazon) |
| wazuh-dashboard | Giao 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ần | Phiên bản | Ghi chú |
|---|---|---|
| Hệ điều hành VM280 | Ubuntu 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 Compose | 29.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 stable | Gó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, dashboard | 4.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 agent | 4.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 agent | https://packages.wazuh.com/4.x/apt/ suite stable, khóa GPG-KEY-WAZUH | Khô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 agent | wazuh-agent-4.14.9-1.msi | Cà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/. |
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]
Thông Số VM
| Thông số | Giá trị |
|---|---|
| VMID | 280 |
| Hostname | wazuh-siem |
| vCPU | 4 |
| RAM | 8 GB (8192 MiB) |
| Disk | 100 GB (vm-ceph RBD) |
| OS | Ubuntu Server 24.04 LTS |
| IP | 10.11.45.25/24 |
| Gateway | 10.11.45.1 |
| DNS | 10.11.45.53 |
| VLAN | VLAN_MGMT, tag 45 |
| Bridge | vmbr0 |
| Node | node1 (10.11.45.210) |
Cổng dịch vụ:
| Port | Protocol | Mục đích |
|---|---|---|
| 443 | TCP | Wazuh Dashboard (HTTPS) |
| 1514 | TCP | Kênh kết nối của Wazuh agent |
| 1515 | TCP | Agent enrollment (đăng ký) |
| 55000 | TCP | Wazuh REST API |
| 9200 | TCP | Wazuh indexer API (compose publish ra host; chỉ dùng nội bộ VM280, không mở ra mạng, xem mục 5.3) |
| 514 | UDP | Syslog (compose có publish nhưng manager mặc định không bật <remote> syslog; không dùng trong bà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.-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).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).
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)
- VM ID:
280 - Name:
wazuh-siem - Bỏ tick Start after created
- 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
- Machine:
q35 - SCSI Controller:
VirtIO SCSI single - BIOS:
SeaBIOS - Qemu Agent: ☑
- Bus/Device:
SCSI 0, Storage:vm-ceph(thường làvm-ceph) - Disk size:
100 GiB, Cache:Write back, Discard: ☑
- Sockets:
1, Cores:4, Type:x86-64-v2-AES
- Memory (MiB):
8192
- Bridge:
vmbr0, VLAN Tag:45, Model:VirtIO (paravirtualized), Firewall: ☐
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
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
- Hostname:
wazuh-siem - Username:
sysadmin(hoặc tùy chọn) - Network:
- Interface:
ens18hoặcenp6s18(tên NIC hiển thị trong trình cài đặt; kiểm bằngip -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ó
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
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
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
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
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.
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ản | Dùng cho | Giá trị mặc định | Nơi khai báo |
|---|---|---|---|
admin | Đăng nhập Dashboard; Filebeat trong manager ghi alert vào indexer | SecretPassword | Biến INDEXER_PASSWORD (service wazuh.manager và wazuh.dashboard) + hash trong config/wazuh_indexer/internal_users.yml |
kibanaserver | Dashboard kết nối indexer | kibanaserver | Biến DASHBOARD_PASSWORD + hash trong config/wazuh_indexer/internal_users.yml |
wazuh-wui | Dashboard 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
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ần | Tên container (cho docker exec, docker restart) | Tên service trong compose (cho docker compose ...) |
|---|---|---|
| Manager | single-node-wazuh.manager-1 | wazuh.manager |
| Indexer | single-node-wazuh.indexer-1 | wazuh.indexer |
| Dashboard | single-node-wazuh.dashboard-1 | wazuh.dashboard |
| Đường dẫn trong container manager | Volume / 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/bin | volume 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).
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.
- 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
- 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.)
- Á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.ymlvàinternal_users.ymlnằm dướiconfig/, và bỏ khóaversion:). Chỉ sửa lại đúng các điểm sau trên file mới (đối chiếu bằngdiff -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.yml | Mậ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.yml | Chuỗ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.yml | password của wazuh-wui nếu đã đổi; giữ run_as: true của bản mới |
config/wazuh_cluster/wazuh_manager.conf | Lấ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.
- Sinh lại chứng chỉ bằng generator mới.
generate-indexer-certs.ymlcủa tag 4.14.9 đã dùngwazuh-certs-generator:0.0.4và biếnCERT_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
- 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.
- 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-agentbản 4.9.2 (apt -ykhô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).
- 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.2và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.
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)
6.2 Thông tin đăng nhập mặc định
| Trường | Giá trị |
|---|---|
| Username | admin |
| Password | Mặ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
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):
- Đăng xuất khỏi Dashboard trước khi đổi (cookie phiên cũ sẽ gây lỗi khi vào lại).
- Mở
docker-compose.yml, thay mọi chỗ mật khẩu cũ bằng mật khẩu mới:INDEXER_PASSWORDở servicewazuh.managervàwazuh.dashboard. Nếu mật khẩu có ký tự$thì viết$$(ví dụSecret$PasswordthànhSecret$$Password). - 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
- Mở
config/wazuh_indexer/internal_users.yml, tìm khốiadmin: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). - 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
- 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.
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
10.11.45.254.14.9-1 khớp manager)
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
.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.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.
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.
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 Rule | Source | Destination | Port(s) | Action |
|---|---|---|---|---|
| Allow-Wazuh-Dashboard | VLAN_MGMT | 10.11.45.25 | 443/TCP | Accept |
| Allow-Wazuh-API | VLAN_MGMT | 10.11.45.25 | 55000/TCP | Accept |
| Allow-Wazuh-Agent | VLAN_MGMT | 10.11.45.25 | 1514/TCP | Accept |
| Allow-Wazuh-Agent | VLAN_SEC | 10.11.45.25 | 1514/TCP | Accept |
| Allow-Wazuh-Agent | VLAN_SRV | 10.11.45.25 | 1514/TCP | Accept |
| Allow-Wazuh-Agent | VLAN_DMZ | 10.11.45.25 | 1514/TCP | Accept |
| Allow-Wazuh-Enroll | ALL VLANs | 10.11.45.25 | 1515/TCP | Accept |
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"
}'
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
Sau khi DNS hoạt động, truy cập Dashboard tại: https://wazuh-siem.hoatranlabs.local
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
- Storage: chọn PBS storage đã kết nối (
pbs-primary; namespacest-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)
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.
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.
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(reponoblechính thức của Docker, không dùngdocker.io) cài đặt thành công - Wazuh 4.14.9 (tag
v4.14.9, imagewazuh/*:4.14.9) khởi động đủ 3 container (indexer, manager, dashboard) ở trạng thái Up;wazuh-control infobáoWAZUH_VERSION="v4.14.9" - Truy cập được Dashboard tại
https://10.11.45.25với user admin - Đã đổi mật khẩu mặc định của
admin,kibanaservervàwazuh-wui(mục 6.3); cổng 9200 chỉ bind127.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