全屋共用一个密码
WiFi 密码由每一个曾经连上来的东西共享。笔记本、手机、电视、装上之后固件就再没人更新过的门铃摄像头、圣诞节时拿到密码的客人,以及那位客人此后用过的每一部手机。它们全都在同一个网络上。每一个都能和其他每一个说话。
按通常的办法把它拆开,意味着更多的 SSID。员工一个,IoT 一个,访客一个,各有各的密码和各自的 VLAN。能用。然后某个密码泄露了,你就得拿着新密码挨个去改那个 SSID 上的每一台设备,而这恰恰是永远没人去干的活儿。
空着的有线端口更糟。连密码都没有。插上就进了那个端口被设成的 VLAN。
带证书的 802.1X 把这一切倒了过来。每台设备带着自己的证书,在任何一个数据包通过之前先证明自己是什么,然后由网络来决定它去哪里,不是设备,也不是那个发密码的人。一个 SSID。每个交换机端口都一样。笔记本落在员工 VLAN,摄像头落在 IoT VLAN,而你从没签发过证书的设备哪儿也去不了。
| 一个共享密码 | 每个 VLAN 一个 SSID | 802.1X,一个 SSID | |
|---|---|---|---|
| 谁能进来 | 任何知道密码的人 | 任何知道那个 SSID 密码的人 | 只有持有你签发的证书的设备 |
| 进哪个 VLAN | 全在一个里 | 取决于连的是哪个 SSID | RADIUS 服务器给那台设备说的那个 |
| 拦住一台丢失的设备 | 到处改密码 | 到处改那个 SSID 的密码 | 吊销一张证书 |
| 有线端口 | 敞开 | 敞开 | 和 WiFi 一样的检查 |
| 要广播的 SSID | 1 | 每个 VLAN 一个 | 1 |
这就是本文要搭的东西。step-ca 签发证书并把每台设备的角色写进去,FreeRADIUS 对照 CA 及其吊销列表检查每张证书,从中读出角色并回答一个 VLAN,交换机或接入点再把设备放到它被告知的地方。设备用的是 Netgear 或 TP-Link,能用 TLS 的地方就通过 TLS 和 FreeRADIUS 通信。在碰任何真实设备之前,这一切都在这里跑过一遍:CA 和 RADIUS 服务器在容器里,交换机端口和 WiFi 网络在模拟器里。
四个部分,只有一个说了算
802.1X 定义了三个角色1。请求方(supplicant)是要求加入的设备。认证方(authenticator)是交换机端口或接入点。认证服务器就是 RADIUS。再加上签发证书的 CA,这就是整个系统。
交换机和 AP 什么都不决定。它们只转发。在设备通过认证之前,端口只放行 EAP,别的一概不放。认证方把 EAP 包进 RADIUS,发给服务器,然后照答复办事。Access-Accept 打开端口。如果 Accept 带着隧道属性,端口或 WiFi 客户端就进入它们指定的 VLAN。RFC 3580 规定了是哪三个属性,借用自 RADIUS 的隧道属性23:
| 属性 | 值 | 含义 |
|---|---|---|
Tunnel-Type | VLAN (13) | 这个隧道是一个 VLAN |
Tunnel-Medium-Type | IEEE-802 (6) | 在 802 网络上 |
Tunnel-Private-Group-Id | "10" | VLAN ID,以字符串发送 |
所以交换机的品牌没你想的那么重要。决定权在你自己运行的一台机器上。每个支持动态 VLAN 的厂商读的都是同样这三个属性。RFC 说得很明白,VLAN ID 是“encoded as a string”3,所以它带着引号。
为什么用证书,为什么只用 TLS 1.3
EAP 方法有好几种,实际在用的大多数都是包在 TLS 里的一个密码。对人来说这行得通。对摄像头毫无用处,因为没人在它跟前打字,而一千台摄像头共用一个密码,又回到了 WiFi 密码那一套。
| 方法 | 用什么证明设备 | 如果设备信任了错误的服务器 | 拦住一台设备 |
|---|---|---|---|
| EAP-TLS | 它自己的证书和私钥 | 服务器得到证书,而证书本来就是公开的 | 吊销证书 |
| PEAP 加 MS-CHAPv2 | 用户名和密码 | 服务器截获一次握手,可以破解回密码 | 改密码 |
| EAP-TTLS 加 PAP | 用户名和密码 | 服务器直接收到密码本身 | 改密码 |
中间那一列就是选 EAP-TLS 的原因。MS-CHAPv2 被攻破已经超过十年了。Microsoft 自己的公告说“an attacker who obtained the MS-CHAP v2 authentication traffic could then use the exploit code to decrypt a user’s credentials”4。把它包进 PEAP,只有在每台设备都检查自己在跟谁说话时才起保护作用,而正如设备那一节会展示的,很多设备并不检查。用 EAP-TLS,交换过程中没有任何可偷的秘密。私钥从不离开设备5。没什么可破解的。
TLS 1.2 把证书广播到空中
基于 TLS 1.2 的 EAP-TLS 有个很容易被忽略的缺陷。设备在加密开始之前就发出了自己的证书。明文发送。任何监听 WiFi 的人都能读到,而本文把设备的角色写进了证书,所以他们连角色也能读到。
这里实测过,方法是在设备发出的每一条 EAP 消息里搜索设备名和它的角色:
| 运行 | TLS | 设备名明文可见 | 角色 OU=staff 明文可见 |
|---|---|---|---|
身份 laptop1 | 1.2 | 是 | 是 |
身份 laptop1 | 1.3 | 是,在身份字段里 | 否 |
身份 anonymous | 1.3 | 否 | 否 |
TLS 1.3 解决了这个问题。RFC 9190 说,在 TLS 1.3 下“the use of privacy is mandatory and does not cause any additional round trips”6。外层身份仍然是明文,所以它也不该写设备名。RFC 建议用匿名身份6。这里哪儿都不需要真实身份,因为 FreeRADIUS 从证书里读出设备是谁。外层写 anonymous,最后一行就是窃听者能拿到的东西:啥也没有。
所以这套搭建只跑 TLS 1.3。FreeRADIUS 两头都钉死在它上面。不会说 TLS 1.3 的设备上不了网。这有代价,代价在设备那一节里算清楚了,没有藏起来。FreeRADIUS 自己的配置至今还在用大写字母告诉你把上限设成 1.2,因为“most EAP supplicants WILL NOT DO TLS 1.3 PROPERLY”7。该夸的要夸:那份配置是本文涉及的所有文档里最诚实的,下面几乎每一个陷阱,只要你读注释,都能在里面某处找到。在一个由你挑选设备的网络上,这正是挑更好设备的理由。
把角色写进证书
VLAN 由设备是什么来决定,而这件事写在证书里。step-ca 可以用模板把它写进去,和客户端证书那篇文章写 CRL 分发点用的是同一套机制。CA 本身怎么起,见 step-ca in a container,本文从那里接着往下,CA 的名字叫 Home Network CA。
每张设备证书的角色放在其主题的组织单位(OU)里。模板从请求中取出角色,不在名单上的一律拒绝8:
{{- $roles := list "staff" "iot" "media" }}
{{- if not (has .Insecure.User.role $roles) }}
{{- fail "role must be one of staff, iot or media" }}
{{- end }}
{
"subject": {
"commonName": {{ toJson .Subject.CommonName }},
"organizationalUnit": {{ toJson .Insecure.User.role }}
},
"sans": {{ toJson .SANs }},
"keyUsage": ["digitalSignature"],
"extKeyUsage": ["clientAuth"],
"crlDistributionPoints": ["http://ca.home.example/1.0/crl"]
}
给它一个专用的 provisioner,这样设备证书永远不会出自通用的 admin,它能签的最长证书是一年:
step ca provisioner add network --type JWK --create \
--x509-max-dur 8760h --x509-default-dur 24h \
--x509-template templates/device.tpl
--x509-template 是把模板复制进 ca.json,而不是指向那个文件,所以之后再改 device.tpl 什么都不会变,直到你再跑一次 step ca provisioner update network --x509-template templates/device.tpl。然后给每台设备签发带角色的证书:
step ca certificate laptop1 laptop1.crt laptop1.key \
--provisioner network --not-after 8760h --set role=staff
$ openssl x509 -in laptop1.crt -noout -subject -ext extendedKeyUsage
subject=OU=staff, CN=laptop1
X509v3 Extended Key Usage:
TLS Web Client Authentication
没有角色或者角色不认识,什么都拿不到:
$ step ca certificate norole norole.crt norole.key --provisioner network
The request could not be completed: role must be one of staff, iot or media.
.Insecure.User 之所以叫不安全,是因为它就是请求方发来的任何东西。在这里没问题。network provisioner 有密码,只有你持有,而任何能用它签名的人本来就能做出任何他想要的证书,所以他自己填进去的角色不会给他多出任何东西。
RADIUS 服务器也需要一张证书,好让设备能检查自己在跟谁说话。它和其他服务器证书一样出自 admin provisioner,寿命是默认的 24 小时,由 step ca renew --daemon 续期,就像 step-ca 那篇文章对任何不能用 ACME 的服务所做的那样。设备检查的是名字和 CA,不是序列号。每天续期一次对它们没有任何影响。
| 证书 | Provisioner | 有效期 | 扩展密钥用途 | 携带 |
|---|---|---|---|---|
radius.home.example | admin | 24 小时,每天续期 | 服务器和客户端 | 设备检查的那个名字 |
laptop1 | network | 1 年 | 仅客户端 | OU=staff |
cam1 | network | 1 年 | 仅客户端 | OU=iot |
tv1 | network | 1 年 | 仅客户端 | OU=media |
switch1、ap1 | nas | 1 年 | 仅客户端 | OU=nas,用于 RadSec;见下文 |
FreeRADIUS:决定 VLAN
FreeRADIUS 3.2.10,用的是该项目自己的容器镜像。三段配置干活:EAP 模块,一个挑选 VLAN 的策略,以及一份例外清单。
EAP 模块
只要 EAP-TLS,只要 TLS 1.3,每次登录都检查 CRL:
eap {
default_eap_type = tls
tls-config tls-common {
certificate_file = ${certdir}/eaptls/radius.crt
private_key_file = ${certdir}/eaptls/radius.key
ca_path = ${certdir}/eaptls/ca
ca_file = ${certdir}/eaptls/ca/root_ca.crt
check_crl = yes
ca_path_reload_interval = 300
tls_min_version = "1.3"
tls_max_version = "1.3"
}
tls {
tls = tls-common
}
}
| 文件 | 内容 |
|---|---|
radius.crt | 服务器证书,后接 step-ca 的中间证书,就是 step ca certificate 写出来的样子 |
radius.key | 它的私钥;和这里的所有东西一样,必须让 freerad 用户可读,否则 FreeRADIUS 起不来 |
ca/ | 根证书、中间证书和中间证书的 CRL,用 openssl rehash ca/ 做过哈希 |
中间那一行让这里第一次启动失败了,不过不是因为密钥:根证书报 Permission denied,因为从 CA 拿出来的每个文件都只有属主可读。FreeRADIUS 以 freerad 身份运行,所以这三样都必须让它可读。
check_crl = yes 用中间证书的 CRL 检查设备证书。它不检查中间证书本身,所以不像客户端证书那篇文章里的 nginx,FreeRADIUS 不需要根 CRL。想要的话,check_all_crl 可以打开它7。ca_path_reload_interval 比看上去重要得多,下面单独有一节讲它。
策略
这个 CA 签过的每一张证书都能通过 TLS 检查。包括那些通过 ACME 拿到证书的 Web 服务器。所以策略把不是为这件事做的证书统统扔出去:没有客户端认证用途,或者没有角色,就拒绝。
vlan_by_certificate {
if (&TLS-Client-Cert-X509v3-Extended-Key-Usage-OID !~ /1\.3\.6\.1\.5\.5\.7\.3\.2/) {
reject
}
device_vlan
if (!&reply:Tunnel-Private-Group-Id) {
if (&TLS-Client-Cert-Subject =~ /\/OU=([^\/]+)/) {
switch "%{1}" {
case "staff" {
update reply { &Tunnel-Private-Group-Id := "10" }
}
case "iot" {
update reply { &Tunnel-Private-Group-Id := "20" }
}
case "media" {
update reply { &Tunnel-Private-Group-Id := "30" }
}
case {
reject
}
}
}
else {
reject
}
}
update reply {
&Tunnel-Type := VLAN
&Tunnel-Medium-Type := IEEE-802
}
}
这段放进 policy.d/vlan,再把一行 vlan_by_certificate 放到 sites-available/default 里 post-auth 段的最上面。post-auth 是 TLS 握手结束后、证书细节可以拿到的地方9。
例外清单
大多数设备由角色决定。不是全部。这份清单是给少数不该由角色决定的设备用的:一台开始行为异常、在你查明原因之前想先隔离起来的摄像头,或者一台借出去一周的设备。它是一个 passwd 模块,读一个两列的文件,以证书的通用名(CN)为键:
passwd device_vlan {
filename = ${modconfdir}/device_vlan/devices
format = "*TLS-Client-Cert-Common-Name:=Tunnel-Private-Group-Id"
delimiter = ","
}
# certificate CN,VLAN
cam1,99
属性前面的 = 把它放进回复,而不是检查项10。挪动一台设备只是改文本文件里的一行,不用重签证书,也不用碰设备。
| VLAN | 角色 | 里面放什么 |
|---|---|---|
| 10 | staff | 你信任的笔记本和手机 |
| 20 | iot | 摄像头、传感器,任何会往外打电话回家的东西 |
| 30 | media | 电视和流媒体盒子 |
| 99 | 仅限清单 | 隔离区:最多给上互联网,本地一概不通 |
碰交换机之前先证明它能用
eapol_test 随 wpa_supplicant 一起提供,它同时扮演设备和交换机,直接和 RADIUS 服务器对话。先用它。以后有东西不工作时,你就知道该看哪一半。
network={
key_mgmt=WPA-EAP
eap=TLS
phase1="tls_disable_tlsv1_3=0"
identity="anonymous"
ca_cert="/etc/pki/home/root_ca.crt"
domain_match="radius.home.example"
client_cert="/etc/pki/home/laptop1.crt"
private_key="/etc/pki/home/laptop1.key"
}
eapol_test -c laptop1.conf -a 192.0.2.10 -s <shared secret>
答复,来自 FreeRADIUS 自己的调试日志:
(8) Sent Access-Accept
(8) Tunnel-Private-Group-Id = "10"
(8) Tunnel-Type = VLAN
(8) Tunnel-Medium-Type = IEEE-802
| 设备 | 证书里的角色 | 在清单上 | 答复 | VLAN |
|---|---|---|---|---|
laptop1 | staff | 否 | Accept | 10 |
cam1 | iot | 99 | Accept | 99 |
tv1 | media | 否 | Accept | 30 |
laptop2 | staff,已吊销 | 否 | Reject,certificate revoked | 无 |
radius.home.example | 无 | 否 | Reject,没有角色 | 无 |
laptop1,没打开 TLS 1.3 | staff | 否 | Reject,protocol version | 无 |
最后一行值得在上线之前知道。wpa_supplicant 2.11 发布时 EAP 的 TLS 1.3 仍是关闭的,描述为“experimental - disabled by default”11。漏掉 phase1 那一行,一台完全没问题的笔记本就会被拒之门外。
模拟一个交换机端口
eapol_test 跳过了交换机。要看交换机那一半,hostapd 有一个有线驱动,能把一个 Linux 接口变成 802.1X 端口。一根虚拟网线把它连到扮演笔记本的 wpa_supplicant,它指向同一个 FreeRADIUS。
interface=port1
driver=wired
ieee8021x=1
use_pae_group_addr=1
auth_server_addr=192.0.2.10
auth_server_port=1812
auth_server_shared_secret=<shared secret>
端口眼中的一台正常笔记本和一台已吊销的笔记本:
port1: CTRL-EVENT-EAP-SUCCESS2 4a:42:cf:cf:09:5a
port1: AP-STA-CONNECTED 4a:42:cf:cf:09:5a
port1: STA 4a:42:cf:cf:09:5a IEEE 802.1X: authorizing port
port1: CTRL-EVENT-EAP-FAILURE2 de:d8:8c:88:6e:f2
port1: IEEE 802.1X: Force disconnection of de:d8:8c:88:6e:f2 after EAP-Failure in 10 ms
打开它的动态 VLAN 处理,它会报告分到的 VLAN,笔记本是 vlan=10,被隔离的摄像头是 vlan=99,然后说它 could not add dynamic VLAN interface。这是一个 Linux 端口在说实话:它能开能关,但没法把自己挪到某个 VLAN 上。网管交换机在硬件里干这部分活,下面厂商的设置讲的就是这一半。
吊销:FreeRADIUS 收到 HUP 时无视的 CRL
丢了一台笔记本,正是这一切存在的理由。在 CA 上吊销它。admin provisioner 为那个序列号签一个吊销令牌,这不需要笔记本的私钥,因为你手里不会有那台笔记本:
SERIAL=$(step certificate inspect laptop2.crt --format json | jq -r .serial_number)
TOKEN=$(step ca token "$SERIAL" --revoke --provisioner admin)
step ca revoke "$SERIAL" --token "$TOKEN" --reason "laptop lost"
Certificate with Serial Number 306546036599704679037436836531698019860 has been revoked.
打开 generateOnRevoke 时,step-ca 会立即重建它的 CRL,设置方法见客户端证书那篇文章。把它复制进 FreeRADIUS 的 ca/ 目录,笔记本就出局了。可实际上并没有。它大摇大摆又连了回来。
| 新 CRL 落盘之后做了什么 | 已吊销的笔记本 |
|---|---|
| 什么都没做 | 照样连上 |
kill -HUP | 照样连上。日志说 HUP - No files changed. Ignoring |
等过了 ca_path_reload_interval | 被拒,certificate revoked |
| 重启 FreeRADIUS | 被拒,certificate revoked |
HUP 重新加载的是配置文件,而 ca_path 里的 CRL 不算配置文件,所以 FreeRADIUS 查了一遍它的配置文件列表,发现都没变,就继续用内存里的旧 CRL。真正能让它读到新 CRL 的是 ca_path_reload_interval。默认配置里它是关着的。把它设到 300 秒以下,FreeRADIUS 启动时会推翻你的设置:
ca_path_reload_interval is set too low, reset it to 300
那就 300。新 CRL 落盘后五分钟内吊销生效。用定时器去拉取它,就像客户端证书那篇文章已经为 nginx 做的那样,只是放到这个目录里。如果对你刚丢的那台设备来说五分钟太长,就重启 FreeRADIUS。
CRL 也能一下子把所有人都关在门外。所以两个方向都要看。下面两种情况都是用正常证书测出来的:
| CRL 状态 | FreeRADIUS 说什么 | 谁能连上 |
|---|---|---|
| 有效 | 什么都不说 | 每一台正常设备 |
ca/ 里没有 | error 3 : unable to get certificate CRL | 没人 |
| 过了下次更新时间 | error 12 : CRL has expired | 没人 |
step-ca 的 CRL 默认有效 24 小时。如果拉取它的定时器停了,网络上的每台设备第二天全部失败。allow_expired_crl 就是为了缓和这一点而存在的7。别用它。一个因为名单过期就放所有人进来的网络已经什么都不检查了,因此正确的修法是盯住定时器,而不是把检查关掉。
RADIUS 至今仍是 MD5 加一个共享密钥
到目前为止的一切保护的是设备和 FreeRADIUS 之间的对话。EAP-TLS 端到端运行,中间的交换机或 AP 读不到它。承载它的 RADIUS 数据包则是另一回事。
经典 RADIUS 是 UDP 加一个共享密钥,而这个密钥是通过 MD5 使用的。要是数据包里没装什么值钱的东西,这还没那么要紧,可 WiFi 客户端的 Access-Accept 里装着那个客户端流量的密钥。MS-MPPE-Recv-Key 和 MS-MPPE-Send-Key 是 AP 用来加密那个客户端流量的主密钥,而 RFC 2548 用 b(1) = MD5(S + R + A) 加一次 XOR 来保护它们,其中 S 就是共享密钥12。这里面没有前向保密。今天抓下 RADIUS 流量,明年从某个配置备份或某台交换机的运行配置里拿到密钥,抓到的每个密钥就都能解开,连同它们保护的 WiFi 流量。
所以问题不在于密钥够不够长。问题在于,无线网络的钥匙凭什么要在 MD5 的保护下走在线上。它们根本不必如此。
| 威胁 | 基于 UDP 的普通 RADIUS | 强制 Message-Authenticator | RadSec,TLS 1.3,双向证书 |
|---|---|---|---|
| 伪造 Access-Accept(BlastRADIUS) | 在不带 EAP 的请求上可行,MAB 也在其中 | 被挡住 | 被挡住 |
| 从抓包里读出 WiFi 密钥 | 任何一个曾经得知密钥的人 | 一样 | 需要 TLS 会话密钥,而它们从不落盘 |
| 管理网络上冒充交换机的一台机器 | 只需要密钥 | 一样 | 需要一张带 nas 角色的证书,且来自已知地址 |
| 谁能看到哪台设备登录了 | 路径上的任何人 | 一样 | 没人 |
BlastRADIUS,以及挡住它的那一行
BlastRADIUS,即 CVE-2024-3596,让处在交换机和服务器之间路径上的攻击者,通过攻击给响应签名的 MD5,把一个拒绝变成接受13。修复办法是在每个请求和每个响应上都带 Message-Authenticator 属性13。RFC 3579 一直要求所有承载 EAP 的报文都带它14,所以 EAP-TLS 从来不是软肋。MAB 才是,因为 MAC 地址检查不带 EAP,而很多交换机发它时就不带这个属性。
FreeRADIUS 3.2.10 开箱即强制要求它,radiusd.conf 里是 require_message_authenticator = yes。这里用一个手工构造的 MAB 请求测过:
| 请求 | 答复 |
|---|---|
没有 Message-Authenticator | 不回复。日志记为 Packet does not contain required Message-Authenticator attribute |
带 Message-Authenticator | 有答复,对未知 MAC 回 Access-Reject |
那个设置别动。配置里警告说,把它和 limit_proxy_state 都设成 no“will allow MITM attackers to create fake Access-Accept packets to the NAS”15。
这堵上了伪造。对密钥却毫无作用。
RadSec:装进 TLS 1.3 的 RADIUS
能用上的最高标准是 RadSec,也就是两端各有一张证书、承载在 TLS 上的 RADIUS16。交换机或 AP 用证书证明自己是谁,FreeRADIUS 用它自己的证书证明自己是谁,整段 RADIUS 对话,连同密钥,都放在带前向保密的 TLS 1.3 里。IETF 正在把它推上标准轨道;将要取代 2012 年那份实验性 RFC 的草案“Has enough positions to pass”17。
交换机和 AP 也和其他东西一样从 step-ca 拿证书,出自第三个 provisioner,它的模板只写 OU=nas,别的什么都不写。这意味着设备证书没法拿来冒充交换机,而交换机证书不带任何 VLAN 策略认得的角色,也没法拿来上网。
listen {
ipaddr = *
port = 2083
type = auth
proto = tcp
virtual_server = default
clients = radsec
tls {
certificate_file = ${certdir}/eaptls/radius.crt
private_key_file = ${certdir}/eaptls/radius.key
ca_path = ${certdir}/eaptls/ca
ca_file = ${certdir}/eaptls/ca/root_ca.crt
require_client_cert = yes
check_crl = yes
ca_path_reload_interval = 300
verify {
tmpdir = ${run_dir}
client = "${raddbdir}/nas-only.sh %{TLS-Client-Cert-Filename}"
}
tls_min_version = "1.3"
tls_max_version = "1.3"
}
}
clients radsec {
client switch1 {
ipaddr = 192.0.2.21
proto = tls
secret = radsec
}
}
#!/bin/sh
# Accept a RadSec client certificate only if step-ca issued it with the nas role.
openssl x509 -in "$1" -noout -subject -nameopt compat | grep -q '/OU=nas/'
密钥真的就是 radsec 这个词。说真的。在 TLS 上它什么作用都没有,FreeRADIUS 自己的示例就说“TLS clients MUST have the shared secret set to “radsec””18。有两件看起来顺理成章的事行不通,都是吃了亏才发现的。check_cert_cn = %{client:shortname} 在握手时展开为空,于是每台交换机都被拒绝,报 Certificate CN (switch1) does not match specified value ();所以才有那个 verify 脚本。还有,在 freeradius -X 下监听器起不来,因为它关掉了线程:Threading must be enabled for TLS sockets to function properly。改用 freeradius -fxx -l stdout 来调试。
前面那个模拟交换机端口,改成用 RadSec 重建,跑同样的测试:
| 交换机出示 | 来自 | 结果 |
|---|---|---|
switch1,OU=nas | 它登记的地址 | TLS 1.3 建立;laptop1 获准进入 VLAN 10,已吊销的 laptop2 被拒 |
laptop1 的证书 | 交换机的地址 | 在握手中被拒;verify 脚本返回 1 |
switch1,OU=nas | 一个未登记的地址 | Ignoring request … from unknown client |
哪些设备能做到
| 认证方 | RadSec | 备注 |
|---|---|---|
| hostapd 2.11 | 能,前提是编译时带上 | CONFIG_RADIUS_TLS=y 在它的 defconfig 里是注释掉的19。Alpine 的软件包没开它,会拒绝这份配置:unsupported RADIUS type 'TLS'。带上它编译后,一次就成 |
| TP-Link Omada AP 和交换机 | 从 Controller 6.1 起,需当前固件 | “Added support for RadSec (RADIUS over TLS) to secure SSID, MAC-Based, and 802.1X authentications on both APs and Switches”20 |
| TP-Link Omada RADIUS 代理 | 不能 | 控制器自带的代理“does not support the RadSec feature”21 |
| Netgear M4250 和 M4350 | 没有文档 | CLI 手册对 RadSec 只字未提,还给共享密钥设了上限:“The secret must be an alphanumeric value not exceeding 16 characters”22 |
| Netgear WAX 和 WBE AP | 没有文档 | 手册把 RADIUS 端口描述为 UDP,默认密钥是 sharedsecret23 |
我能问一句吗:一台在 2026 年作为全网管卖的交换机,为什么不能通过 TLS 和它的 RADIUS 服务器说话?我问的不是谁拍的板。我问的是流程里有什么东西让它就这么出了货,而 TP-Link 的控制器、hostapd 和一个免费的代理全都能做到。16 个随机字母数字字符大约是 95 位,被破解的不会是它。问题在于这是唯一提供的保护:没有 TLS 选项,一套 1999 年的 MD5 方案守着 WiFi 密钥,还有一台出厂就把密钥设成 sharedsecret 这个词的 AP。在 Netgear 的设备上,radsecproxy 不是可选项。
radsecproxy,给只会说 UDP 的设备
交换机或 AP 做不了 RadSec 的地方,就在它旁边放一个 radsecproxy。它接收 UDP RADIUS,发出 RadSec24,这样明文的那一跳只是交换机和代理之间几米长的管理 VLAN,而不是到服务器的整条路径:
ListenUDP *:1812
tls stepca {
CACertificateFile /etc/radsecproxy/root_ca.crt
CertificateFile /etc/radsecproxy/radsecproxy.crt
CertificateKeyFile /etc/radsecproxy/radsecproxy.key
TlsVersion TLS1_3
}
client switches {
host 192.0.2.32/27
type udp
secret <long random secret>
RequireMessageAuthenticator on
}
server freeradius {
host radius.home.example
port 2083
type tls
tls stepca
secret radsec
certificateNameCheck on
}
realm * {
server freeradius
}
用名字。别用地址。写成 host 10.89.0.100 时代理拒绝了服务器,拒得对:No subjectaltname matching address 10.89.0.100。用名字它就以 TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 建立起来,同样的设备经由它得到同样的答复:laptop1 进 VLAN 10,cam1 进 99,tv1 进 30,laptop2 被拒。一个不带 Message-Authenticator 的请求停在了代理那里:ignoring request from client switches … missing required message-authenticator。
让那一段 UDP 老老实实。要短,要圈起来。交换机的管理地址和代理放在一个任何客户端 VLAN 都路由不过去的管理 VLAN 上,并且防火墙也是这么规定的。
CRL 的拉取也一样
CRL 是签了名的,所以没人能伪造。但他们可以重放一份仍在有效期内的旧 CRL,从而藏起此后做出的一次吊销。要通过钉住 step-ca 自己根证书的 HTTPS 去拉取,而不是用普通 HTTP:
curl -fsS --cacert /etc/freeradius/certs/eaptls/ca/root_ca.crt --tlsv1.3 \
-o /tmp/crl.der https://ca.home.example:9000/1.0/crl
换成任何别的根证书,同样的命令都会以 curl 的退出码 60 失败,FreeRADIUS 则保留它手上的那份名单。
往哪里去
RFC 9765,即 RADIUS/1.1,在 RADIUS 跑在 TLS 上时把 MD5 彻底拿掉:“the RADIUS shared secret is no longer used, and all MD5-based packet authentication and attribute obfuscation methods are removed”25。它是实验性的。FreeRADIUS 3.2 把它放在一个编译选项 --with-radiusv11 后面,“for testing interoperability”26,而官方的 3.2.10 镜像没有带它编译;二进制里没有这个选项。带 TLS 1.3 的 RadSec 是你今天能部署的最高标准,RADIUS/1.1 是它的下一步。
交换机:Netgear 和 TP-Link
每台值得买的网管交换机都支持带动态 VLAN 的 802.1X,不管铭牌上写的是什么,设置归结起来都是同样五件事。这两家的区别在细节上,而 TP-Link 那边有一个细节会改变你给一张办公桌布线的方式。
| 设置 | Netgear M4250 和 M4350 | TP-Link Omada 交换机 |
|---|---|---|
| RADIUS 服务器 | Security > Management Security > RADIUS > Server Configuration27 | Omada 控制器里的一个 RADIUS Profile28 |
| 打开 802.1X | Security > Port Authentication > Basic > 802.1X Configuration:Dot1x Admin Mode、Authentication Admin Mode27 | Authentication > 802.1X,Authentication Type 选“Port Based”28 |
| 由 RADIUS 分配 VLAN | VLAN Assignment Mode,“The default is Disable”27 | “enable ‘VLAN Assignment’”28 |
| VLAN 不存在时 | 不会创建,除非打开 Dynamic VLAN Creation Mode,它默认也是关的27 | “the switch will create the related VLAN automatically”29 |
| 接入端口 | Control Mode 设为 Auto | 802.1X Control mode 设为 Auto28 |
| 上联口、RADIUS 服务器的端口、AP 端口 | Force Authorized | 不开 802.1X:“Keep 802.1X authentication disabled on ports connected to the authentication server, the internet and the management computer”29 |
无论哪家,都先在交换机上建好 VLAN。一个因为某次登录凭空变出来的 VLAN,是一个没人配置过、也没人给它加过防火墙规则的 VLAN。
TP-Link 上一个端口一个 VLAN
TP-Link 自己的指南说“VLAN Assignment takes effect only when the control type is Port Based”29。基于端口意味着第一台通过认证的设备为整个端口设定 VLAN。在那个端口上接一台桌面交换机,或者一部后面串着 PC 的电话,第二台设备就搭着第一台的 VLAN 进来了,从头到尾没人问它要过证书。在员工端口上,这就意味着插在那部电话背后的任何东西都进了员工网。
所以在 TP-Link 上:每个接入端口一台设备。墙上的网口和设备之间什么都不要接。Netgear 的基于 MAC 的模式会对一个端口上的每台设备分别认证;GS710TUP 手册说它允许“multiple supplicants connected to the same port”30。
MAB,给那台这些都不会的打印机
有些设备根本没有 802.1X 客户端。MAC 认证旁路(MAB)让交换机把设备的 MAC 地址作为用户名和密码一起发给 RADIUS,两家厂商都支持在同一端口上和 802.1X 一起用。Netgear 先试 802.1X,不行再回退:“if a client tries 802.1X authentication… and authentication fails, the interface proceeds with MAB authentication”27。TP-Link 发送的 MAC 格式是“12 hexadecimal digits, all lowercase and no punctuation”29。
MAC 地址不是身份。任何人都能用一条命令把自己的网卡设成打印机的 MAC,用的是他自己带进来的笔记本,人就站在那台刚被他借走网线的打印机旁边。所以 MAB 有它自己的一份清单,而策略最多只会给它 IoT VLAN 或隔离区:
mab {
if (!&EAP-Message && &User-Name =~ /^[0-9a-f]{12}$/ && &User-Password == &User-Name) {
mab_vlan
if (ok && &reply:Tunnel-Private-Group-Id =~ /^(20|99)$/) {
update control { &Auth-Type := Accept }
update reply {
&Tunnel-Type := VLAN
&Tunnel-Medium-Type := IEEE-802
}
}
else {
reject
}
}
}
这段放在 authorize 的最前面,配一个叫 mab_vlan 的 passwd 模块,读 mac,vlan 格式的行,和设备清单一模一样。证书策略用 if (&EAP-Message) 包起来,这样它就不碰 MAB。测试结果:
| MAB 请求 | 清单条目 | 答复 |
|---|---|---|
aabbccddeeff | 20 | Accept,VLAN 20 |
112233445566 | 无 | Reject |
ccddeeff0011 | 10,员工 VLAN | Reject。不管清单怎么写,策略都不会把一个 MAC 放进员工网 |
冒充打印机的人拿到的是打印机的 VLAN,仅此而已。一个 MAC 地址最多就只该值这么多。
上面的 Omada 交换机设置还对照一个模拟的 Omada Software Controller 6.2.14.11 检查过,它跑在一个背后没有任何硬件的容器里。它的英文界面字符串里点到了这里用到的每一个设置:RadSec 选项,即“a TLS-encrypted transmission tunnel will be established between the client and the RADIUS server”,“Enable VLAN Assignment for Wireless Network”,“Require Message-Authenticator”,“Limit Proxy-State”,以及 RadSec 用的客户端证书和私钥导入。控制器只负责配置,不转发流量,所以这只证明这些设置在那个版本里存在,别的什么都证明不了。Netgear 没有对应的东西可跑,所以它那一列来自 Netgear 自己的手册,没在这里测过。
接入点:一个 SSID,所有 VLAN
接入点是单一 SSID 见回报的地方。一个 WPA-Enterprise 网络,每个客户端被放进 RADIUS 为它指定的 VLAN。AP 给那个客户端的流量打上它的 VLAN 标签,顺着网线送上去,所以给 AP 供网的那个交换机端口必须带标签承载 RADIUS 可能分配的每一个 VLAN。漏掉一个,设备认证得好好的,却永远拿不到地址。
模拟一个 SSID
在相信任何一家厂商的说法之前,整套东西先在模拟的无线电上跑了一遍。Linux 的 mac80211_hwsim 能造出真正跑 WPA-Enterprise 的虚拟 WiFi 网卡。这台机器的内核没带这个模块,所以测试在一个小小的 KVM 虚拟机里启动了同一个内核,从 Fedora 自己签名的软件包里加载它,用 hostapd 2.11 做接入点,三个 wpa_supplicant 站点各在自己的网络命名空间里31:
interface=wlan0
driver=nl80211
ssid=Home
ieee8021x=1
wpa=2
wpa_key_mgmt=WPA-EAP
rsn_pairwise=CCMP
ieee80211w=1
auth_server_addr=192.0.2.10
auth_server_port=1812
auth_server_shared_secret=<shared secret>
dynamic_vlan=2
vlan_tagged_interface=trunk0
vlan_bridge=brvlan
dynamic_vlan=2 的意思是“必需”:答复里不带 VLAN 的登录会被拒绝,而不是扔到某个默认 VLAN 上。每个站点都以 anonymous 通过 TLS 1.3 登录,AP 自己的日志显示了 RADIUS 告诉它的内容:
wlan0: STA 02:00:00:00:01:00 RADIUS: VLAN ID 10
wlan0: STA 02:00:00:00:02:00 RADIUS: VLAN ID 99
wlan0: STA 02:00:00:00:03:00 RADIUS: VLAN ID 30
WPA: group state machine entering state GTK_INIT (VLAN-ID 10)
WPA: group state machine entering state GTK_INIT (VLAN-ID 30)
WPA: group state machine entering state GTK_INIT (VLAN-ID 99)
| 站点 | 证书 | VLAN | 网桥 | 它自己的网关 | 电视的 VLAN |
|---|---|---|---|---|---|
laptop1 | OU=staff | 10 | brvlan10 | 可达 | 无响应 |
cam1 | OU=iot,在清单上 | 99 | brvlan99 | 可达 | |
tv1 | OU=media | 30 | brvlan30 | 可达 |
组密钥那几行是大家容易漏看的部分。WiFi 上的广播和组播帧用一个全网共享的组密钥加密,如果三个 VLAN 共用一个,那么不管交换机怎么想,摄像头都能从空中读到笔记本的广播。hostapd 为每个 VLAN 保留一个独立的组密钥,日志显示它为每个 VLAN 各启动了一个。同样的测试改用 WPA3-Enterprise,即强制管理帧保护的 WPA-EAP-SHA256,得到的是同样三个 VLAN 和同样三个组密钥。
| 设置 | Netgear WAX 和 WBE | TP-Link Omada EAP |
|---|---|---|
| 安全 | WPA2 Enterprise 或 WPA3 Enterprise | WPA2-Enterprise 或 WPA3-Enterprise,包括一个只用 CCMP-128 的模式 |
| 由 RADIUS 分配 VLAN | Dynamic VLAN,Enable23 | “Enable VLAN Assignment for Wireless Network”28 |
| 答复里没有 VLAN | 客户端进入该 SSID 自己的 VLAN23 | 没有文档;这里的 FreeRADIUS 从不发不带 VLAN 的 Accept |
| RADIUS 传输 | 只有 UDP,所以要 radsecproxy | 从 Controller 6.1 起、配当前固件可用 RadSec20 |
Netgear 有两个细节,最好在被它们咬到之前就知道。RADIUS 服务器没给 VLAN 的客户端会被“automatically assigned the VLAN ID that you configured for the SSID”23,所以把 SSID 自己的 VLAN 设成隔离区,而不是员工网;这里的 FreeRADIUS 总会发一个 VLAN,但回退路径无论如何都应该默认关闭。还有,动态 VLAN“is mutually exclusive with a captive portal, NAT mode, wireless client isolation, and a multicast DNS (mDNS) gateway”23,所以同一个 SSID 上就别想再挂访客门户了。
WAX620 上的 WPA3-Enterprise 是 192 位模式:“the encryption is automatically set to GCMP256”32,并且强制管理帧保护。做不了 GCMP-256 的客户端连不上它。切换之前先拿你最老的设备试一试,和 TLS 1.3 一样。
设备,以及人人都跳过的那项检查
每台设备需要三样东西:它自己的证书和私钥,根证书,以及它应该预期的 RADIUS 服务器的名字。大多数指南讲了前两样。第三样漏掉了,照样能用,问题恰恰就在这里。
第三样是让设备不至于信任错误服务器的东西。这里搭了两次假 RADIUS 服务器:一次用同一个 CA 签发给 ha.home.example 的完全有效的证书,一次用自签名证书。一台笔记本用三种不同的客户端设置分别指向它们:
| 客户端检查 | 真服务器 | 同一 CA,别的名字 | 自签名 |
|---|---|---|---|
| CA 和服务器名 | 连上 | 被拒,Domain mismatch | 被拒 |
| 只查 CA | 连上 | 连上 | 被拒 |
| 什么都不查 | 连上 | 连上 | 连上 |
看中间那一行。你的 CA 给家里的每一台 Web 服务器都签了证书。只检查 CA 的设备会把其中任何一台当成它的 RADIUS 服务器来信任,所以任何人只要拿到其中一把私钥,不管是从一台被遗忘的测试机,还是从一台没人打补丁的 Web 服务器,就能架起一个用你的 SSID 的接入点,而你的设备会一声不吭地连上去。用 EAP-TLS,它们交不出密码,但它们已经在攻击者的网络上,并且信任它。TLS 1.3 改变不了这一点;在 1.3 下测出来还是同样三行。只有名字检查能改变它。
Android 先走了这一步。“Do not validate”选项被移除了,理由是“for security reasons”33,不过它也注明“saved enterprise configurations that are set up to turn off server certificate validation aren’t affected”33。一部老手机可能还带着这么一份配置。
| Linux(NetworkManager) | macOS、iOS、iPadOS | Android | |
|---|---|---|---|
| 证书和私钥 | 802-1x.client-cert、802-1x.private-key | 配置描述文件里的 Identity 载荷 | 作为 Wi-Fi 证书安装 |
| 根证书 | 802-1x.ca-cert | Certificate 载荷,通过 PayloadCertificateAnchorUUID 信任34 | CA 证书字段 |
| 服务器名 | 802-1x.domain-match35 | TLSTrustedServerNames34 | 域名字段;API 里是 setDomainSuffixMatch36 |
| TLS 1.3 | 802-1x.phase1-auth-flags tls-1-3-enable | TLSMinimumVersion 和 TLSMaximumVersion 设为 "1.3";最大值默认是 "1.2"34 | setMinimumTlsVersion(TLS_V1_3),从 API level 34 起,前提是设备支持36 |
在 Linux 上整件事就是一条命令。它用 nmcli --offline 检查过,这会打印出它将要建立的连接,而不碰正在运行的系统:
nmcli connection add type wifi con-name Home ifname '*' ssid Home \
wifi-sec.key-mgmt wpa-eap 802-1x.eap tls 802-1x.identity anonymous \
802-1x.ca-cert /etc/pki/home/root_ca.crt \
802-1x.domain-match radius.home.example \
802-1x.client-cert /etc/pki/home/laptop1.crt \
802-1x.private-key /etc/pki/home/laptop1.key \
802-1x.private-key-password-flags not-required \
802-1x.phase1-auth-flags tls-1-3-enable
有线端口也一样,换成 type ethernet,不要 SSID。Apple 那边的陷阱是 TLS 最高版本默认为 1.2:漏掉这一项的描述文件会配出一台被这个网络拒之门外的 Mac。
只用 TLS 1.3 的代价
这套搭建实打实的局限,在于做不到它的设备。一台带着多年前嵌入式请求方的摄像头或电视,可能能跑基于 1.2 的 EAP-TLS,却永远跑不了 1.3,而你这边没有任何设置能修好这一点。TLS 版本是在 FreeRADIUS 看到证书之前就协商好的,所以它没法为 IoT 角色网开一面。
所以买之前先测每台设备。不是买之后。把它指向一个只跑 1.3 的 FreeRADIUS,然后读日志:recv TLS 1.3 Handshake, ClientHello 或者 protocol version,看这个就够了。测不过的设备,要么用 MAB 接到有线端口上,要么就别上网。为了迁就网上最差的那台设备而削弱整个网络,共享密码当初就是这么来的。
完整配置,逐个文件
上面所有内容都删减到了只剩说明每个要点的那几行。这里是全部。这里的每个文件都在实验环境里跑过,从一个空的 step-ca 和一棵原装的 FreeRADIUS 配置树,一直到一台进了 VLAN 10 的笔记本,下面的副本就是那些文件,只是把实验环境的地址换成了表里的地址。可以打包下载 eap-tls-configs.tar.gz,也可以通过链接逐个获取。
| 名字 | 地址 | 是什么 |
|---|---|---|
ca.home.example | 只按名字 | step-ca,端口 9000 |
radius.home.example | 192.0.2.10 | FreeRADIUS,RadSec 在 2083 |
radsecproxy | 192.0.2.11 | radsecproxy,UDP 进,RadSec 出 |
switch1、ap1 | 192.0.2.21、192.0.2.31 | 会说 RadSec 的设备 |
| 只会 UDP 的设备 | 192.0.2.32 到 .63 | 经由 radsecproxy;下面的 Linux AP 是 .33 上的 ap2 |
| 文件 | 放到 | 作用 |
|---|---|---|
step-ca/templates/device.tpl | CA 里的 /home/step/templates/ | 把角色写进 OU,仅客户端认证 |
step-ca/templates/nas.tpl | CA 里的 /home/step/templates/ | OU=nas,用于 RadSec |
step-ca/setup.sh | 在 CA 里跑一次 | 添加 network 和 nas 两个 provisioner |
step-ca/issue.sh | 在 step 信任该 CA 的地方跑 | 所有证书,以及吊销的做法 |
freeradius/install.sh | 在 freeradius/ 里跑 | 把其余文件放到位 |
freeradius/mods-available/eap | RADDB/mods-available/ | EAP-TLS,TLS 1.3,检查 CRL |
freeradius/mods-available/device_vlan | RADDB/mods-available/ | 读按设备的清单 |
freeradius/mods-available/mab_vlan | RADDB/mods-available/ | 读 MAB 清单 |
freeradius/mods-config/device_vlan/devices | RADDB/mods-config/device_vlan/ | 证书名对应 VLAN |
freeradius/mods-config/device_vlan/mab | RADDB/mods-config/device_vlan/ | MAC 地址对应 VLAN |
freeradius/policy.d/vlan | RADDB/policy.d/ | 为证书挑选 VLAN |
freeradius/policy.d/mab | RADDB/policy.d/ | 为 MAC 挑选 VLAN,只限 20 或 99 |
freeradius/sites-available/default.patch | 打到 RADDB 上 | 调用两个策略 |
freeradius/sites-available/tls | RADDB/sites-available/ | RadSec 监听器及其客户端 |
freeradius/nas-only.sh | RADDB/ | 只放行 OU=nas 证书 |
freeradius/clients.conf | RADDB/ | 在本机上测试用的 UDP |
systemd/radius-crl-refresh | /usr/local/sbin/ | 拉取并检查 CRL |
systemd/radius-crl-refresh.service | /etc/systemd/system/ | 运行它 |
systemd/radius-crl-refresh.timer | /etc/systemd/system/ | 每小时一次 |
systemd/radius-cert-renew.service | /etc/systemd/system/ | 续期服务器证书 |
radsecproxy/radsecproxy.conf | /etc/radsecproxy.conf | UDP 进,RadSec 出 |
hostapd/hostapd-wired.conf | /etc/hostapd/ | 一个 Linux 802.1X 交换机端口 |
hostapd/hostapd-wifi.conf | /etc/hostapd/ | 一个 Linux 接入点,一个 SSID |
clients/wpa_supplicant-wired.conf | 设备 | 有线登录 |
clients/wpa_supplicant-wifi.conf | 设备 | WiFi 登录 |
clients/nmcli.sh | 设备 | 同上,通过 NetworkManager |
FreeRADIUS 在每个发行版上的位置都不一样,而它的文件不在乎是哪个,因为里面的每条路径都是从配置目录拼出来的。install.sh 把这个目录当作 RADDB。下面三种都跑过它,FreeRADIUS 自己的配置检查 -XC 在每一种上都通过了。只有官方镜像接着跑完了本文的每一项测试;在另外两种上,那次检查就是全部证据,而且是在容器里,所以真实 Fedora 机器上的 SELinux 不在其中。
| 官方镜像 | Debian 13 | Fedora | |
|---|---|---|---|
| FreeRADIUS | 3.2.10 | 3.2.7 | 3.2.8 |
RADDB | /etc/freeradius | /etc/freeradius/3.0 | /etc/raddb |
| 运行用户 | freerad | freerad | radiusd |
| 服务 | 容器本身 | freeradius | radiusd |
| 测试过 | 本文的全部内容 | install.sh 和 -XC | install.sh 和 -XC |
两个 systemd 单元写的是 /etc/freeradius 和 freeradius 服务。在 Debian 或 Fedora 上,按上表把两者都改掉。别的都不用动。
step-ca
设备模板就是把角色写进证书里的那个,一行不差,只在顶上加了一段注释。nas 模板是同样的思路,只是角色写死了:
{{- /* Certificates for switches, access points and radsecproxy, used
for RadSec. OU=nas is what FreeRADIUS checks for; it maps to no
VLAN, so a nas certificate cannot get a device on the network. */ -}}
{
"subject": {
"commonName": {{ toJson .Subject.CommonName }},
"organizationalUnit": "nas"
},
"sans": {{ toJson .SANs }},
"keyUsage": ["digitalSignature"],
"extKeyUsage": ["clientAuth"],
"crlDistributionPoints": ["http://ca.home.example/1.0/crl"]
}
setup.sh 添加两个 provisioner。在 step-ca 容器里跑一次。它会为每个 provisioner 提示输入一个密码,它打印出来的 CRL 配置块要手工放进 ca.json:
#!/bin/sh
# Run inside the step-ca container, as the step user, once.
# Adds the two provisioners this post uses. Each asks for a password for
# its own key; keep both.
set -e
step ca provisioner add network --type JWK --create \
--x509-max-dur 8760h --x509-default-dur 24h \
--x509-template /home/step/templates/device.tpl
step ca provisioner add nas --type JWK --create \
--x509-max-dur 8760h --x509-default-dur 24h \
--x509-template /home/step/templates/nas.tpl
# Then add this block at the top level of /home/step/config/ca.json and
# restart the container:
#
# "crl": {
# "enabled": true,
# "generateOnRevoke": true,
# "cacheDuration": "24h",
# "idpURL": "http://ca.home.example/1.0/crl"
# }
issue.sh 签发本文中的每一张证书,并把吊销那一节里的做法作为注释留着,等你哪天用得上。那个做法也对这个 CA 跑过,对象是专门为此做的一台 laptop2:
#!/bin/sh
# Issue the certificates. Run anywhere the step CLI trusts the CA.
set -e
# The RADIUS server: default 24 hours, renewed daily by radius-cert-renew.service.
step ca certificate radius.home.example radius.crt radius.key --provisioner admin
# Devices: a year each, the role decides the VLAN.
step ca certificate laptop1 laptop1.crt laptop1.key --provisioner network --not-after 8760h --set role=staff
step ca certificate cam1 cam1.crt cam1.key --provisioner network --not-after 8760h --set role=iot
step ca certificate tv1 tv1.crt tv1.key --provisioner network --not-after 8760h --set role=media
# Switches, APs and radsecproxy, for RadSec.
step ca certificate switch1 switch1.crt switch1.key --provisioner nas --not-after 8760h
step ca certificate ap1 ap1.crt ap1.key --provisioner nas --not-after 8760h
step ca certificate radsecproxy radsecproxy.crt radsecproxy.key --provisioner nas --not-after 8760h
# A lost device: revoke by serial, no key needed.
# SERIAL=$(step certificate inspect laptop2.crt --format json | jq -r .serial_number)
# TOKEN=$(step ca token "$SERIAL" --revoke --provisioner admin)
# step ca revoke "$SERIAL" --token "$TOKEN" --reason "laptop lost"
FreeRADIUS
在下载包的 freeradius 目录里运行 install.sh。它把文件复制进去,给默认站点打补丁,再建好链接。它就干这些:
#!/bin/sh
# Puts these files into a stock FreeRADIUS 3.2 tree. Run from this
# directory. RADDB is /etc/freeradius on the official image,
# /etc/freeradius/3.0 on Debian and Ubuntu, /etc/raddb on Fedora.
set -eu
RADDB=${RADDB:-/etc/freeradius}
cp mods-available/eap mods-available/device_vlan mods-available/mab_vlan "$RADDB/mods-available/"
mkdir -p "$RADDB/mods-config/device_vlan"
cp mods-config/device_vlan/devices mods-config/device_vlan/mab "$RADDB/mods-config/device_vlan/"
cp policy.d/vlan policy.d/mab "$RADDB/policy.d/"
cp sites-available/tls "$RADDB/sites-available/"
cp clients.conf "$RADDB/"
install -m 0755 nas-only.sh "$RADDB/nas-only.sh"
patch -d "$RADDB" -p0 --forward < sites-available/default.patch
for m in eap device_vlan mab_vlan; do
ln -sfn ../mods-available/$m "$RADDB/mods-enabled/$m"
done
ln -sfn ../sites-available/tls "$RADDB/sites-enabled/tls"
# The certificates go in $RADDB/certs/eaptls: radius.crt, radius.key,
# and ca/ holding root_ca.crt, intermediate_ca.crt and the CRL. All of
# it readable by the user FreeRADIUS runs as: freerad, or radiusd on
# Fedora.
mkdir -p "$RADDB/certs/eaptls/ca"
这个补丁是原装默认站点里的两行。它是对着 3.2.10 做的,打到 3.2.7 和 3.2.8 上最多也就是个偏移:
freeradius/sites-available/default.patch
--- sites-available/default
+++ sites-available/default
@@ -301,6 +301,9 @@
# Make *sure* that 'preprocess' comes before any realm if you
# need to setup hints for the remote radius server
authorize {
+ # MAC Authentication Bypass, policy.d/mab.
+ mab
+
#
# Take a User-Name, and perform some checks on it, for spaces and other
# invalid characters. If the User-Name appears invalid, reject the
@@ -810,6 +813,9 @@
# Once we KNOW that the user has been authenticated, there are
# additional steps we can take.
post-auth {
+ # The VLAN for a certificate login, policy.d/vlan.
+ vlan_by_certificate
+
#
# If you need to have a State attribute, you can
# add it here. e.g. for later CoA-Request with
mods-available/eap 替换原装的那个。全文如下:
# EAP for 802.1X: EAP-TLS only, TLS 1.3 only, CRL checked on every login.
# Replaces the stock mods-available/eap. mods-enabled/eap links to it.
eap {
default_eap_type = tls
timer_expire = 60
ignore_unknown_eap_types = no
max_sessions = ${max_requests}
tls-config tls-common {
# The server certificate followed by step-ca's intermediate,
# exactly as "step ca certificate" writes it.
certificate_file = ${certdir}/eaptls/radius.crt
private_key_file = ${certdir}/eaptls/radius.key
# Root, intermediate and the intermediate's CRL, hashed with
# "openssl rehash". radius-crl-refresh keeps the CRL current.
ca_path = ${certdir}/eaptls/ca
ca_file = ${certdir}/eaptls/ca/root_ca.crt
check_crl = yes
# A HUP does not reload a CRL. This does, at 300 s, the minimum.
ca_path_reload_interval = 300
tls_min_version = "1.3"
tls_max_version = "1.3"
cipher_list = "DEFAULT"
ecdh_curve = ""
cache {
enable = no
}
verify {
}
}
tls {
tls = tls-common
}
}
policy.d/vlan 就是前面的策略,加上 MAB 那一节提到的 if (&EAP-Message) 外壳:
# Called first in post-auth. Picks the VLAN for a certificate login:
# the per-device list first, then the role in the certificate's OU.
vlan_by_certificate {
# Certificate logins only. MAB is decided in authorize.
if (&EAP-Message) {
# Only certificates made for this job: client auth, and a role.
if (&TLS-Client-Cert-X509v3-Extended-Key-Usage-OID !~ /1\.3\.6\.1\.5\.5\.7\.3\.2/) {
reject
}
# 1. The per-device list wins.
device_vlan
# 2. Otherwise the role in the certificate decides.
if (!&reply:Tunnel-Private-Group-Id) {
if (&TLS-Client-Cert-Subject =~ /\/OU=([^\/]+)/) {
switch "%{1}" {
case "staff" {
update reply { &Tunnel-Private-Group-Id := "10" }
}
case "iot" {
update reply { &Tunnel-Private-Group-Id := "20" }
}
case "media" {
update reply { &Tunnel-Private-Group-Id := "30" }
}
case {
reject
}
}
}
else {
reject
}
}
update reply {
&Tunnel-Type := VLAN
&Tunnel-Medium-Type := IEEE-802
}
}
}
policy.d/mab 是 MAB 那一节里的策略,mods-available/device_vlan 和 nas-only.sh 和前面展示的一样,三者都加了注释。MAB 清单的模块和两份清单:
freeradius/mods-available/mab_vlan
# MAC Authentication Bypass: MAC address to VLAN, for kit with no
# 802.1X client. The mab policy only accepts VLAN 20 or 99 from here.
# mods-enabled/mab_vlan links to it.
passwd mab_vlan {
filename = ${modconfdir}/device_vlan/mab
format = "*User-Name:=Tunnel-Private-Group-Id"
delimiter = ","
}
freeradius/mods-config/device_vlan/devices
# Certificate CN,VLAN. Overrides the role in the certificate.
# cam1 is quarantined while it is looked at.
cam1,99
freeradius/mods-config/device_vlan/mab
# MAC (12 hex digits, lowercase, no punctuation),VLAN. 20 or 99 only.
aabbccddeeff,20
sites-available/tls 替换原装的 RadSec 示例。verify 的临时目录是 ${run_dir},它本来就存在,并且属于 FreeRADIUS 的运行用户,所以不用新建任何东西:
freeradius/sites-available/tls
# RadSec: RADIUS over TLS 1.3 on port 2083, for switches, access
# points and radsecproxy. Replaces the stock sites-available/tls;
# sites-enabled/tls links to it. Requests go to the default site.
listen {
ipaddr = *
port = 2083
type = auth
proto = tcp
virtual_server = default
clients = radsec
limit {
max_connections = 16
lifetime = 0
idle_timeout = 30
}
tls {
certificate_file = ${certdir}/eaptls/radius.crt
private_key_file = ${certdir}/eaptls/radius.key
ca_path = ${certdir}/eaptls/ca
ca_file = ${certdir}/eaptls/ca/root_ca.crt
require_client_cert = yes
check_crl = yes
ca_path_reload_interval = 300
# Only certificates from step-ca's nas provisioner.
verify {
# Where FreeRADIUS writes the certificate for the script to read.
tmpdir = ${run_dir}
client = "${raddbdir}/nas-only.sh %{TLS-Client-Cert-Filename}"
}
tls_min_version = "1.3"
tls_max_version = "1.3"
cipher_list = "DEFAULT"
ecdh_curve = ""
cache {
enable = no
}
}
}
# One entry per switch, AP and proxy, by management address. Over TLS
# the secret does nothing, and FreeRADIUS requires it to be "radsec".
clients radsec {
client switch1 {
ipaddr = 192.0.2.21
proto = tls
secret = radsec
}
client ap1 {
ipaddr = 192.0.2.31
proto = tls
secret = radsec
}
client radsecproxy {
ipaddr = 192.0.2.11
proto = tls
secret = radsec
}
}
clients.conf 替换原装的那个,只放行本机上的 eapol_test,别的一概不放。交换机和 AP 通过 RadSec 或经由代理进来:
# UDP clients. Kit talks RadSec (sites-available/tls) or goes through
# radsecproxy, so plain RADIUS is only for testing on this host with
# eapol_test. Replaces the stock clients.conf.
client localhost {
ipaddr = 127.0.0.1
proto = *
secret = CHANGE-ME-test-only
require_message_authenticator = yes
nas_type = other
}
先检查配置。然后在前台启动它,打开线程,这样 RadSec 才能用:
freeradius -XC
freeradius -fxx -l stdout
保持更新
radius-crl-refresh 用钉住的根证书拉取 CRL,拒绝不是由中间证书签名的或已经过期的 CRL,所以一次失败的拉取会把旧名单留在原地。它绝不会拿垃圾换掉一份好名单:
#!/bin/sh
# Fetch step-ca's CRL over HTTPS with the root pinned, and put it where
# FreeRADIUS reads it. FreeRADIUS picks it up within ca_path_reload_interval.
# Installed as /usr/local/sbin/radius-crl-refresh.
set -eu
CA_URL="${CA_URL:-https://ca.home.example:9000}"
DIR="${DIR:-/etc/freeradius/certs/eaptls/ca}"
TMP=$(mktemp -d)
trap 'rm -rf "$TMP"' EXIT
curl -fsS --cacert "$DIR/root_ca.crt" --tlsv1.3 -o "$TMP/crl.der" "$CA_URL/1.0/crl"
openssl crl -inform DER -in "$TMP/crl.der" -out "$TMP/crl.pem"
# Refuse a list that is not signed by our intermediate, or already stale.
openssl crl -in "$TMP/crl.pem" -noout -CAfile "$DIR/intermediate_ca.crt" 2>&1 | grep -q 'verify OK'
next=$(date -d "$(openssl crl -in "$TMP/crl.pem" -noout -nextupdate | cut -d= -f2)" +%s)
[ "$next" -gt "$(date +%s)" ]
install -m 0644 "$TMP/crl.pem" "$DIR/intermediate.crl.pem.new"
mv -f "$DIR/intermediate.crl.pem.new" "$DIR/intermediate.crl.pem"
openssl rehash "$DIR"
systemd/radius-crl-refresh.service
[Unit]
Description=Fetch step-ca's CRL for FreeRADIUS
Wants=network-online.target
After=network-online.target
[Service]
Type=oneshot
ExecStart=/usr/local/sbin/radius-crl-refresh
systemd/radius-crl-refresh.timer
[Unit]
Description=Fetch step-ca's CRL for FreeRADIUS every hour
[Timer]
OnBootSec=1min
OnUnitActiveSec=1h
RandomizedDelaySec=5min
Persistent=true
[Install]
WantedBy=timers.target
服务器证书寿命 24 小时,所以它自己续期。这里的续期保留了私钥和两个文件的权限,这很要紧,因为 FreeRADIUS 以 freerad 身份读取它们。它重启 FreeRADIUS,而不是发 HUP。原因和 CRL 一样:
systemd/radius-cert-renew.service
# Keeps FreeRADIUS's 24-hour server certificate renewed, and restarts
# FreeRADIUS on each renewal so it loads the new one. Once, as root:
# step ca bootstrap --ca-url https://ca.home.example:9000 --fingerprint <root fingerprint>
# chgrp freerad radius.key && chmod 0640 radius.key
# Renewal rewrites radius.crt and keeps the key and both files' modes.
[Unit]
Description=Renew FreeRADIUS's server certificate from step-ca
Wants=network-online.target
After=network-online.target
[Service]
ExecStart=/usr/bin/step ca renew --daemon \
--exec "systemctl restart freeradius" \
/etc/freeradius/certs/eaptls/radius.crt /etc/freeradius/certs/eaptls/radius.key
Restart=on-failure
RestartSec=5min
[Install]
WantedBy=multi-user.target
radsecproxy
# radsecproxy beside switches and APs that only speak UDP RADIUS.
# Takes UDP in on the management VLAN, sends RadSec over TLS 1.3 out.
ListenUDP *:1812
LogLevel 3
LogDestination file:///var/log/radsecproxy.log
tls stepca {
CACertificateFile /etc/radsecproxy/root_ca.crt
CertificateFile /etc/radsecproxy/radsecproxy.crt
CertificateKeyFile /etc/radsecproxy/radsecproxy.key
TlsVersion TLS1_3
}
# The kit that only speaks UDP, from 192.0.2.32 to .63 on the management
# VLAN. Netgear caps the secret at 16 alphanumeric characters, so use all
# 16, random:
# openssl rand -base64 32 | tr -dc 'A-Za-z0-9' | head -c 16
client switches {
host 192.0.2.32/27
type udp
secret CHANGE-ME-16chars
RequireMessageAuthenticator on
}
server freeradius {
host radius.home.example
port 2083
type tls
tls stepca
secret radsec
certificateNameCheck on
}
realm * {
server freeradius
}
hostapd
一台 Linux 机器充当交换机端口,说 RadSec。模拟端口跑的就是这个文件:
# A Linux box as an 802.1X wired port, talking RadSec to FreeRADIUS.
# Needs hostapd built with CONFIG_DRIVER_WIRED=y and CONFIG_RADIUS_TLS=y.
interface=eth1
driver=wired
ieee8021x=1
use_pae_group_addr=1
eap_reauth_period=3600
nas_identifier=switch1
auth_server_addr=192.0.2.10
auth_server_port=2083
auth_server_type=TLS
auth_server_shared_secret=radsec
auth_server_ca_cert=/etc/hostapd/root_ca.crt
auth_server_client_cert=/etc/hostapd/switch1.crt
auth_server_private_key=/etc/hostapd/switch1.key
logger_syslog=-1
logger_syslog_level=2
接入点用的。这一个像 Netgear AP 那样,经由 radsecproxy 走 UDP,模拟无线电跑的就是这个文件:
# A Linux access point: one WPA2/WPA3-Enterprise SSID, each client on the
# VLAN RADIUS names. This one talks UDP to radsecproxy, like the Netgear
# APs. For RadSec, build hostapd with CONFIG_RADIUS_TLS=y and use the
# auth_server_* block from hostapd-wired.conf instead.
interface=wlan0
driver=nl80211
ssid=Home
country_code=GB
hw_mode=g
channel=6
ieee8021x=1
eapol_version=2
wpa=2
# WPA-EAP for WPA2-Enterprise; WPA-EAP-SHA256 with ieee80211w=2 for WPA3-Enterprise.
wpa_key_mgmt=WPA-EAP WPA-EAP-SHA256
rsn_pairwise=CCMP
ieee80211w=1
nas_identifier=ap2
own_ip_addr=192.0.2.33
auth_server_addr=192.0.2.11
auth_server_port=1812
auth_server_shared_secret=CHANGE-ME-16chars
radius_require_message_authenticator=1
# 2 = required: no VLAN in the answer means no network.
dynamic_vlan=2
vlan_naming=1
vlan_tagged_interface=eth0
vlan_bridge=brvlan
ctrl_interface=/run/hostapd
logger_syslog=-1
logger_syslog_level=2
设备
nmcli.sh 是设备那一节里的那条命令,外加它的有线版孪生兄弟。没有 NetworkManager 的话,wpa_supplicant 用这些:
clients/wpa_supplicant-wired.conf
# Linux client, wired 802.1X. Run: wpa_supplicant -D wired -i eth0 -c this-file
ctrl_interface=/run/wpa_supplicant
ap_scan=0
network={
key_mgmt=IEEE8021X
eapol_flags=0
eap=TLS
phase1="tls_disable_tlsv1_3=0"
identity="anonymous"
ca_cert="/etc/pki/home/root_ca.crt"
domain_match="radius.home.example"
client_cert="/etc/pki/home/laptop1.crt"
private_key="/etc/pki/home/laptop1.key"
}
clients/wpa_supplicant-wifi.conf
# Linux client, WiFi, without NetworkManager. TLS 1.3, anonymous identity,
# and the server name checked.
ctrl_interface=/run/wpa_supplicant
network={
ssid="Home"
key_mgmt=WPA-EAP WPA-EAP-SHA256
ieee80211w=1
eap=TLS
phase1="tls_disable_tlsv1_3=0"
identity="anonymous"
ca_cert="/etc/pki/home/root_ca.crt"
domain_match="radius.home.example"
client_cert="/etc/pki/home/laptop1.crt"
private_key="/etc/pki/home/laptop1.key"
}
每个文件对照什么测过
| 文件 | 对照 | 结果 |
|---|---|---|
step-ca/ | step-ca 0.30.2,一个新 CA | 全部 7 张证书带角色签发;laptop2 按那个做法签发并吊销 |
freeradius/ | 3.2.10,由 install.sh 安装 | laptop1 进 VLAN 10,cam1 进 99,tv1 进 30,一张 nas 证书被拒;MAB aabbccddeeff 进 VLAN 20,未知 MAC 被拒 |
radius-crl-refresh | 基于 TLS 1.3 的 step-ca | CRL 安装并做了哈希;已吊销的笔记本五分钟内被拒,无需重启 |
radius-cert-renew.service | step ca renew 0.30.2 | 证书已续期;私钥和权限都没动 |
radsecproxy.conf | radsecproxy 1.11.2 | 经由它的 EAP-TLS 被接受;带 Message-Authenticator 的 MAB 进 VLAN 20,不带的被丢弃 |
hostapd-wired.conf | hostapd 2.11,带 RadSec 编译 | 通过 TLS 1.3 进 VLAN 10、99 和 30 |
hostapd-wifi.conf、wpa_supplicant-wifi.conf | 模拟无线电,经由 radsecproxy | 一个 SSID 上三个站点,VLAN 10、99 和 30;按原样写的客户端文件和一个只用 WPA3 的站点都连上了 |
wpa_supplicant-wired.conf | eapol_test 2.11 | 答复和前面那张表一样 |
| systemd 单元 | systemd-analyze verify | 除了两个程序没在这里安装,没有别的抱怨 |
什么会把所有人关在门外
下面每一项都是在搭建过程中撞上或测过的,只有 trunk 上缺 VLAN 那一项例外,那得有台真交换机才能演示。几乎全都是默认关闭式的失败。这是正确的失败方式,但照样是个糟糕的早晨。
| 故障 | 你看到什么 | 修法 |
|---|---|---|
| CRL 过期或缺失 | 每台设备都被拒;CRL has expired 或 unable to get certificate CRL | 用定时器拉取 CRL 并监控它 |
| 新 CRL 没被读入 | 已吊销的设备照样连上 | ca_path_reload_interval = 300,或者重启 FreeRADIUS |
| 客户端关了 TLS 1.3 | protocol version,设备被拒 | tls_disable_tlsv1_3=0、tls-1-3-enable 或 Apple 描述文件里的那几个键 |
证书文件 freerad 读不了 | FreeRADIUS 起不来,Permission denied | 让 freerad 能读,私钥只让它读 |
| 证书没有角色 | 被策略拒绝 | 通过 network provisioner 用 --set role= 重签 |
| 交换机或 AP 的 trunk 上没有这个 VLAN | 设备认证通过,拿不到地址 | 建好 VLAN,并在设备能到达的每条 trunk 上打标签 |
| RADIUS 共享密钥错误 | 没有答复;FreeRADIUS 记下 invalid Message-Authenticator! (Shared secret is incorrect.),交换机一直重试直到放弃 | clients.conf 和交换机或 AP 上用同一个密钥 |
| 设备不检查服务器名 | 什么都看不到。它能用,换成冒牌货也一样能用 | 在每台设备上设好服务器名 |
| 请求不带 Message-Authenticator | 被悄悄丢弃;交换机重试然后放弃 | 在交换机上打开它,或者在前面放一个 radsecproxy |
在 freeradius -X 下跑 RadSec 监听器 | Threading must be enabled for TLS sockets | freeradius -fxx -l stdout |
| hostapd 编译时没带 RadSec | unsupported RADIUS type 'TLS' | 用 CONFIG_RADIUS_TLS=y 编译,或者用 radsecproxy |
| 给 radsecproxy 填的是服务器地址 | No subjectaltname matching address | 用 radius.home.example |
为什么这不是每个企业网络的默认配置?
本文没有任何新东西。EAP-TLS 发布于 1999年10月37。VLAN 属性随后在 2003年9月到来3。上面两家交换机厂商都在自己的手册里写了动态 VLAN,而 CA、RADIUS 服务器和代理都是开源的,一分钱不花。走商业路线,同样的东西就变成了预算里的一行:Cisco 把“RADIUS authentication, authorization, and accounting, including 802.1X, MAC authentication bypass”放在 ISE 的 Essentials 档里,按“concurrent active endpoints”授权,而一个端点可以是网络上的“printers, fax machines, or other types of network devices”38之一。不管哪条路,这项能力在设备里躺了二十多年了。
那么,为什么 2026 年的企业网络还跑在一个人人共享的密码上?
我能问一句吗:为什么那么多管理员和 MSP 干脆就懒得做?我问的不是谁。我问的是什么让这件事一直延续下去。诚实的答案有三个,因为情况有三种。
有些人不知道。 这正是失职所在,而不是借口。知道你自己的交换机能干什么,不是一件会自己找上门的事。确保自己知道,就是这份工作本身,而写明这一点的手册是免费下载的。
有些人知道,但放着不管。 共享密码能用。没人为它提工单。每台设备一张证书是一堆杂活,在某天丢了一台笔记本之前什么成果都看不到,因此它永远排不进待办清单。对 MSP 来说,账算得更直白:一个只有一个密码的扁平网络支持起来更便宜,没有哪份合同衡量它,客户也从来不问。MSP 系列细讲了这些激励会把人带到哪里,这里是同一个模式,只是账单小一些。这个问题针对的正是这种情况:手里有能做到的交换机、已经读到了这里、却因为没人逼他给出理由而继续用共享密钥的管理员。
有些人确实还做不到。 没有请求方的打印机,做不了 TLS 1.3 的电视,厂商不肯更新的业务专用设备。这是实实在在的限制,答案是肯定的,这说得过去:用 MAB 放到一个圈起来的 VLAN 上,把理由写下来,旁边再写上那台设备退役的日期。
失职不在于有缺口。谁都有缺口。失职在于明明设备出厂时就能堵上,你却从没去堵,就这么带着缺口跑一个企业网络。
谁都用过共享密码。在企业网络上主动选择继续用一个,这才是说不过去的部分。
为什么 Cyber Essentials 不要求这个
因为它本来就不是为这个设计的。Cyber Essentials 是政府背书的基线,而且“a growing number of organisations require suppliers to be certified to bid for work”39。它针对的是“the most common internet based cyber security threats”39,它的要求也明确写了它管到哪里为止。攻击者无法从互联网够到的无线设备不在范围内,因为“the Cyber Essentials scheme isn’t concerned with attacks that can only be launched within the signal range of the wireless device”40。它的五项控制是防火墙、安全配置、安全更新、用户访问控制和恶意软件防护40。没有一项问的是谁一开始就被允许进入网络。最接近的一条是“change any default or guessable account passwords”40,而印在前台桌上的 WiFi 密码不是账户。
VLAN 在里面出现过,一次。一个组织的“sub-set”,即一个“segregated from the rest of the organisation by a firewall or VLAN”40的部分,可以单独评估。所以这个方案唯一碰到 VLAN 的地方,是把它当作把线圈得更小、少评估一点网络的手段。
就它自己的定位而言,这说得过去。它是一道防范来自互联网攻击的底线,它自己也这么说。麻烦在于,一道底线一旦挂上墙变成证书会怎样。它变成目标,然后变成天花板,一家企业可以在所有设备都挤在一个扁平网络上、躲在一个连保洁员都知道的密码后面的情况下通过它。任何拿着笔记本从楼前走过的人,都在真正要紧的那个威胁模型之内,却在被评估的那个之外。
密码是一个没人遵守的承诺
搭这套东西时让我印象深刻的是,难的部分少之又少。里面的每个陷阱都在某处写着,在某段配置注释里或某本厂商手册里,而每一个都在实验室里花一个下午就搞定了。
可家里照样跑在一个写在冰箱上的 WiFi 密码上。不是因为替代方案难,而是因为密码是默认选项,而默认选项从来不用为自己辩护。人人都知道它是共享的。人人都知道它会泄露。没人去改它,因为改它意味着拿着新密码把家里每台设备都走一遍,于是它一用就是好几年,经历了每一位客人、每一个租客、每一部还存着它就进了回收箱的手机,它把每一个曾经拿到过它的人都放了进来。
每台设备一张证书,是对网络用途的另一种理解。网络应该知道一样东西是什么,而不只是知道曾经有人往里敲对了一个词。这是一个没人检查时你也对自己执行的标准,也是唯一值得拥有的那种标准。摄像头不能因为碰巧在同一个 SSID 上就挨着笔记本坐。它坐在你放它的地方,在你自己拥有的设备上,按你写下且读得懂的规则。它不老实,改文本文件里的一行就挪走它。它丢了,一条命令就把它关在门外。
代价是杂活。一份背后有定时器的 CRL,在日记本上记着日期的证书,买之前先测过的设备。这就是代价,而且方向是对的:你付出的是看得见的力气,而不是一个多年来一直悄悄放人进来的密码。
RFC 3748 — Extensible Authentication Protocol (EAP) — EAP,以及它在其间运行的对端、认证方和认证服务器这几个角色。 ↩︎
RFC 2868 — RADIUS Attributes for Tunnel Protocol Support — 定义了 RFC 3580 拿来复用于 VLAN 的隧道属性。 ↩︎
RFC 3580 — IEEE 802.1X RADIUS Usage Guidelines — 第 3.31 节,“Tunnel-Type=VLAN (13) Tunnel-Medium-Type=802 Tunnel-Private-Group-ID=VLANID”,以及“the VLANID integer value is encoded as a string”。 ↩︎ ↩︎ ↩︎
Microsoft Security Advisory 2743314 — “An attacker who obtained the MS-CHAP v2 authentication traffic could then use the exploit code to decrypt a user’s credentials.” ↩︎
RFC 5216 — The EAP-TLS Authentication Protocol — 基于 EAP 的双向证书认证。 ↩︎
RFC 9190 — EAP-TLS 1.3 — “TLS 1.3 also encrypts certificates and some of the extensions. When using EAP-TLS with TLS 1.3, the use of privacy is mandatory and does not cause any additional round trips”;第 2.1.7 节建议在身份响应中使用匿名 NAI。 ↩︎ ↩︎
FreeRADIUS 3.2.10 — mods-available/eap —
check_crl,check_all_crl“Check if intermediate CAs have been revoked”,allow_expired_crl,以及“most EAP supplicants WILL NOT DO TLS 1.3 PROPERLY”。 ↩︎ ↩︎ ↩︎Smallstep — Certificate templates — 用
--set传入的用户数据在模板里是.Insecure.User;值一律用toJson包起来。 ↩︎FreeRADIUS 3.2.10 — dictionary.freeradius.internal — 策略读取的
TLS-Client-Cert-*属性,包括TLS-Client-Cert-Subject和TLS-Client-Cert-X509v3-Extended-Key-Usage-OID。 ↩︎FreeRADIUS 3.2.10 — mods-available/passwd — “Attributes marked as ‘=’ are added to reply_items instead of default configure_items”。 ↩︎
wpa_supplicant — wpa_supplicant.conf — “tls_disable_tlsv1_3=0 - enable TLSv1.3 (experimental - disabled by default)”,以及
domain_match,即“Constraint for server domain name”。 ↩︎RFC 2548 — Microsoft Vendor-specific RADIUS Attributes —
MS-MPPE-Send-Key和MS-MPPE-Recv-Key,加密方式为“b(1) = MD5(S + R + A) c(1) = p(1) xor b(1)”,其中 S 是共享密钥。 ↩︎BlastRADIUS — CVE-2024-3596;推荐的缓解措施是“to mandate that clients and servers always send and require Message-Authenticator attributes for all requests and responses”。 ↩︎ ↩︎
RFC 3579 — RADIUS Support For EAP — “the Message-Authenticator attribute MUST be used to protect all Access-Request, Access-Challenge, Access-Accept, and Access-Reject packets containing an EAP-Message attribute.” ↩︎
FreeRADIUS 3.2.10 — radiusd.conf —
require_message_authenticator和limit_proxy_state;把两者都设成“no”“will allow MITM attackers to create fake Access-Accept packets to the NAS!” ↩︎RFC 6614 — TLS Encryption for RADIUS — RadSec,2012年5月,实验性。 ↩︎
IETF — RadSec: RADIUS over TLS and DTLS — 预定状态为 Proposed Standard,取代 RFC 6614 和 RFC 7360;2026年10月13日查看时 IESG 状态为“Has enough positions to pass”。 ↩︎
FreeRADIUS 3.2.10 — sites-available/tls — RadSec 监听器,
require_client_cert,proto = tls,以及“TLS clients MUST have the shared secret set to “radsec””。 ↩︎hostapd 2.11 source —
hostapd/defconfig:“Include support fo RADIUS/TLS into the RADIUS client”,#CONFIG_RADIUS_TLS=y。 ↩︎TP-Link — Omada Software Controller 6.1 release note — “Added support for RadSec (RADIUS over TLS) to secure SSID, MAC-Based, and 802.1X authentications on both APs and Switches”,需要最新的 AP 和交换机固件。 ↩︎ ↩︎
TP-Link Omada — 802.1X configuration — RADIUS Proxy:“It does not support the RadSec feature”;用 RadSec 时“it is recommended to disable Require Message-Authenticator”。 ↩︎
Netgear — M4250 and M4350 CLI manual —
radius server key:“The secret must be an alphanumeric value not exceeding 16 characters”;没有提到 RadSec。 ↩︎Netgear — WAX630 user manual — “Enter the number of the UDP port on the access point that is used to access the RADIUS server”,以及“By default, the password is sharedsecret.” ↩︎ ↩︎ ↩︎ ↩︎ ↩︎
radsecproxy — “made to be able to deploy RadSec (RADIUS over TLS) so that all RADIUS communication across network links could be done using TLS, without modifying existing RADIUS software”。这里用 1.11.2 测试过。 ↩︎
RFC 9765 — RADIUS/1.1 — 2025年4月,实验性:“the RADIUS shared secret is no longer used, and all MD5-based packet authentication and attribute obfuscation methods are removed.” ↩︎
FreeRADIUS 3.2.10 — ChangeLog — RADIUS/1.1“Disabled by default, can be enabled by passing
--with-radiusv11to the configure script. For now, this is for testing interoperability.” ↩︎Netgear — M4250 user manual — VLAN Assignment Mode,“The default is Disable”;Dynamic VLAN Creation Mode;Authentication Order,“if a client tries 802.1X authentication (based on the user and client credentials) and authentication fails, the interface proceeds with MAB authentication.” M4350 手册里是同样的文字。 ↩︎ ↩︎ ↩︎ ↩︎ ↩︎
TP-Link Omada — Dynamic VLAN with the VLAN Assignment function of RADIUS — 交换机:Authentication Type“Port Based”,“enable ‘VLAN Assignment’”,“make sure the 802.1X Control mode is Auto”;接入点:RADIUS profile 里的“Enable VLAN Assignment for Wireless Network”。 ↩︎ ↩︎ ↩︎ ↩︎ ↩︎
TP-Link — Configuration guide for 802.1X VLAN assignment and MAB — “VLAN Assignment takes effect only when the control type is Port Based”;缺失的 VLAN 会自动创建;MAB 发送的 MAC 格式为“12 hexadecimal digits, all lowercase and no punctuation”。 ↩︎ ↩︎ ↩︎ ↩︎
Netgear — GS710TUP user manual — 基于 MAC 的端口控制“allows multiple supplicants connected to the same port”。 ↩︎
hostapd — hostapd.conf — 动态 VLAN“parsed from following RADIUS attributes based on RFC 3580 and RFC 2868”;
dynamic_vlan“2 = required; reject authentication if RADIUS server does not include VLAN ID”;vlan_tagged_interface和vlan_bridge。读自 hostapd 2.11 软件包。 ↩︎Netgear — WAX620 user manual — WPA3 Enterprise:“the encryption is automatically set to GCMP256”。 ↩︎
Pixel Phone Help — Connect to Wi-Fi networks — “The ‘Do not validate’ setting option used in EAP-PEAP, EAP-TLS and EAP-TTLS configurations has been removed for security reasons.” ↩︎ ↩︎
Apple — WiFi.EAPClientConfiguration —
TLSTrustedServerNames,“If a server presents a certificate that isn’t in this list, the system doesn’t trust it”;TLSMaximumVersion默认为1.2。 ↩︎ ↩︎ ↩︎NetworkManager — 802-1x settings —
domain-match:“Constraint for server domain name”,另有ca-cert、client-cert、private-key和phase1-auth-flags。 ↩︎Android Developers — WifiEnterpriseConfig —
setDomainSuffixMatch;TLS_V1_3“Added in API level 34”,WifiManager.isTlsV13Supported()说明“whether or not TLS v1.3 is supported”。 ↩︎ ↩︎RFC 2716 — PPP EAP TLS Authentication Protocol — 最初的 EAP-TLS 规范,1999年10月,后被 RFC 5216 取代。 ↩︎
Cisco — ISE licences — Essentials 涵盖“RADIUS authentication, authorization, and accounting, including 802.1X, MAC authentication bypass and easy connect”;“Concurrent active endpoints refer to the total number of supported users and devices… printers, fax machines, or other types of network devices.” ↩︎
NCSC — About Cyber Essentials — “A growing number of organisations require suppliers to be certified to bid for work”;它防范的是“the most common internet based cyber security threats”。 ↩︎ ↩︎
NCSC — Cyber Essentials: Requirements for IT Infrastructure v3.3 — 2026年4月。无法从互联网攻击的无线设备不在范围内:“the Cyber Essentials scheme isn’t concerned with attacks that can only be launched within the signal range of the wireless device”;五项技术控制;“change any default or guessable account passwords”;sub-set“is part of the organisation whose network is segregated from the rest of the organisation by a firewall or VLAN”。 ↩︎ ↩︎ ↩︎ ↩︎