全屋共用一个密码

WiFi 密码由每一个曾经连上来的东西共享。笔记本、手机、电视、装上之后固件就再没人更新过的门铃摄像头、圣诞节时拿到密码的客人,以及那位客人此后用过的每一部手机。它们全都在同一个网络上。每一个都能和其他每一个说话。

按通常的办法把它拆开,意味着更多的 SSID。员工一个,IoT 一个,访客一个,各有各的密码和各自的 VLAN。能用。然后某个密码泄露了,你就得拿着新密码挨个去改那个 SSID 上的每一台设备,而这恰恰是永远没人去干的活儿。

空着的有线端口更糟。连密码都没有。插上就进了那个端口被设成的 VLAN。

带证书的 802.1X 把这一切倒了过来。每台设备带着自己的证书,在任何一个数据包通过之前先证明自己是什么,然后由网络来决定它去哪里,不是设备,也不是那个发密码的人。一个 SSID。每个交换机端口都一样。笔记本落在员工 VLAN,摄像头落在 IoT VLAN,而你从没签发过证书的设备哪儿也去不了。

一个共享密码每个 VLAN 一个 SSID802.1X,一个 SSID
谁能进来任何知道密码的人任何知道那个 SSID 密码的人只有持有你签发的证书的设备
进哪个 VLAN全在一个里取决于连的是哪个 SSIDRADIUS 服务器给那台设备说的那个
拦住一台丢失的设备到处改密码到处改那个 SSID 的密码吊销一张证书
有线端口敞开敞开和 WiFi 一样的检查
要广播的 SSID1每个 VLAN 一个1

这就是本文要搭的东西。step-ca 签发证书并把每台设备的角色写进去,FreeRADIUS 对照 CA 及其吊销列表检查每张证书,从中读出角色并回答一个 VLAN,交换机或接入点再把设备放到它被告知的地方。设备用的是 Netgear 或 TP-Link,能用 TLS 的地方就通过 TLS 和 FreeRADIUS 通信。在碰任何真实设备之前,这一切都在这里跑过一遍:CA 和 RADIUS 服务器在容器里,交换机端口和 WiFi 网络在模拟器里。

四个部分,只有一个说了算

802.1X 定义了三个角色1。请求方(supplicant)是要求加入的设备。认证方(authenticator)是交换机端口或接入点。认证服务器就是 RADIUS。再加上签发证书的 CA,这就是整个系统。

802.1X 登录中谁做什么设备请求方交换机或 AP认证方只转发,不做决定FreeRADIUS挑选 VLANstep-ca证书和 CRLEAP-TLS端口打开RadSecVLAN 10CRL, HTTPS证书,只签发一次
交换机或 AP 只负责转发。EAP 从设备出发,先装在 EAPOL 里,再装在 RADIUS 里到达 FreeRADIUS,答复带着放在三个属性里的 VLAN 回来。step-ca 从不经手任何一次登录;它事先签好了证书,并发布吊销列表。

交换机和 AP 什么都不决定。它们只转发。在设备通过认证之前,端口只放行 EAP,别的一概不放。认证方把 EAP 包进 RADIUS,发给服务器,然后照答复办事。Access-Accept 打开端口。如果 Accept 带着隧道属性,端口或 WiFi 客户端就进入它们指定的 VLAN。RFC 3580 规定了是哪三个属性,借用自 RADIUS 的隧道属性23:

属性值含义
Tunnel-TypeVLAN (13)这个隧道是一个 VLAN
Tunnel-Medium-TypeIEEE-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 明文可见
身份 laptop11.2是是
身份 laptop11.3是,在身份字段里否
身份 anonymous1.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.exampleadmin24 小时,每天续期服务器和客户端设备检查的那个名字
laptop1network1 年仅客户端OU=staff
cam1network1 年仅客户端OU=iot
tv1network1 年仅客户端OU=media
switch1、ap1nas1 年仅客户端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 服务器。所以策略把不是为这件事做的证书统统扔出去:没有客户端认证用途,或者没有角色,就拒绝。

