System & Network privacyIDEA MFA
Bài 18 · Giai đoạn 3 — Bảo mật & Truy cập

Triển khai privacyIDEA + MFA

Xác thực đa yếu tố — bảo vệ tài khoản với OTP, FIDO2.

VM233 Ubuntu 14.04 Giai đoạn: Bảo mật & Truy cập

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

Vị trí trong chuỗi bài: Bài 18 thuộc Giai đoạn 3 — Bảo mật & Truy cập, nối tiếp Bài 17. Wazuh SIEM và đứng trước Bài 19. Vaultwarden. Cần có sẵn / liên quan: 04. Triển khai PBS + PDM · 12. Pi-hole DNS · 14. Authentik SSO · 15. Prometheus + Grafana.
Mức độ cần thiết: 🟡 Quan trọng — Hardening bảo mật tầng xác thực

Theo thống kê, hơn 80% vụ tấn công thành công bắt đầu từ credential bị lộ (phishing, data breach). Một mật khẩu dù mạnh đến đâu cũng có thể bị đánh cắp. MFA là lớp phòng vệ thứ 2: dù kẻ tấn công có mật khẩu, không có token vật lý hoặc app OTP vẫn không vào được.

MụcNội dung
Ứng dụng trong DNBảo vệ VPN login, admin panel, RADIUS authentication cho FortiGate/Wi-Fi 802.1X
Tác dụng chínhTOTP (Google Authenticator), HOTP, hardware token (YubiKey); tích hợp FreeRADIUS cho VPN
Nếu không triển khaiToàn bộ access chỉ bảo vệ bằng password — một lần lộ credentials là mất kiểm soát
Các service phụ thuộc vào đâyFortiGate (RADIUS cho VPN và đăng nhập quản trị), Wi-Fi 802.1X (Authentik hoạt động độc lập, không dùng privacyIDEA — xem Bước 6)

Phiên bản: 1.0 | Ngày cập nhật: 2026-10-15 (hệ điều hành Ubuntu Server 24.04 LTS; phiên bản phần mềm đã xác minh ngày 2026-10-15, xem bảng "Phiên bản phần mềm sử dụng" ở mục Tổng Quan Kiến Trúc)
Cluster: HOATRANHUB (PVE 9.2.20) | Tác giả: HoatranLabs

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
privacyidea (privacyIDEA MFA) · VM23310.11.25.3025 (SEC) · node1Máy chủ của bài — Ubuntu 24.04 (VM, hoặc LXC không đặc quyền), chạy privacyIDEA 3.14 (gói NetKnights, Apache2, HTTPS 443) và FreeRADIUS 3.2.10 (kho InkBridge) cùng host, lắng nghe UDP 1812.
node1 (Proxmox VE)10.11.45.21045 (MGMT) · cluster HOATRANHUBNode Proxmox chứa VM233 (hoặc CT233 nếu dùng LXC); tạo VM hoặc container tại đây và đặt backup job (daily 02:30) cho 233.
FortiGate (firewall)10.100.100.1Quản trị 10.100.100.0/24 · thiết bị mạngRADIUS client của FreeRADIUS; trỏ RADIUS server tới privacyIDEA cổng 1812 để đăng nhập quản trị FortiGate yêu cầu MFA.
pihole (Pi-hole DNS) · VM24710.11.45.5345 (MGMT) · node3DNS của VM233; thêm bản ghi A privacyidea và mfa (bài 12) trỏ về máy chủ privacyIDEA.
authentik (Authentik SSO) · VM23410.11.25.4025 (SEC) · node1Độc lập với privacyIDEA: tùy chọn chạy RADIUS Outpost (RADIUS server riêng, UDP 1812 trên VM234) cho thiết bị dùng tài khoản Authentik; không phải client của FreeRADIUS (Bước 6, bài 14).
prometheus (Prometheus + Alertmanager) · VM23510.11.45.3545 (MGMT) · node2Scrape node_exporter :9100 của VM233; firewall và ufw chỉ cho nguồn này vào cổng 9100 (bài 15).
pbs01 (PBS Primary) · VM10110.11.45.1745 (MGMT) · node4Đích backup (storage pbs-primary) của VM233: snapshot daily 02:30, retention do Prune Job trên PBS quản lý (bài 04).

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.

Phụ thuộc (Dependencies)

Thành phầnVMIDIPTrạng thái cần có
PVE node1—10.11.45.210Running
FortiGate—10.100.100.1Running
Pi-hole DNSVM24710.11.45.53Running
Authentik SSOVM23410.11.25.40Không bắt buộc (chỉ cần nếu dùng RADIUS Outpost tùy chọn ở Bước 6; độc lập với privacyIDEA)
Prometheus (scrape)VM23510.11.45.35Running
PBS Backup (pbs01)VM10110.11.45.17Running
Ceph storage pool vm-ceph——Healthy

Tổng Quan Kiến Trúc

┌─────────────────────────────────┐
                │  VM233: privacyidea              │
                │  10.11.25.30 | VLAN_SEC tag=25   │
                │  privacyIDEA :443/:80            │
                │  FreeRADIUS  :1812 (UDP)         │
                │  node_exporter :9100             │
                └────────────────┬────────────────┘
                                 │ RADIUS UDP 1812
                      ┌──────────▼──────────┐
                      │  FortiGate           │
                      │  Admin RADIUS        │
                      │  auth login 2FA      │
                      └─────────────────────┘

   Độc lập, không đi qua privacyIDEA: Authentik SSO (VM234) — web SSO + RADIUS Outpost riêng (Bước 6)

Vai trò của privacyIDEA trong hệ thống:

  • RADIUS authentication: FortiGate, VPN client, switch quản trị dùng RADIUS để xác thực admin với MFA.
  • TOTP/HOTP token: Người dùng enroll token qua Google Authenticator, FreeOTP, Aegis.
  • WebAuthn: Hỗ trợ hardware key (YubiKey, FIDO2).
  • Email/SMS OTP: Fallback khi mất thiết bị TOTP.
  • Bổ trợ Authentik: Authentik xử lý web SSO, privacyIDEA xử lý RADIUS cho thiết bị mạng. Hai hệ thống độc lập, không thay thế nhau.

