Triển khai privacyIDEA + MFA
Xác thực đa yếu tố — bảo vệ tài khoản với OTP, FIDO2.
Bối cảnh & Lý do triển khai
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ục | Nội dung |
|---|---|
| Ứng dụng trong DN | Bảo vệ VPN login, admin panel, RADIUS authentication cho FortiGate/Wi-Fi 802.1X |
| Tác dụng chính | TOTP (Google Authenticator), HOTP, hardware token (YubiKey); tích hợp FreeRADIUS cho VPN |
| Nếu không triển khai | Toà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 đây | FortiGate (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ủ | IP | VLAN · Node | Vai trò trong bài này |
|---|---|---|---|
| privacyidea (privacyIDEA MFA) · VM233 | 10.11.25.30 | 25 (SEC) · node1 | Má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.210 | 45 (MGMT) · cluster HOATRANHUB | Node 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.1 | Quản trị 10.100.100.0/24 · thiết bị mạng | RADIUS 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) · VM247 | 10.11.45.53 | 45 (MGMT) · node3 | DNS của VM233; thêm bản ghi A privacyidea và mfa (bài 12) trỏ về máy chủ privacyIDEA. |
| authentik (Authentik SSO) · VM234 | 10.11.25.40 | 25 (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) · VM235 | 10.11.45.35 | 45 (MGMT) · node2 | Scrape 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) · VM101 | 10.11.45.17 | 45 (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ần | VMID | IP | Trạng thái cần có |
|---|---|---|---|
| PVE node1 | — | 10.11.45.210 | Running |
| FortiGate | — | 10.100.100.1 | Running |
| Pi-hole DNS | VM247 | 10.11.45.53 | Running |
| Authentik SSO | VM234 | 10.11.25.40 | Khô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) | VM235 | 10.11.45.35 | Running |
| PBS Backup (pbs01) | VM101 | 10.11.45.17 | Running |
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 án | Trạng thái trong bài | Phù hợp khi | Lý do và nguồn |
|---|---|---|---|
| VM Ubuntu 24.04 + gói NetKnights (apt), Bước 1 Cách 1–2 và Bước 3 | Chọn, là cách mặc định của bài | Cầ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 VM233 | Mụ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 3 | Phương án thay thế, nhẹ hơn VM | Muốn tiết kiệm RAM và đĩa, không cần live-migrate | Cù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õi | Khi hãng công bố image và cấu trúc compose ổn định | Xem bốn lý do ngay dưới bảng |
Image Docker cộng đồng (khalibre/privacyidea, kheeklab/privacyidea, esutwo/privacyidea...) | Không dùng | Chỉ để thử nghiệm | Khô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
privacyideatrê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); repoprivacyidea/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ùngbuild:từ mã nguồn; README mục TODO ghi "Publish an image sobuild:can be replaced withimage:" 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 ở tagv3.14, build Angular bằng npm cùng Python, trên nềncgr.dev/chainguard/wolfi-basekhô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ênexample.envthànhprivacyidea.envvà 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.14dùngmariadb: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ứcfreeradius/freeradius-server:3.2.10, cấu hình ở/etc/raddb; việc image có sẵnrlm_restcầ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ần | Phiên bản | Ghi chú |
|---|---|---|
| Ubuntu Server | 24.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 |
| privacyIDEA | 3.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_wsgi | 2.4.58 (kho Ubuntu noble) | Do gói privacyidea-apache2 kéo về |
| MySQL | 8.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 |
| FreeRADIUS | 3.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.10 | Cùng kho InkBridge; privacyIDEA gọi endpoint /validate/radiuscheck |
| chrony | 4.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.zst | Template 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_exporter | 1.12.1 | Cài bằng script ở bài 15 |
Tạo VM233
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)
- VM ID:
233 - Name:
privacyidea - 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 - Disk size:
30 GiB, Cache:Write back, Discard: ☑
- Sockets:
1, Cores:2, Type:x86-64-v2-AES
- Memory (MiB):
4096
- Bridge:
vmbr0, VLAN Tag:25, Model:VirtIO (paravirtualized), Firewall: ☐
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 nonebên dưới chỉ dành cho VM. - Ở Bước 2 bỏ gói
chronykhỏi danh sáchapt 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ệnhchronycchạy trên node1 thay vì trong container. - Backup: job
daily 02:30ở Bước 10 chọn ID233như VM, vzdump sao lưu container vào cùng storagepbs-primary(chế độ Snapshot, cần kiểm lại trên máy thật với rootfs trênvm-ceph).pi-manage backup create -etrong container vẫn chạy như bình thường. -
ufwtrong 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
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.
Triển Khai privacyIDEA bằng Gói Ubuntu
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.cfgvớiPI_PEPPERvàSECRET_KEYngẫu nhiên. - Tạo database MySQL
pivới userpi(mật khẩu ngẫu nhiên, ghi trongpi.cfg) và các bảng. - Sinh khóa mã hóa token
/etc/privacyidea/enckeyvà 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)
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
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
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").
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ống | Vai trò RADIUS | Dù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):
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)RADIUS, Name radius-outpost, Integration Local Docker Integration (outpost chạy trên chính VM234), chọn Application vừa tạo
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.
Đăng Nhập và Tạo Token MFA
Truy cập privacyIDEA admin: https://10.11.25.30
Login: admin / Admin@privacyIDEA2024
/auth, /token/init, /validate/radiuscheck), nhưng chưa chạy thử.
Tạo Realm:
hoatranlabs- Type: Passwdresolver (cho local users) hoặc LDAP (nếu có AD)
Enroll TOTP token cho user:
admin (realm: hoatranlabs)
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"
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
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
Cấu Hình DNS và Firewall
Thêm A record trong Pi-hole:
| Domain | IP |
|---|---|
| privacyidea.hoatranlabs.local | 10.11.25.30 |
| mfa.hoatranlabs.local | 10.11.25.30 |
Quy tắc firewall (VLAN_SEC):
| Nguồn | Đích | Port | Protocol | Mục đích |
|---|---|---|---|---|
| 10.100.100.1 (FortiGate) | 10.11.25.30 | 1812 | UDP | RADIUS auth |
| 10.11.45.35 (Prometheus) | 10.11.25.30 | 9100 | TCP | Metrics scrape |
| Admin VLAN | 10.11.25.30 | 443,80 | TCP | Web admin UI |
| Admin VLAN | 10.11.25.30 | 22 | TCP | SSH 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
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)
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 -vlà 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