FreeRADIUS 如何挑选 VLANTLS 1.3 握手,CRL有客户端认证用途?在设备清单上?证书里有角色?没有角色:拒绝拒绝清单优先:cam1,VLAN 99staff, 10iot, 20media, 30是no无no是
先问按设备的清单,它有答案就以它为准。否则由证书里的角色挑选 VLAN。两者都没有的证书被拒绝,正是这一点挡住了 CA 的 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角色里面放什么
10staff你信任的笔记本和手机
20iot摄像头、传感器,任何会往外打电话回家的东西
30media电视和流媒体盒子
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
laptop1staff否Accept10
cam1iot99Accept99
tv1media否Accept30
laptop2staff,已吊销否Reject,certificate revoked无
radius.home.example无否Reject,没有角色无
laptop1,没打开 TLS 1.3staff否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-AuthenticatorRadSec,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 来调试。

保护到 FreeRADIUS 的每一跳FreeRADIUS端口 2083只认 OU=nasOmada, hostapd内置 RadSecRadSec, TLS 1.3Netgear只有 UDPradsecproxy同一管理 VLANUDP+ Msg-AuthRadSecstep-ca签发所有证书CRL 走 HTTPS,钉住根证书
每一跳在哪里受保护。会说 RadSec 的设备通过 TLS 1.3 直连 FreeRADIUS。只会说 UDP 的设备和同一管理 VLAN 上的 radsecproxy 对话,只有那一小段是普通 RADIUS。CRL 通过钉住根证书的 HTTPS 从 step-ca 取得。

前面那个模拟交换机端口,改成用 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 是它的下一步。

每台值得买的网管交换机都支持带动态 VLAN 的 802.1X,不管铭牌上写的是什么,设置归结起来都是同样五件事。这两家的区别在细节上,而 TP-Link 那边有一个细节会改变你给一张办公桌布线的方式。

设置Netgear M4250 和 M4350TP-Link Omada 交换机
RADIUS 服务器Security > Management Security > RADIUS > Server Configuration27Omada 控制器里的一个 RADIUS Profile28
打开 802.1XSecurity > Port Authentication > Basic > 802.1X Configuration:Dot1x Admin Mode、Authentication Admin Mode27Authentication > 802.1X,Authentication Type 选“Port Based”28
由 RADIUS 分配 VLANVLAN 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 设为 Auto802.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 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 请求清单条目答复
aabbccddeeff20Accept,VLAN 20
112233445566无Reject
ccddeeff001110,员工 VLANReject。不管清单怎么写,策略都不会把一个 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)
一个 SSID,三个 VLANlaptop1OU=staffcam1在清单上tv1OU=media接入点SSID "Home"VLAN 10,密钥 AVLAN 99,密钥 BVLAN 30,密钥 C交换机trunk 端口10、30、99 带标签一根网线
一个 SSID,三台设备,三个 VLAN。AP 把每个客户端放到它自己的 VLAN 接口上,配各自的组密钥,三者都经由一条带标签的 trunk 送上去。给 AP 供网的交换机端口必须承载 RADIUS 可能指定的每一个 VLAN。
站点证书VLAN网桥它自己的网关电视的 VLAN
laptop1OU=staff10brvlan10可达无响应
cam1OU=iot,在清单上99brvlan99可达
tv1OU=media30brvlan30可达

组密钥那几行是大家容易漏看的部分。WiFi 上的广播和组播帧用一个全网共享的组密钥加密,如果三个 VLAN 共用一个,那么不管交换机怎么想,摄像头都能从空中读到笔记本的广播。hostapd 为每个 VLAN 保留一个独立的组密钥,日志显示它为每个 VLAN 各启动了一个。同样的测试改用 WPA3-Enterprise,即强制管理帧保护的 WPA-EAP-SHA256,得到的是同样三个 VLAN 和同样三个组密钥。