Phương án triển khai (đã xác minh ngày 2026-10-15). Series ưu tiên Docker, rồi LXC, rồi VM; với privacyIDEA, Docker chưa đạt điều kiện (có image hoặc compose chính thức của hãng và đủ ổn định) nên bài giữ cài bằng gói apt của NetKnights và đưa LXC vào làm phương án nhẹ hơn VM:

Phương ánTrạng thái trong bàiPhù hợp khiLý do và nguồn
VM Ubuntu 24.04 + gói NetKnights (apt), Bước 1 Cách 1–2 và Bước 3Chọn, là cách mặc định của bàiCần cách cài được tài liệu bản ổn định mô tả đầy đủ, nâng cấp bằng apt, giữ nguyên VM233Mục Installation của tài liệu bản stable (3.14) chỉ có pip, gói Ubuntu 20.04/22.04/24.04 và CentOS/RHEL (https://privacyidea.readthedocs.io/en/stable/installation/index.html); kho community/noble/stable có gói 3.14-1noble
LXC không đặc quyền Ubuntu 24.04 + gói NetKnights, Bước 1 Cách 3Phương án thay thế, nhẹ hơn VMMuốn tiết kiệm RAM và đĩa, không cần live-migrateCùng gói, cùng các Bước 2–10 như VM. Docker không chạy trong LXC (Proxmox không khuyến nghị) nên LXC chỉ đi với cách apt. Chưa chạy thử trên máy thật
Docker Compose của hãng (thư mục deploy/docker trong mã nguồn privacyIDEA)Chưa chọn, theo dõiKhi hãng công bố image và cấu trúc compose ổn địnhXem bốn lý do ngay dưới bảng
Image Docker cộng đồng (khalibre/privacyidea, kheeklab/privacyidea, esutwo/privacyidea...)Không dùngChỉ để thử nghiệmKhông phải của NetKnights: README của Khalibre ghi rõ privacyIDEA do NetKnights duy trì, dự án này tách biệt và tag latest không phù hợp cho production (https://github.com/Khalibre/privacyidea-docker)

Bốn lý do chưa chuyển sang Docker:

  • Chưa có image công bố. Namespace privacyidea trên Docker Hub chỉ có otpserver (cập nhật lần cuối 2015-10-11) và debian-wheezy (https://hub.docker.com/u/privacyidea); repo privacyidea/docker (Ubuntu 14.04, README ghi "must not use in productive environment") đã chuyển sang trạng thái archived, lần cập nhật cuối 2020-04-30 (https://github.com/privacyidea/docker). Compose của hãng vẫn dùng build: từ mã nguồn; README mục TODO ghi "Publish an image so build: can be replaced with image:" và workflow CI ghi "no image is published from this repository" (https://github.com/privacyidea/privacyidea/tree/v3.14/deploy/docker). Tự build phải clone đủ lịch sử git ở tag v3.14, build Angular bằng npm cùng Python, trên nền cgr.dev/chainguard/wolfi-base không ghim phiên bản.
  • Bộ compose đầy đủ còn mới và đang được viết lại. Bản có secrets, backup/restore, cron, TLS chỉ có từ commit ngày 2026-07-02, lần đầu nằm trong bản phát hành 3.14 (2026-10-07); thư mục này ở v3.13 chỉ có 5 file. Pull request #6083 (mở 2026-10-06, nhánh branch-3.14) đang đổi sang kéo image phát hành, thêm chế độ database ngoài, nâng MariaDB, đổi tên example.env thành privacyidea.env và quy trình nâng cấp (https://github.com/privacyidea/privacyidea/pull/6083), nên hướng dẫn viết theo cấu trúc hiện tại sẽ lỗi thời ngay.
  • Compose ở tag v3.14 dùng mariadb:10.6, bản đã hết hạn hỗ trợ ngày 2026-07-06 (https://endoflife.date/mariadb); PR #6083 đề xuất MariaDB 11.4.
  • Tài liệu bản ổn định chưa nhắc Docker. Mục "2.11 Docker" chỉ có ở bản latest (https://privacyidea.readthedocs.io/en/latest/installation/index.html), gồm vài dòng trỏ tới README trong mã nguồn, mô tả là "single-node" và không có khuyến nghị cho production. Stack của hãng cũng không có FreeRADIUS (FreeRADIUS có image chính thức freeradius/freeradius-server:3.2.10, cấu hình ở /etc/raddb; việc image có sẵn rlm_rest cần kiểm lại trên máy thật, https://hub.docker.com/r/freeradius/freeradius-server).

Khi hãng công bố image phát hành (compose không còn build:) và PR #6083 hoặc bản tương đương đã được gộp, nên chuyển sang Docker Compose (privacyIDEA + MariaDB còn hỗ trợ, FreeRADIUS tách riêng, Nginx/TLS step-CA đặt phía trước), giữ nguyên VMID, IP và VLAN. Phần cần mang theo là enckey, PI_PEPPER, SECRET_KEY, khóa audit và bản dump database từ pi-manage backup create -e (Bước 10); cách nhập vào stack Docker cần kiểm lại trên máy thật.

Phiên bản phần mềm sử dụng (đã xác minh ngày 2026-10-15; số bản sẽ tăng theo thời gian, bài ghi lại bản đã kiểm để các bước khớp nhau):

Thành phầnPhiên bảnGhi chú
Ubuntu Server24.04.5 LTS (noble)ISO ubuntu-24.04.5-live-server-amd64.iso (https://releases.ubuntu.com/24.04/); hỗ trợ chuẩn tới 04/2029; kernel 6.8, Python 3.12
privacyIDEA3.14 (gói 3.14-1noble)Kho NetKnights community/noble/stable; gói tự dựng virtualenv /opt/privacyidea (phụ thuộc python3-virtualenv) nên không vướng PEP 668 của Python 3.12. Bản 3.14 phát hành 2026-10-08, WebUI mới là mặc định
Apache2 + mod_wsgi2.4.58 (kho Ubuntu noble)Do gói privacyidea-apache2 kéo về
MySQL8.0.x (kho Ubuntu noble)Gói yêu cầu mysql-server hoặc mariadb-server; nếu chưa cài cái nào thì apt chọn mysql-server
FreeRADIUS3.2.10 (kho InkBridge Networks cho noble)Gói Ubuntu noble là 3.2.5, thấp hơn 3.2.9 nên dính thông báo bảo mật ngày 2026-06-01 (https://www.freeradius.org/security/); gói InkBridge đặt cấu hình tại /etc/freeradius/ (không có 3.0)
freeradius-rest (rlm_rest)3.2.10Cùng kho InkBridge; privacyIDEA gọi endpoint /validate/radiuscheck
chrony4.5 (kho Ubuntu noble)Đồng bộ giờ cho TOTP (chỉ cài trên VM; container LXC dùng đồng hồ của node1)
Template LXC (chỉ Bước 1 Cách 3)ubuntu-24.04-standard_24.04-2_amd64.tar.zstTemplate của Proxmox Support Team, có trong aplinfo-pve-9.dat (http://download.proxmox.com/images/aplinfo-pve-9.dat); dùng pveam available để xem bản mới hơn
node_exporter1.12.1Cài bằng script ở bài 15
01

Tạo VM233

Dung lượng đĩa trong lab: dựng bằng create-lab-vms.sh (bài 07) thì VM233 có scsi0 = 20 GB trên SSD vm-ceph (thin provisioning) và không có đĩa dữ liệu scsi1 (xdisk = 0). Số 30 GB ở bài này là trần danh nghĩa/khuyến nghị cho môi trường thật; privacyIDEA (gói NetKnights + MySQL/MariaDB) chỉ cần hệ điều hành ≈ 6–7 GB cộng ứng dụng 1–2 GB theo ước tính ở bài 07 (mục 8.6), nên 20 GB là đủ và cần thêm thì qm resize 233 scsi0 +10G.

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: 233
  • Name: privacyidea
  • 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
  • Disk size: 30 GiB, Cache: Write back, Discard: ☑
6
CPU:
  • Sockets: 1, Cores: 2, Type: x86-64-v2-AES
7
Memory:
  • Memory (MiB): 4096
8
Network:
  • Bridge: vmbr0, VLAN Tag: 25, 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 233 privacyidea trên node1, 2 core x86-64-v2-AES, 4096 MiB, scsi0 vm-ceph 30G, net0 tag=25.
Proxmox Create VM → tab Confirm: VM 233 privacyidea trên node1, 2 core x86-64-v2-AES, 4096 MiB, scsi0 vm-ceph 30G, net0 tag=25.

Cách 2: CLI (qm create)

Chạy trên node PVE node1:

qm create 233 \
  --name privacyidea \
  --memory 4096 \
  --cores 2 \
  --net0 virtio,bridge=vmbr0,tag=25 \
  --scsi0 vm-ceph:30 \
  --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 \
  --onboot 1 \
  --startup order=2,up=30

📦 Cách 3: LXC không đặc quyền (phương án thay thế, nhẹ hơn VM)

Dùng khi muốn tiết kiệm RAM và đĩa so với VM. Container giữ nguyên VMID 233, hostname privacyidea, IP 10.11.25.30, VLAN 25 và node1, chạy cùng gói NetKnights và cùng các Bước 2–10 như VM. Cách này chưa chạy thử trên máy thật, cần kiểm lại. Trước hết kiểm tra storage vm-ceph cho phép chứa container (cột Content phải có rootdir; nếu thiếu, vào Datacenter → Storage → vm-ceph → Edit → Content và chọn thêm Container):

# Trên node1
pvesm status --content rootdir

Tải template Ubuntu 24.04 rồi tạo container (tên template lấy từ pveam available, bản đã kiểm 2026-10-15 là 24.04-2):

pveam update
pveam available --section system | grep ubuntu-24.04
pveam download local ubuntu-24.04-standard_24.04-2_amd64.tar.zst

pct create 233 local:vztmpl/ubuntu-24.04-standard_24.04-2_amd64.tar.zst \
  --hostname privacyidea \
  --ostype ubuntu \
  --unprivileged 1 \
  --features nesting=0 \
  --cores 2 \
  --memory 4096 \
  --swap 512 \
  --rootfs vm-ceph:30 \
  --net0 name=eth0,bridge=vmbr0,tag=25,ip=10.11.25.30/24,gw=10.11.25.1 \
  --nameserver 10.11.45.53 \
  --searchdomain hoatranlabs.local \
  --onboot 1 \
  --startup order=2,up=30

pct start 233
pct enter 233

Trong container, tạo user chuẩn của lab rồi tiếp tục từ Bước 2 (chạy bằng root hoặc sudo):

apt update && apt install -y sudo openssh-server
adduser --gecos "" sysadmin
usermod -aG sudo sysadmin

Khác biệt so với VM cần nhớ:

  • Không có ISO và trình cài đặt, không có Qemu Agent. qm set 233 --ide2 none bên dưới chỉ dành cho VM.
  • Ở Bước 2 bỏ gói chrony khỏi danh sách apt install: container dùng chung đồng hồ với node1 và không tự chỉnh giờ được, nên đảm bảo node1 đồng bộ giờ đúng (TOTP vẫn cần giờ chuẩn). Trong phần Xử Lý Sự Cố, lệnh chronyc chạy trên node1 thay vì trong container.
  • Backup: job daily 02:30 ở Bước 10 chọn ID 233 như VM, vzdump sao lưu container vào cùng storage pbs-primary (chế độ Snapshot, cần kiểm lại trên máy thật với rootfs trên vm-ceph). pi-manage backup create -e trong container vẫn chạy như bình thường.
  • ufw trong container không đặc quyền cần kiểm lại trên máy thật; nếu không dùng được, đặt cùng các quy tắc ở tab Firewall của container trong Proxmox.
  • LXC không live-migrate: khi HA chuyển sang node khác, container khởi động lại thay vì di chuyển nóng.
  • Không cài Docker trong container này (Proxmox không khuyến nghị Docker trong LXC); privacyIDEA bản apt không cần Docker.

Cài đặt OS Ubuntu Server 24.04 LTS (chỉ dành cho VM; với LXC bỏ qua phần này và đi tiếp Bước 2):

Hostname    : privacyidea
Username    : sysadmin
Password    : <mật khẩu mạnh>
IP          : 10.11.25.30/24
Gateway     : 10.11.25.1
DNS         : 10.11.45.53

Tên card mạng trong installer thường là ens18 (hoặc enp6s18 trên VM q35): kiểm tra bằng ip -br link và dùng đúng tên đó khi đặt IP tĩnh. Tích chọn Install OpenSSH server, không cài thêm snap nào ở màn hình Featured Server Snaps.

Sau khi cài xong, eject ISO:

qm set 233 --ide2 none
02

Chuẩn Bị Hệ Thống

apt update && apt upgrade -y
apt install -y curl wget git ca-certificates gnupg lsb-release \
               python3 openssl chrony

Các lệnh trong bài chạy bằng root (sudo -i) hoặc thêm sudo phía trước. Trên Ubuntu 24.04, needrestart có thể hiện hộp thoại "Daemons using outdated libraries" sau apt upgrade: chọn mặc định (Enter) rồi tiếp tục. Python của hệ thống là 3.12 và bị chặn pip install ngoài virtualenv (PEP 668), nên bài không cài python3-pip: privacyIDEA tự có virtualenv riêng ở /opt/privacyidea do gói tạo (Bước 3).

chrony đồng bộ giờ cho VM233 (TOTP rất nhạy với lệch giờ, xem phần Xử Lý Sự Cố). VM233 không chạy container nên không cần cài Docker (lý do chọn gói apt thay vì Docker ở bảng "Phương án triển khai" trong Tổng Quan Kiến Trúc). Nếu dùng LXC (Bước 1, Cách 3) thì bỏ chrony khỏi lệnh apt install ở trên.

Cài node_exporter cho Prometheus bằng script install-node-exporter.sh ở Bước 5 của bài 15 (VM233 không nằm trong hai VM bị loại trừ là VM235 và VM236); cổng 9100 được mở ở Bước 9 của bài này.

03

Triển Khai privacyIDEA bằng Gói Ubuntu

Lưu ý về cách triển khai: mục Installation trong tài liệu bản ổn định của privacyIDEA (https://privacyidea.readthedocs.io/en/stable/installation/index.html) chỉ mô tả cài bằng gói Ubuntu 20.04/22.04/24.04 từ repository của NetKnights, bằng pip hoặc trên CentOS; không có image Docker chính thức nào được nêu. Bản latest của tài liệu có thêm mục Docker trỏ tới deploy/docker trong mã nguồn, nhưng hãng chưa công bố image và bộ compose đang được viết lại (xem bảng "Phương án triển khai" ở Tổng Quan Kiến Trúc, kiểm ngày 2026-10-15). Image privacyidea/privacyidea:latest cùng các biến PI_PASSWORD, PI_PEPPER, DATABASE_URI, SECRET_KEY, PI_LOGLEVEL ở bản cũ của bài không xác minh được (repo privacyidea/privacyidea chưa tồn tại trên Docker Hub) nên đã bỏ. Bước này cài bằng gói Ubuntu 24.04 (noble) theo https://privacyidea.readthedocs.io/en/stable/installation/ubuntu.html; tiêu đề bước giữ nguyên như bản gốc dù không còn dùng Docker. Kho community/noble/stable của NetKnights có gói privacyidea-apache2 bản 3.14-1noble (kiểm ngày 2026-10-15).

Thêm khóa ký và repository của NetKnights (Ubuntu 24.04), rồi cài privacyIDEA chạy trên Apache2. Tài liệu chính thức đặt khóa vào /etc/apt/trusted.gpg.d/; bài này đặt vào /etc/apt/keyrings/ và khai báo repository dạng deb822 với Signed-By (không dùng apt-key), cách đặt này chưa chạy thử trên máy thật, cần kiểm lại:

# Tải khóa ký gói và kiểm tra fingerprint: phải là 0940 4ABB EDB3 586D EDE4 AD22 00F7 0D62 AE25 0082
cd /tmp
wget https://lancelot.netknights.it/NetKnights-Release.asc
gpg --import --import-options show-only --with-fingerprint NetKnights-Release.asc

# Ubuntu 24.04 (noble): đặt khóa vào /etc/apt/keyrings/ và thêm repository dạng deb822
install -d -m 0755 /etc/apt/keyrings
mv NetKnights-Release.asc /etc/apt/keyrings/NetKnights-Release.asc
cat > /etc/apt/sources.list.d/privacyidea-community.sources << 'EOF'
Types: deb
URIs: http://lancelot.netknights.it/community/noble/stable
Suites: noble
Components: main
Signed-By: /etc/apt/keyrings/NetKnights-Release.asc
EOF

# Cài privacyIDEA + Apache2 + MySQL (gói tắt các site mặc định khác của Apache)
apt update
apt install -y privacyidea-apache2
apt-cache policy privacyidea | head -3    # kỳ vọng: Installed 3.14-1noble

Gói privacyidea tự tạo virtualenv /opt/privacyidea bằng Python 3.12 của noble và cài thư viện vào đó, nên các lệnh quản trị như pi-manage nằm trong /opt/privacyidea/bin (nếu shell không tìm thấy lệnh, thêm thư mục này vào PATH như script ở Bước 10); PEP 668 không ảnh hưởng vì không có pip install nào chạy ngoài virtualenv. Trên noble, gói yêu cầu mysql-server hoặc mariadb-server nên apt cài MySQL 8.0; muốn dùng MariaDB 10.11 thì cài mariadb-server trước (chưa kiểm chứng gói privacyIDEA tạo database đúng trên MariaDB, cần kiểm lại trên máy thật).

Gói privacyidea-apache2 tự thực hiện các việc sau khi cài (theo script cài đặt của gói), nên không còn bước tự sinh PEPPER/SECRET_KEY hay viết file cấu hình như trước:

  • Tạo /etc/privacyidea/pi.cfg với PI_PEPPER và SECRET_KEY ngẫu nhiên.
  • Tạo database MySQL pi với user pi (mật khẩu ngẫu nhiên, ghi trong pi.cfg) và các bảng.
  • Sinh khóa mã hóa token /etc/privacyidea/enckey và khóa ký audit.
  • Tạo chứng chỉ HTTPS tự ký (CN là hostname, /etc/ssl/certs/privacyideaserver.pem) và bật site HTTPS cổng 443 của Apache.

PI_PEPPER và enckey không được đổi hoặc mất sau khi đã tạo token (mất enckey là mất toàn bộ seed token); cả hai nằm trong /etc/privacyidea/ và được sao lưu ở Bước 10.

privacyIDEA không có sẵn tài khoản quản trị, tạo admin đầu tiên (nhập mật khẩu mẫu Admin@privacyIDEA2024 của bài khi được hỏi, hai lần):

pi-manage admin add admin -e [email protected]

Kiểm tra:

curl -sk -o /dev/null -w "%{http_code}\n" https://10.11.25.30/
# Kết quả mong đợi: 200 (WebUI privacyIDEA đã chạy; endpoint /auth chỉ nhận POST nên không dùng GET để kiểm tra)
Terminal: curl -sk -o /dev/null -w "%{http_code}" https://10.11.25.30/ trả về 200, WebUI privacyIDEA đã chạy.
Terminal: curl -sk -o /dev/null -w "%{http_code}" https://10.11.25.30/ trả về 200, WebUI privacyIDEA đã chạy.
04

Cài Và Cấu Hình FreeRADIUS

FreeRADIUS được cài trực tiếp trên host VM233, cùng máy với privacyIDEA, để dễ debug và quản lý UDP port.

Nguồn gói: gói FreeRADIUS của Ubuntu 24.04 là 3.2.5 (3.2.5+dfsg-3~ubuntu24.04.1). Thông báo bảo mật ngày 2026-06-01 trên https://www.freeradius.org/security/ nêu các bản 3.2.x trước 3.2.9 có lỗi tràn bộ đệm (NAS-Filter-Rule, EAP-MD5, EAP-MSCHAPv2, TEAP) và rò bộ nhớ, nên bài cài FreeRADIUS 3.2.x mới nhất (3.2.10 lúc kiểm, 2026-10-15) từ kho APT chính thức của InkBridge Networks (trước đây là Network RADIUS) cho Ubuntu 24.04 theo https://packages.inkbridgenetworks.com/. Khác biệt cần nhớ: gói InkBridge đặt cấu hình ở /etc/freeradius/ (không có thư mục 3.0 như gói Ubuntu), các đường dẫn bên dưới đã theo quy ước này. Chưa kiểm chứng gói Ubuntu đã backport bản vá hay chưa (cần kiểm lại trên máy thật bằng apt changelog freeradius).

# Khóa ký và kho InkBridge cho Ubuntu 24.04 (noble); trang gói ghi dạng một dòng, đây là bản chuyển sang deb822 (cần kiểm lại trên máy thật)
install -d -o root -g root -m 0755 /etc/apt/keyrings
curl -fsSL https://packages.inkbridgenetworks.com/pgp/packages.networkradius.com.asc \
  -o /etc/apt/keyrings/packages.networkradius.com.asc
# Đối chiếu fingerprint của khóa với trang https://packages.inkbridgenetworks.com/ trước khi tin cậy
gpg --show-keys --with-fingerprint /etc/apt/keyrings/packages.networkradius.com.asc

cat > /etc/apt/sources.list.d/inkbridge-freeradius.sources << 'EOF'
Types: deb
URIs: http://packages.inkbridgenetworks.com/freeradius-3.2/ubuntu/noble
Suites: noble
Components: main
Architectures: amd64
Signed-By: /etc/apt/keyrings/packages.networkradius.com.asc
EOF

# Ưu tiên gói của InkBridge hơn gói 3.2.5 của Ubuntu (khuyến nghị của InkBridge: Pin-Priority 999)
printf 'Package: /freeradius/\nPin: origin "packages.inkbridgenetworks.com"\nPin-Priority: 999\n' \
  > /etc/apt/preferences.d/networkradius

apt update
apt install -y freeradius freeradius-utils freeradius-rest

# Kiểm tra phiên bản (kỳ vọng 3.2.10, không phải 3.2.5) và nguồn gói
freeradius -v | head -1
apt-cache policy freeradius | head -4

FreeRADIUS gọi privacyIDEA bằng module rlm_rest (gói freeradius-rest vừa cài) tới endpoint /validate/radiuscheck — endpoint dành riêng cho RADIUS, trả HTTP 204 khi xác thực thành công và 400 cho mọi trường hợp khác (khác /validate/check, luôn trả 200 kể cả khi sai OTP). Không cần cài thêm plugin Python nào. Hạn chế của rlm_rest: không hỗ trợ challenge-response và attribute mapping (nếu cần, dùng plugin Perl của privacyIDEA).

Tạo module cấu hình FreeRADIUS cho privacyIDEA:

cat > /etc/freeradius/mods-available/privacyidea << 'EOF'
# privacyIDEA rlm_rest module (instance tên "privacyidea")
rest privacyidea {
    connect_uri = "https://10.11.25.30"

    tls {
        check_cert = no
        check_cert_cn = no
    }

    authenticate {
        uri = "${..connect_uri}/validate/radiuscheck"
        method = 'post'
        body = 'post'
        data = "user=%{urlquote:%{User-Name}}&pass=%{urlquote:%{User-Password}}&realm=hoatranlabs"
        force_to = 'plain'
        tls = ${..tls}
    }
}
EOF

# Kích hoạt module
ln -sf /etc/freeradius/mods-available/privacyidea \
        /etc/freeradius/mods-enabled/privacyidea

Cấu hình site privacyIDEA:

cat > /etc/freeradius/sites-available/privacyidea << 'EOF'
server privacyidea {
    listen {
        type = auth
        ipaddr = *
        port = 1812
    }

    listen {
        type = acct
        ipaddr = *
        port = 1813
    }

    authorize {
        filter_username
        preprocess
        update control {
            Auth-Type := privacyidea
        }
    }

    authenticate {
        Auth-Type privacyidea {
            privacyidea
        }
    }

    accounting {
        ok
    }
}
EOF

# Kích hoạt site
ln -sf /etc/freeradius/sites-available/privacyidea \
        /etc/freeradius/sites-enabled/privacyidea

# Tắt site mặc định "default" (BẮT BUỘC): site này cũng listen UDP 1812 (auth) và 1813 (acct) giống site privacyidea ở trên,
# hai virtual server cùng bind một cổng thì FreeRADIUS báo "Error binding to port ... 1812" và không khởi động.
# Chỉ xóa symlink trong sites-enabled, giữ nguyên file trong sites-available để khôi phục khi cần
rm -f /etc/freeradius/sites-enabled/default

Thêm RADIUS client (FortiGate):

cat >> /etc/freeradius/clients.conf << 'EOF'

# FortiGate firewall
client fortigate {
    ipaddr          = 10.100.100.1
    secret          = RADIUS_SHARED_SECRET_FORTIGATE
    shortname       = fortigate
    nas_type        = other
    require_message_authenticator = no
}

# Toàn bộ VLAN_MGMT (cho PVE nodes)
client vlan-mgmt {
    ipaddr          = 10.11.45.0/24
    secret          = RADIUS_SHARED_SECRET_MGMT
    shortname       = vlan-mgmt
    nas_type        = other
}
EOF

Kiểm tra cấu hình và khởi động:

# Kiểm tra cú pháp cấu hình
freeradius -CX

# Khởi động
systemctl enable --now freeradius
systemctl status freeradius
Terminal VM233: freeradius -CX báo Configuration appears to be OK, systemctl status freeradius ở trạng thái active (running) và nghe UDP 1812.
Terminal VM233: freeradius -CX báo Configuration appears to be OK, systemctl status freeradius ở trạng thái active (running) và nghe UDP 1812.
05

Tích Hợp FortiGate RADIUS

Đăng nhập FortiGate CLI hoặc GUI, thêm RADIUS server:

Qua GUI (User & Authentication → RADIUS Servers → Create New):

Name           : privacyidea-radius
Server IP      : 10.11.25.30
Server Secret  : RADIUS_SHARED_SECRET_FORTIGATE
Port           : 1812
Authentication : PAP
FortiGate GUI → User & Authentication → RADIUS Servers → Create New: Name privacyidea-radius, Server IP 10.11.25.30, port 1812, Authentication PAP.
FortiGate GUI → User & Authentication → RADIUS Servers → Create New: Name privacyidea-radius, Server IP 10.11.25.30, port 1812, Authentication PAP.

Qua CLI FortiGate:

config user radius
    edit "privacyidea-radius"
        set server "10.11.25.30"
        set secret "RADIUS_SHARED_SECRET_FORTIGATE"
        set auth-type pap
        set radius-port 1812
    next
end

# Tạo user group dùng RADIUS: mọi user được privacyIDEA xác thực thành công đều thuộc nhóm này
# (tương đương chọn Groups: Any khi thêm Remote Server vào nhóm trên GUI).
# KHÔNG dùng "config match ... group-name": mục này chỉ khớp khi RADIUS server trả thuộc tính nhóm
# (Fortinet-Group-Name), mà FreeRADIUS + rlm_rest của privacyIDEA không trả thuộc tính nào nên mọi lần đăng nhập sẽ bị từ chối
config user group
    edit "mfa-admins"
        set member "privacyidea-radius"
    next
end

# Áp dụng cho admin login: tạo admin wildcard RIÊNG, KHÔNG gắn remote-auth vào tài khoản "admin" cục bộ
config system admin
    edit "mfa-wildcard-admin"
        set remote-auth enable
        set accprofile "super_admin"
        set wildcard enable
        set remote-group "mfa-admins"
    next
end

Tránh tự khóa khỏi FortiGate: giữ nguyên tài khoản admin cục bộ (mật khẩu mạnh, không bật remote-auth) làm đường vào dự phòng khi privacyIDEA hoặc FreeRADIUS không phản hồi. mfa-wildcard-admin là tài khoản wildcard theo cách của tài liệu FortiOS (https://docs.fortinet.com/document/fortigate/7.6.4/administration-guide/747268/configuring-wildcard-admin-accounts): người dùng đăng nhập bằng username của mình trong privacyIDEA (realm hoatranlabs) và mật khẩu dạng mật_khẩu+OTP, FortiGate gán quyền theo tài khoản wildcard này. Thử đăng nhập bằng một phiên trình duyệt khác trước khi đóng phiên quản trị đang mở.

Nếu muốn giới hạn theo nhóm RADIUS, FreeRADIUS phải trả thuộc tính Fortinet-Group-Name: trong khối authorize của site privacyidea thêm update reply { Fortinet-Group-Name := "admins" }, rồi trong config user group thêm config match (edit 1, set server-name "privacyidea-radius", set group-name "admins").

06

Tích Hợp Authentik (RADIUS Outpost)

Authentik và privacyIDEA là hai hệ thống độc lập, không gọi lẫn nhau. RADIUS Outpost của Authentik là một RADIUS server: thiết bị mạng (FortiGate, switch, Wi-Fi...) gửi Access-Request tới outpost, và outpost xác thực bằng các flow/stage của chính Authentik (Identification, Password, Authenticator validation). Outpost không "kết nối tới" FreeRADIUS hay privacyIDEA, và tài liệu của Authentik không có cách chuyển request RADIUS sang privacyIDEA hoặc dùng privacyIDEA làm stage MFA của Authentik (khi dùng qua RADIUS, stage Authenticator validation chỉ hỗ trợ Duo, TOTP và static). Vì vậy không khai báo Authentik là client trong clients.conf của FreeRADIUS.

Hệ thốngVai trò RADIUSDùng cho
privacyIDEA + FreeRADIUS (VM233, 10.11.25.30:1812)RADIUS server, MFA do privacyIDEA (TOTP/HOTP/WebAuthn...)FortiGate admin/VPN, thiết bị cần MFA do privacyIDEA quản lý (Bước 4–5)
Authentik RADIUS Outpost (VM234, 10.11.25.40:1812)RADIUS server riêng, tài khoản và MFA (TOTP) do Authentik quản lýThiết bị cần RADIUS nhưng dùng tài khoản Authentik (tùy chọn)

Mỗi thiết bị chỉ trỏ tới MỘT trong hai RADIUS server. Phần dưới là cách bật RADIUS Outpost của Authentik (tùy chọn; bỏ qua nếu không cần):

Trong Authentik (https://10.11.25.40:9443):

1
Vào Applications → Providers → Create → RADIUS Provider: chọn flow xác thực (ví dụ default-authentication-flow), Shared secret RADIUS_SHARED_SECRET_AUTHENTIK, Client networks là IP/CIDR của thiết bị gọi tới (ví dụ 10.100.100.1/32 cho FortiGate)
2
Tạo Application gắn với provider này
3
Vào Applications → Outposts → Create: Type RADIUS, Name radius-outpost, Integration Local Docker Integration (outpost chạy trên chính VM234), chọn Application vừa tạo
Authentik Admin (https://10.11.25.40:9443) → Applications → Outposts → Create: Type RADIUS, Name radius-outpost, Integration Local Docker Integration (chạy trên VM234, nghe UDP 1812), chọn Application vừa tạo.
Authentik Admin (https://10.11.25.40:9443) → Applications → Outposts → Create: Type RADIUS, Name radius-outpost, Integration Local Docker Integration (chạy trên VM234, nghe UDP 1812), chọn Application vừa tạo.
4
Outpost lắng nghe UDP 1812 trên VM234 (10.11.25.40). Trên thiết bị, trỏ RADIUS server tới 10.11.25.40:1812 với đúng shared secret ở trên. Khi user có TOTP trong Authentik, nhập mật_khẩu;mã_TOTP vào ô password (mã được nối sau mật khẩu, ngăn cách bằng dấu chấm phẩy)

Nếu bật UFW trên VM234, mở ufw allow from 10.100.100.1 to any port 1812 proto udp. Kiểm tra bằng radtest hoặc diagnose test authserver radius của FortiGate như Bước 8, nhưng trỏ tới 10.11.25.40.

07

Đăng Nhập và Tạo Token MFA

Truy cập privacyIDEA admin: https://10.11.25.30
Login: admin / Admin@privacyIDEA2024

Trình duyệt tại https://10.11.25.30: trang đăng nhập quản trị privacyIDEA với tài khoản admin.
Trình duyệt tại https://10.11.25.30: trang đăng nhập quản trị privacyIDEA với tài khoản admin.
privacyIDEA 3.14 dùng WebUI mới làm mặc định (https://github.com/privacyidea/privacyidea/blob/v3.14/READ_BEFORE_UPDATE.md). Tên menu trong các bước dưới (Config → Realms, Tokens → Enroll Token) theo giao diện cũ và chưa đối chiếu với WebUI mới, cần kiểm lại trên máy thật. Ghi chú phát hành 3.14 không nêu thay đổi nào cho các endpoint API bài dùng (/auth, /token/init, /validate/radiuscheck), nhưng chưa chạy thử.

Tạo Realm:

1
Config → Realms → Create New Realm
2
Name: hoatranlabs
3
Resolver: Create User Resolver
  • Type: Passwdresolver (cho local users) hoặc LDAP (nếu có AD)
privacyIDEA → Config → Realms → Create New Realm: realm hoatranlabs với User Resolver kiểu Passwdresolver.
privacyIDEA → Config → Realms → Create New Realm: realm hoatranlabs với User Resolver kiểu Passwdresolver.

Enroll TOTP token cho user:

1
Tokens → Enroll Token
2
Token Type: TOTP
3
User: admin (realm: hoatranlabs)
4
Scan QR code bằng Google Authenticator / Aegis / FreeOTP
privacyIDEA → Tokens → Enroll Token: Token Type TOTP, user admin (realm hoatranlabs), màn hình hiện mã QR để quét bằng app OTP.
privacyIDEA → Tokens → Enroll Token: Token Type TOTP, user admin (realm hoatranlabs), màn hình hiện mã QR để quét bằng app OTP.
5
Verify OTP một lần để xác nhận

Enroll token qua CLI (automation):

# Lấy auth token
TOKEN=$(curl -sk -X POST https://10.11.25.30/auth \
  -d "username=admin&password=Admin@privacyIDEA2024" \
  | python3 -c "import sys,json; print(json.load(sys.stdin)['result']['value']['token'])")

# Enroll TOTP cho user testuser
curl -sk -X POST https://10.11.25.30/token/init \
  -H "Authorization: ${TOKEN}" \
  -d "type=totp&user=testuser&realm=hoatranlabs&genkey=1"
08

Kiểm Tra RADIUS Authentication

# Kiểm tra từ CLI trên VM233, dùng client "localhost" có sẵn trong clients.conf của FreeRADIUS
# (127.0.0.1, secret mặc định testing123; 10.11.25.30 không phải client đã khai báo nên không dùng làm nguồn)
# radtest user password radius-server nas-port shared-secret
radtest testuser "PASSWORD_THEN_OTP" 127.0.0.1 0 testing123

# Ví dụ: password là "MyPass123456" (password + OTP liền nhau)
radtest testuser "MyPass123456" 127.0.0.1 0 testing123

# Kết quả mong đợi khi thành công:
# Received Access-Accept Id 0 from 127.0.0.1:1812

# Từ một máy khác trong VLAN_MGMT (client vlan-mgmt; cần thêm ufw allow UDP 1812 từ máy đó):
# radtest testuser "PASSWORD_THEN_OTP" 10.11.25.30 0 RADIUS_SHARED_SECRET_MGMT
Terminal VM233: radtest testuser (password + OTP liền nhau) kết thúc bằng dòng Received Access-Accept Id 0 from 127.0.0.1:1812.
Terminal VM233: radtest testuser (password + OTP liền nhau) kết thúc bằng dòng Received Access-Accept Id 0 from 127.0.0.1:1812.

FreeRADIUS 3.2.10 siết kiểm tra Message-Authenticator (chống BlastRADIUS). Nếu freeradius -X báo bỏ gói của radtest hoặc của FortiGate vì thiếu Message-Authenticator, xem khối security trong /etc/freeradius/radiusd.conf và thuộc tính require_message_authenticator của từng client trong clients.conf (client fortigate ở Bước 4 đặt no). Chưa kiểm chứng radtest và FortiGate của lab có gửi thuộc tính này hay không, cần kiểm lại trên máy thật.

Kiểm tra log privacyIDEA:

tail -n 30 -f /var/log/privacyidea/privacyidea.log

Kiểm tra log FreeRADIUS (chạy debug mode):

# Dừng service, chạy debug
systemctl stop freeradius
freeradius -X 2>&1 | head -100
09

Cấu Hình DNS và Firewall

Thêm A record trong Pi-hole:

DomainIP
privacyidea.hoatranlabs.local10.11.25.30
mfa.hoatranlabs.local10.11.25.30
Pi-hole Admin → Settings → Local DNS Records (khung Local DNS records): privacyidea.hoatranlabs.local và mfa.hoatranlabs.local cùng trỏ tới 10.11.25.30.
Pi-hole Admin → Settings → Local DNS Records (khung Local DNS records): privacyidea.hoatranlabs.local và mfa.hoatranlabs.local cùng trỏ tới 10.11.25.30.

Quy tắc firewall (VLAN_SEC):

NguồnĐíchPortProtocolMục đích
10.100.100.1 (FortiGate)10.11.25.301812UDPRADIUS auth
10.11.45.35 (Prometheus)10.11.25.309100TCPMetrics scrape
Admin VLAN10.11.25.30443,80TCPWeb admin UI
Admin VLAN10.11.25.3022TCPSSH quản trị

Authentik không cần rule tới VM233: RADIUS Outpost của Authentik là server riêng (Bước 6), không gửi request tới privacyIDEA.

Mở port trên VM233 (mở SSH trước khi ufw enable, nếu không sẽ không SSH được vào VM233 nữa):

ufw allow from 10.11.45.0/24 to any port 22 proto tcp
ufw allow from 10.100.100.1 to any port 1812 proto udp
ufw allow from 10.11.45.35 to any port 9100 proto tcp
ufw allow from 10.11.45.0/24 to any port 443 proto tcp
ufw allow from 10.11.45.0/24 to any port 80 proto tcp
ufw enable
10

Cấu Hình Backup PBS

Đăng nhập PVE → Datacenter → Backup → Add:

Node        : node1
Storage     : pbs-primary (pbs01, 10.11.45.17)
Schedule    : daily 02:30
VMs         : 233
Mode        : Snapshot
Retention   : mặc định (retention do Prune Job trên PBS quản lý, bài 04 mục 7)
Proxmox Datacenter → Backup → Add: Node node1, Storage pbs-primary, daily 02:30, VM 233, Mode Snapshot, keep-daily=7, keep-weekly=4.
Proxmox Datacenter → Backup → Add: Node node1, Storage pbs-primary, daily 02:30, VM 233, Mode Snapshot, keep-daily=7, keep-weekly=4.

Backup thêm cấu hình và database của privacyIDEA bằng pi-manage backup create (theo tài liệu pi-manage: lệnh dump database MySQL cùng thư mục /etc/privacyidea; thêm -e để kèm khóa enckey):

# Thêm vào crontab để backup ra ngoài
cat > /etc/cron.daily/backup-privacyidea << 'EOF'
#!/bin/bash
PATH=$PATH:/opt/privacyidea/bin
pi-manage backup create -e
find /var/lib/privacyidea/backup -name "privacyidea-backup-*.tgz" -mtime +14 -delete
EOF
chmod +x /etc/cron.daily/backup-privacyidea

File backup nằm ở /var/lib/privacyidea/backup/privacyidea-backup-<ngày-giờ>.tgz (chỉ chủ sở hữu đọc được). Vì file chứa cả dump database lẫn enckey nên toàn bộ seed của token đọc được từ đó; coi nó như dữ liệu bí mật.

Xử Lý Sự Cố (Troubleshooting)

privacyIDEA không khởi động:

systemctl status apache2 mysql
tail -n 50 /var/log/privacyidea/privacyidea.log
tail -n 50 /var/log/apache2/error.log
# Kiểm tra file cấu hình và khóa (pi.cfg, enckey, khóa audit)
ls -la /etc/privacyidea/

RADIUS authentication thất bại:

# Debug FreeRADIUS
systemctl stop freeradius
freeradius -X 2>&1 | grep -E "(Accept|Reject|Error)"

# Kiểm tra privacyIDEA nhận request (access log của Apache và log ứng dụng)
grep -h "validate/radiuscheck" /var/log/apache2/*access*.log | tail -20
tail -n 20 /var/log/privacyidea/privacyidea.log

Token OTP không đồng bộ thời gian:

# Kiểm tra đồng bộ giờ trên VM233 (chrony đã cài ở Bước 2)
timedatectl status
chronyc tracking

# Nếu lệch > 30 giây thì TOTP sẽ fail: ép chrony chỉnh giờ ngay
chronyc makestep

FortiGate không kết nối RADIUS:

# Kiểm tra từ FortiGate
diagnose test authserver radius privacyidea-radius pap testuser "password+OTP"

# Kiểm tra UDP port 1812 từ FortiGate perspective
diagnose sniffer packet any "host 10.11.25.30 and port 1812" 4

Checklist Hoàn Thành

  • VM233 tạo thành công (Ubuntu Server 24.04 LTS; hoặc CT233 nếu chọn LXC ở Bước 1, Cách 3), IP 10.11.25.30/24, VLAN_SEC tag=25
  • privacyIDEA Web UI truy cập được tại https://10.11.25.30
  • FreeRADIUS chạy trên port 1812 UDP, freeradius -v là 3.2.10 (từ kho InkBridge, không phải 3.2.5 của Ubuntu)
  • RADIUS client FortiGate thêm vào clients.conf
  • radtest thành công từ VM233
  • FortiGate admin login yêu cầu MFA RADIUS
  • (Tùy chọn, độc lập với privacyIDEA) Authentik RADIUS Outpost chạy trên VM234 và thiết bị RADIUS client xác thực được
  • Ít nhất 1 user có TOTP token enrolled
  • DNS: privacyidea.hoatranlabs.local, mfa.hoatranlabs.local trỏ đúng IP
  • node_exporter chạy trên VM233, Prometheus scrape được
  • Backup PBS định kỳ cho VM233
  • Backup DB privacyIDEA qua cron daily
  • Firewall cho phép RADIUS UDP 1812 từ FortiGate tới VM233
Zalo