PacketFence 集成测试:基于 virtualswitch 与全局配置的端到端测试套件实战指南
PacketFence 集成测试:基于 virtualswitch 与全局配置的端到端测试套件实战指南
导读
t/venom/test_suites/global_config_virtualswitch/TESTSUITE.md 是 PacketFence 开源 NAC(网络准入控制)项目在 t/venom 集成测试体系中的环境准备(Setup)与清理(Teardown)基准套件。它负责在测试集群中搭建一整套"virtualswitch 虚拟交换机 + PacketFence 交换机/角色/VLAN 映射 + 注册接口与路由网络"的最小可复现 NAC 环境,供后续 wired_mac_auth_virtualswitch、device_profiling_virtualswitch、dot1x_wired_computer_auth_virtualswitch 等功能测试套件复用。读完本文,你将掌握:virtualswitch 包在独立网络命名空间中的部署与配置方式、通过 PacketFence REST API(api/v1/config/...)创建角色/交换机/路由网络的完整请求体、以及逆向清理(Teardown)时必须遵守的依赖顺序(先删网络再删交换机、先 configreload hard 再删角色)等技术要点。
套件定位:测试环境的"地基"而非测试本身
从命名与目录结构可以判断,本套件只做全局配置的 Setup/Teardown,不包含任何断言业务行为的测试用例。它是一系列功能测试套件(wired MAC auth、wireless MAC auth、device profiling、802.1X 等)的共同前置条件——例如 wired_mac_auth_virtualswitch/30_configreload_hard.yml 就注明"Reload pf config so the vlan_filters validator sees the printer role created in global_config_virtualswitch",直接依赖本套件创建的角色。
套件目录共 25 个 YAML 用例文件,按编号分段组织(00/05/10/15 为 virtualswitch 基础设施,20/22/25 为角色与过滤器,30/35 为交换机配置,40/42/44/45/46 为接口与网络配置),Teardown 则严格逆序执行。所有可变参数(IP、VLAN、角色 ID、租期等)都集中定义在 t/venom/vars/all.yml 的 virtualswitch.* 变量块中,测试文件通过 {{.virtualswitch.xxx}} 模板变量引用,便于按测试环境统一调整。
Setup 阶段一:virtualswitch 基础设施(0x 段)
1. 安装 virtualswitch 包(00_install_virtualswitch.yml)
00_install_virtualswitch.yml 调用自定义执行器 virtualswitch_install,传入 package_name: virtualswitch 及 deb/rpm 版本号。底层实现位于 t/venom/lib/virtualswitch/virtualswitch_install.yml,其要点包括:
- 通过 GitLab CI 环境变量
CI_VIRTUALSWITCH_USER/CI_VIRTUALSWITCH_PASSWORD做包仓库认证,缺省下载基址为https://support.inverse.ca/~jgoimard/virtualswitch; - 依据
/etc/os-release的ID_LIKE自动判别发行版:Red Hat 系(rhel/fedora/centos/rocky/alma)下载virtualswitch-${RPM_VERSION}.x86_64.rpm并用 dnf/yum 安装;Debian/Ubuntu 系下载virtualswitch_${DEB_VERSION}_amd64.deb并用 dpkg 安装(失败时执行apt-get install -f -y修复依赖); - 两种平台都先安装
wpa_supplicant依赖; - 安装后通过
which virtualswitch || rpm -q virtualswitch || dpkg -l virtualswitch验证二进制存在。
2. 停用标准服务,避免端口冲突
05_disable_standard_virtualswitch.yml 执行 systemctl stop virtualswitch || true 与 systemctl disable virtualswitch || true。这是因为本套件随后会以独立网络命名空间方式启动 virtualswitch,必须先停掉随包安装的标准 systemd 服务,防止其抢占同一批接口或 RADIUS 端口。
3. 生成 config.yaml(10_configure_virtualswitch.yml)
10_configure_virtualswitch.yml 调用 virtualswitch_config_deploy 执行器,将配置写入 /etc/virtualswitch/config.yaml,核心参数如下:
| 参数 | 值 | 含义 |
|---|---|---|
config_dir |
/etc/virtualswitch |
配置文件目录 |
switch_type |
cisco |
模拟的交换机厂商/型号 |
network_mapping |
10.0.0.0 |
虚拟网络网段映射 |
interfaces |
7 |
接口总数(由 vars 中的 virtualswitch.interfaces 注入) |
interface_types |
id 1-6 为 ethernet,id 7 为 wifi |
每接口类型 |
vlans |
[{id: 99, interfaces: [1..7]}] |
VLAN 99 为 native/管理 VLAN,挂载全部接口 |
radius.ip/port/secret |
注册接口 IP / 1812 / testing123 |
RADIUS 服务器地址与共享密钥 |
accounting_interval |
60 |
计账报文发送间隔(秒) |
reauth_interval |
0 |
0 表示不主动重认证 |
auth_retry_interval |
30 |
认证失败重试间隔(秒) |
底层模板在 t/venom/lib/virtualswitch/virtualswitch_config_deploy.yml 中,除上述字段外还预留了 dhcp(enabled/server_ip)、ipfix(enabled/destination_ip/destination_port/export_interval)、scep(enabled/server_url/shared_secret)、wireless(ssid/switch_mac)、device_state(auto_save/file_path)等可选段,实际配置可根据测试需求开启。生成后执行 test -f /etc/virtualswitch/config.yaml 断言配置文件已落地。
4. 在网络命名空间启动(15_start_virtualswitch_namespace.yml)
15_start_virtualswitch_namespace.yml 依次执行:
systemctl enable virtualswitch-namespace;- 通过
virtualswitch_service执行器systemctl start virtualswitch-namespace(封装见 t/venom/lib/virtualswitch/virtualswitch_service.yml); sleep 5等待服务就绪;- 用
virtualswitch_service_status断言服务状态为active; - 用
virtualswitch_api_status轮询 API(http://10.255.255.2:8080,retry: 3, delay: 2)直到返回 HTTP 200。
根据 t/venom/vars/all.yml 的注释,virtualswitch-namespace 服务会创建:vswitchbr 网桥、veth-host、veth-ns 一对 veth,并在命名空间内分配 10.255.255.2/30,命名空间内同时运行 virtualswitch API(8080 端口)——因此后续 RADIUS 请求的源 IP 是 10.255.255.2,与 PacketFence 管理网段天然隔离。
Setup 阶段二:角色、VLAN 过滤器与设备画像角色(2x 段)
5-6. 创建 headless_device 与 printer 角色
20_create_headless_device_role.yml 与 22_create_printer_role.yml 均通过 pf_api_action 执行器向 config/roles 发 POST(期望 201),请求体仅含 id、max_nodes_per_pid: 0(不限制单用户终端数)、notes。角色 ID 与 VLAN 映射来自 vars:
| 角色 | id | VLAN |
|---|---|---|
| guest | guest |
1 |
| registration | 复用 roles.registration.vlan_id |
2 |
| printer | printer |
2 |
| windows | windows |
3 |
| user / headless_device | user / headless_device |
4 |
| ios | ios |
4 |
| android | android |
5 |
| isolation | isolation |
6 |
(对应 vars 定义见 t/venom/vars/all.yml 与 t/venom/vars/all.yml。)
7. 创建 printer VLAN 过滤器(默认禁用)
TESTSUITE.md 提到"Create printer VLAN filter (disabled by default)",其完整实现位于依赖本套件的 wired_mac_auth_virtualswitch/31_create_vlan_filter_printer.yml:向 config/filter_engines/vlan_filters 发 POST,status: disabled、run_actions: enabled、scopes: ["RegisteredRole"],条件为 node_info.device_class 等于 Printers 或 Printers/Scanners 时把节点角色改为 printer。先以 disabled 状态创建是因为该过滤器依赖本套件创建的 printer 角色,只有角色就绪(并在 wired_mac_auth 套件中 configreload 后)才能启用,避免校验器在创建时报"角色不存在"。
8. 创建设备画像角色(windows/ios/android)
25_create_device_profiling_roles.yml 连续三次 POST config/roles 创建 windows、ios、android 三个角色。它们是后续 device_profiling_virtualswitch 套件测试 Fingerbank 设备画像自动归类(Windows OS / Apple iPod, iPhone or iPad / Android OS,见 t/venom/vars/all.yml)的目标角色,其 VLAN 分别对应 3/4/5。
Setup 阶段三:PacketFence 交换机配置(3x 段)
9. 创建交换机组(含角色→VLAN 映射)
30_create_switch_group.yml 向 config/switch_groups 发 POST,请求体将 TESTSUITE.md 中的 VLAN 映射表(guest=1、registration=2、printer=2、windows=3、headless_device=4、user=4、ios=4、android=5、isolation=6)落实为动态键 {角色名}Vlan:
{
"id": "{{.virtualswitch_switch_group.id}}",
"description": "{{.virtualswitch_switch_group.description}}",
"radiusSecret": "{{.virtualswitch_switch_group.radiusSecret}}",
"type": "{{.virtualswitch_switch.type}}",
"mode": "production",
"useCoA": "Y",
"VoIPCDPDetect": "N",
"VoIPLLDPDetect": "N",
"registrationVlan": "{{.roles.registration.vlan_id}}",
"guestVlan": "1",
"userVlan": "4",
"headless_deviceVlan": "4",
"printerVlan": "2",
"isolationVlan": "6",
"windowsVlan": "3",
"iosVlan": "4",
"androidVlan": "5"
}
vars 中对应的组定义为 virtualswitch_switch_group.id: virtualswitch_group、radiusSecret 复用 virtualswitch.radius.secret(t/venom/vars/all.yml)。注意 mode: production 表示交换机处于生产模式(而非测试/模拟模式),useCoA: Y 开启 Change-of-Authorization 能力,使 PacketFence 能在认证后动态下发 VLAN 变更。
10. 创建交换机
35_create_switch.yml 向 config/switches 发 POST 创建交换机实例:
{
"id": "{{.virtualswitch_switch.id}}",
"group": "{{.virtualswitch_switch_group.id}}",
"description": "{{.virtualswitch_switch.description}}"
}
依据 t/venom/vars/all.yml,交换机 id 即命名空间 IP 10.255.255.2,type 为 Cisco::Cisco_IOS_15_5。也就是说,测试中以 Cisco IOS 15.5 型交换机身份出现的,就是命名空间内的 virtualswitch,其 RADIUS 请求源地址正是该 IP——这解释了为什么交换机 ID 要取 namespace IP。
Setup 阶段四:接口、路由网络与服务重启(4x 段)
11. 将 vswitchbr 配置为注册接口
40_configure_registration_interface.yml 先轮询等待 ip link show vswitchbr 出现(30 次、每次 1 秒),然后 PATCH config/interface/vswitchbr:
{
"id": "vswitchbr",
"type": "vlan-registration",
"ipaddress": "10.255.255.1",
"netmask": "255.255.255.252",
"dhcpd_enabled": "enabled",
"nat_enabled": "disabled",
"high_availability": 0,
"additional_listening_daemons": ["radius", "dhcp"]
}
其中 type: vlan-registration 声明这是负责注册流程的 VLAN 接口,additional_listening_daemons 让 PacketFence 在 10.255.255.1 上同时监听 RADIUS(1812/1813)与 DHCP 报文;nat_enabled: disabled、high_availability: 0 明确该环境不做 NAT 与 HA。这些值来自 vars(t/venom/vars/all.yml)。
12. 为 VLAN 1-6 创建路由网络
42_create_routed_networks.yml 对 guest/registration/windows/user/android/isolation 六个 VLAN 逐一 POST config/routed_networks,每个网络结构一致(以 guest 为例):
{
"id": "10.0.1.0",
"type": "vlan-registration",
"netmask": "255.255.255.0",
"gateway": "10.0.1.1",
"next_hop": "10.255.255.2",
"dhcp_start": "10.0.1.10",
"dhcp_end": "10.0.1.14",
"dhcp_default_lease_time": "3600",
"dhcp_max_lease_time": "7200",
"dns": "8.8.8.8,{{.pfserver_mgmt_ip}}",
"pool_backend": "memory",
"coa": "enabled"
}
要点解析:
- 六个网络的完整地址池在 t/venom/vars/all.yml 中定义,例如 registration(VLAN 2)使用短租期(default 300s / max 600s),加速未注册节点在注册流程中的租约周转;其余网络默认 3600/7200;
next_hop: 10.255.255.2即命名空间 IP,L3 路由与 DHCP 均由命名空间内的 virtualswitch 承担,这也印证了 TESTSUITE.md 中"L3 DHCP via namespace"的表述;pool_backend: memory表示 DHCP 地址池由 PacketFence 内存态管理(配合coa: enabled支持动态 VLAN 变更)。
13. 开启 Rogue DHCP 检测并重启核心服务
44_enable_rogue_dhcp_detection.yml 调用封装好的 pf_api_enable_rogue_dhcp_detection(见 t/venom/lib/pf_api_enable_rogue_dhcp_detection.yml),在注册接口上开启非法 DHCP 检测能力。
随后 45_restart_services.yml 通过 pf_api_service_restart 依次重启 radiusd-auth、pfdhcp、pfdhcplistener 三个服务(每次重启后 sleep 5),使新接口与网络配置生效:
radiusd-auth:FreeRADIUS 认证实例,处理 virtualswitch 转发来的 Access-Request;pfdhcp:PacketFence 的 DHCP 服务,配合注册接口下发租约;pfdhcplistener:DHCP 监听器,用于指纹采集与 Rogue DHCP 检测。
14. 启用本地认证与 NTLM 密码哈希
46_enable_local_auth.yml 通过 pf_api_config_action(封装见 t/venom/lib/pf_api_config_action.yml)修改两处全局配置:
PATCH base/radius_configuration,{"local_auth": "enabled"}:启用 RADIUS 本地认证源,使testuser等本地账号可完成 802.1X/EAP 认证;PATCH base/advanced,{"hash_passwords": "ntlm"}:将密码哈希算法切换为 NTLM——这是 EAP-PEAP/MSCHAPv2 认证所必需的(MSCHAPv2 挑战应答依赖 NTLM 哈希)。
配置完成后异步重启 api-frontend(让新配置生效)并重启 radiusd-auth。这两项正是后续 dot1x_wired_computer_auth_virtualswitch 套件用 testuser/testpassword 做 EAP-PEAP 认证的前置条件(账号定义见 t/venom/vars/all.yml)。
Teardown 逆向清理:依赖顺序是核心
TESTSUITE.md 的 Teardown 严格按 Setup 的逆序执行,任何一步跳序都会因外键依赖(如交换机仍引用组、过滤器仍引用角色)而失败。各步骤对应 YAML 如下:
0x 段——接口与网络(先删网络,再摘接口)
- 删除六个路由网络:teardown/00_delete_routed_networks.yml 依次
DELETE config/routed_network/10.0.X.0(期望 200); - 摘除注册接口:teardown/01_deconfigure_registration_interface.yml
PATCH config/interface/vswitchbr,将type改回none,让 vswitchbr 不再承担注册职责。
0x 段——交换机(先删交换机,再删组)
3. 删除交换机:teardown/02_delete_switch.yml DELETE config/switch/10.255.255.2;
4. 删除交换机组:teardown/04_delete_switch_group.yml DELETE config/switch_group/virtualswitch_group。注意组删除必须放在交换机之后,否则组仍被交换机引用。
0x 段——过滤器与角色(先 configreload hard,再删角色)
5-6. 禁用并删除 VLAN 过滤器:先 PATCH config/filter_engines/vlan_filter/autoassign_printer_role 置 status: disabled(实现见 wired_mac_auth_virtualswitch/teardown/15_disable_vlan_filter_printer.yml),再删除该过滤器;
7. 先执行 configreload hard:teardown/07_run_configreload_hard.yml 运行 pfcmd configreload hard。其语义在源码 lib/pf/cmd/pf/configreload.pm 中有明确注释:soft 只重载变更过的配置文件,hard 强制重载全部配置文件(默认 soft)。这里必须先 hard reload,让 PacketFence 各守护进程与校验器"忘记"即将被删除的角色,避免后续删除角色时校验失败;
8-10. 依次删除 headless_device(teardown/08_delete_headless_device_role.yml)、printer(teardown/10_delete_printer_role.yml)以及 windows/ios/android 三个画像角色(teardown/11_delete_device_profiling_roles.yml),均使用 DELETE config/role/{id}。
1x 段——virtualswitch 基础设施(最后清理)
11. 停止并禁用命名空间服务:teardown/12_stop_virtualswitch.yml 依次 systemctl stop/disable virtualswitch-namespace(经由 virtualswitch_service 封装),vswitchbr 随之消失;
12. 删除配置文件:teardown/14_remove_virtualswitch_config.yml 执行 rm -f /etc/virtualswitch/config.yaml,确保下次运行从干净状态开始;
13. 还原全局认证配置:teardown/16_disable_local_auth.yml 将 local_auth 置回 disabled、hash_passwords 恢复为 bcrypt,并重启 api-frontend 与 radiusd-auth,完整还原 Setup 第 14 步所做的修改。
从测试套件到真实环境的迁移要点
- REST API 是配置的唯一入口:本套件所有 PacketFence 配置(角色、交换机、网络、过滤器、全局项)均通过
{{.pfserver_webadmin_url}}/api/v1/...完成,pf_api_action封装(t/venom/lib/pf_api_action.yml)先获取登录令牌,再携带Authorization头与Content-Type: application/json发起请求,并断言状态码与响应体类型。这套 API 路径同样适用于手工运维与自动化编排。 - 命名空间隔离是双刃剑:virtualswitch 跑在独立 netns 中避免了与 PacketFence 管理面冲突(API 8080、RADIUS 源 IP 10.255.255.2 均与管理面隔离),但依赖
virtualswitch-namespacesystemd 服务自动创建网桥与 veth 对,因此必须先停用标准virtualswitch服务。 - VLAN 映射是角色的外键:交换机组的
{role}Vlan字段、路由网络的next_hop、过滤器的role字段互相引用,任何一侧缺失都会让认证流程无法把节点送入预期 VLAN——这正是 Teardown 必须"先 reload、后删角色"的原因。 - 可变性参数集中管理:IP 段、租期、MAC、角色 ID 全部集中在 t/venom/vars/all.yml,将本套件移植到其他环境时,只需调整
virtualswitch.*变量块即可,无需改动任何 YAML 用例。
总结
global_config_virtualswitch 套件是 PacketFence venom 集成测试体系中承上启下的"全局配置地基":它以 14 个 Setup 步骤搭建出"virtualswitch(Cisco IOS 15.5 模拟,netns 内运行)+ PacketFence(角色/交换机/路由网络/RADIUS 本地认证)"的完整 NAC 最小环境,再以 13 个逆序 Teardown 步骤彻底还原。理解其 YAML 用例、vars 变量与 pfcmd configreload hard 的语义,不仅能让你读懂 PacketFence 的集成测试体系,也能为在真实网络中编排交换机、VLAN 与认证策略提供可直接对照的 API 级参考。