设置Netgear WAX 和 WBETP-Link Omada EAP
安全WPA2 Enterprise 或 WPA3 EnterpriseWPA2-Enterprise 或 WPA3-Enterprise,包括一个只用 CCMP-128 的模式
由 RADIUS 分配 VLANDynamic 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、iPadOSAndroid
证书和私钥802-1x.client-cert、802-1x.private-key配置描述文件里的 Identity 载荷作为 Wi-Fi 证书安装
根证书802-1x.ca-certCertificate 载荷,通过 PayloadCertificateAnchorUUID 信任34CA 证书字段
服务器名802-1x.domain-match35TLSTrustedServerNames34域名字段;API 里是 setDomainSuffixMatch36
TLS 1.3802-1x.phase1-auth-flags tls-1-3-enableTLSMinimumVersion 和 TLSMaximumVersion 设为 "1.3";最大值默认是 "1.2"34setMinimumTlsVersion(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.example192.0.2.10FreeRADIUS,RadSec 在 2083
radsecproxy192.0.2.11radsecproxy,UDP 进,RadSec 出
switch1、ap1192.0.2.21、192.0.2.31会说 RadSec 的设备
只会 UDP 的设备192.0.2.32 到 .63经由 radsecproxy;下面的 Linux AP 是 .33 上的 ap2
文件放到作用
step-ca/templates/device.tplCA 里的 /home/step/templates/把角色写进 OU,仅客户端认证
step-ca/templates/nas.tplCA 里的 /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/eapRADDB/mods-available/EAP-TLS,TLS 1.3,检查 CRL
freeradius/mods-available/device_vlanRADDB/mods-available/读按设备的清单
freeradius/mods-available/mab_vlanRADDB/mods-available/读 MAB 清单
freeradius/mods-config/device_vlan/devicesRADDB/mods-config/device_vlan/证书名对应 VLAN
freeradius/mods-config/device_vlan/mabRADDB/mods-config/device_vlan/MAC 地址对应 VLAN
freeradius/policy.d/vlanRADDB/policy.d/为证书挑选 VLAN
freeradius/policy.d/mabRADDB/policy.d/为 MAC 挑选 VLAN,只限 20 或 99
freeradius/sites-available/default.patch打到 RADDB 上调用两个策略
freeradius/sites-available/tlsRADDB/sites-available/RadSec 监听器及其客户端
freeradius/nas-only.shRADDB/只放行 OU=nas 证书
freeradius/clients.confRADDB/在本机上测试用的 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.confUDP 进,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 13Fedora
FreeRADIUS3.2.103.2.73.2.8
RADDB/etc/freeradius/etc/freeradius/3.0/etc/raddb
运行用户freeradfreeradradiusd
服务容器本身freeradiusradiusd
测试过本文的全部内容install.sh 和 -XCinstall.sh 和 -XC

两个 systemd 单元写的是 /etc/freeradius 和 freeradius 服务。在 Debian 或 Fedora 上,按上表把两者都改掉。别的都不用动。

step-ca

设备模板就是把角色写进证书里的那个,一行不差,只在顶上加了一段注释。nas 模板是同样的思路,只是角色写死了:

step-ca/templates/nas.tpl

{{- /* 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:

step-ca/setup.sh

#!/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:

step-ca/issue.sh

#!/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。它把文件复制进去,给默认站点打补丁,再建好链接。它就干这些:

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 替换原装的那个。全文如下:

freeradius/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) 外壳:

freeradius/policy.d/vlan

#  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 或经由代理进来:

freeradius/clients.conf

#  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,所以一次失败的拉取会把旧名单留在原地。它绝不会拿垃圾换掉一份好名单:

systemd/radius-crl-refresh

#!/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/radsecproxy.conf

# 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。模拟端口跑的就是这个文件:

hostapd/hostapd-wired.conf

# 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,模拟无线电跑的就是这个文件:

hostapd/hostapd-wifi.conf

# 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-caCRL 安装并做了哈希;已吊销的笔记本五分钟内被拒,无需重启
radius-cert-renew.servicestep ca renew 0.30.2证书已续期;私钥和权限都没动
radsecproxy.confradsecproxy 1.11.2经由它的 EAP-TLS 被接受;带 Message-Authenticator 的 MAB 进 VLAN 20,不带的被丢弃
hostapd-wired.confhostapd 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.confeapol_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.3protocol 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 socketsfreeradius -fxx -l stdout
hostapd 编译时没带 RadSecunsupported 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,在日记本上记着日期的证书,买之前先测过的设备。这就是代价,而且方向是对的:你付出的是看得见的力气,而不是一个多年来一直悄悄放人进来的密码。


  1. RFC 3748 — Extensible Authentication Protocol (EAP) — EAP,以及它在其间运行的对端、认证方和认证服务器这几个角色。 ↩︎

  2. RFC 2868 — RADIUS Attributes for Tunnel Protocol Support — 定义了 RFC 3580 拿来复用于 VLAN 的隧道属性。 ↩︎

  3. 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”。 ↩︎ ↩︎ ↩︎

  4. 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.” ↩︎

  5. RFC 5216 — The EAP-TLS Authentication Protocol — 基于 EAP 的双向证书认证。 ↩︎

  6. 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。 ↩︎ ↩︎

  7. 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”。 ↩︎ ↩︎ ↩︎

  8. Smallstep — Certificate templates — 用 --set 传入的用户数据在模板里是 .Insecure.User;值一律用 toJson 包起来。 ↩︎

  9. FreeRADIUS 3.2.10 — dictionary.freeradius.internal — 策略读取的 TLS-Client-Cert-* 属性,包括 TLS-Client-Cert-Subject 和 TLS-Client-Cert-X509v3-Extended-Key-Usage-OID。 ↩︎

  10. FreeRADIUS 3.2.10 — mods-available/passwd — “Attributes marked as ‘=’ are added to reply_items instead of default configure_items”。 ↩︎

  11. wpa_supplicant — wpa_supplicant.conf — “tls_disable_tlsv1_3=0 - enable TLSv1.3 (experimental - disabled by default)”,以及 domain_match,即“Constraint for server domain name”。 ↩︎

  12. 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 是共享密钥。 ↩︎

  13. BlastRADIUS — CVE-2024-3596;推荐的缓解措施是“to mandate that clients and servers always send and require Message-Authenticator attributes for all requests and responses”。 ↩︎ ↩︎

  14. 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.” ↩︎

  15. 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!” ↩︎

  16. RFC 6614 — TLS Encryption for RADIUS — RadSec,2012年5月,实验性。 ↩︎

  17. IETF — RadSec: RADIUS over TLS and DTLS — 预定状态为 Proposed Standard,取代 RFC 6614 和 RFC 7360;2026年10月13日查看时 IESG 状态为“Has enough positions to pass”。 ↩︎

  18. FreeRADIUS 3.2.10 — sites-available/tls — RadSec 监听器,require_client_cert,proto = tls,以及“TLS clients MUST have the shared secret set to “radsec””。 ↩︎

  19. hostapd 2.11 source — hostapd/defconfig:“Include support fo RADIUS/TLS into the RADIUS client”,#CONFIG_RADIUS_TLS=y。 ↩︎

  20. 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 和交换机固件。 ↩︎ ↩︎

  21. TP-Link Omada — 802.1X configuration — RADIUS Proxy:“It does not support the RadSec feature”;用 RadSec 时“it is recommended to disable Require Message-Authenticator”。 ↩︎

  22. Netgear — M4250 and M4350 CLI manual — radius server key:“The secret must be an alphanumeric value not exceeding 16 characters”;没有提到 RadSec。 ↩︎

  23. 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.” ↩︎ ↩︎ ↩︎ ↩︎ ↩︎

  24. 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 测试过。 ↩︎

  25. 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.” ↩︎

  26. FreeRADIUS 3.2.10 — ChangeLog — RADIUS/1.1“Disabled by default, can be enabled by passing --with-radiusv11 to the configure script. For now, this is for testing interoperability.” ↩︎

  27. 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 手册里是同样的文字。 ↩︎ ↩︎ ↩︎ ↩︎ ↩︎

  28. 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”。 ↩︎ ↩︎ ↩︎ ↩︎ ↩︎

  29. 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”。 ↩︎ ↩︎ ↩︎ ↩︎

  30. Netgear — GS710TUP user manual — 基于 MAC 的端口控制“allows multiple supplicants connected to the same port”。 ↩︎

  31. 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 软件包。 ↩︎

  32. Netgear — WAX620 user manual — WPA3 Enterprise:“the encryption is automatically set to GCMP256”。 ↩︎

  33. 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.” ↩︎ ↩︎

  34. 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。 ↩︎ ↩︎ ↩︎

  35. NetworkManager — 802-1x settings — domain-match:“Constraint for server domain name”,另有 ca-cert、client-cert、private-key 和 phase1-auth-flags。 ↩︎

  36. Android Developers — WifiEnterpriseConfig — setDomainSuffixMatch;TLS_V1_3“Added in API level 34”,WifiManager.isTlsV13Supported() 说明“whether or not TLS v1.3 is supported”。 ↩︎ ↩︎

  37. RFC 2716 — PPP EAP TLS Authentication Protocol — 最初的 EAP-TLS 规范,1999年10月,后被 RFC 5216 取代。 ↩︎

  38. 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.” ↩︎

  39. 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”。 ↩︎ ↩︎

  40. 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”。 ↩︎ ↩︎ ↩︎ ↩︎