FMO SAS 服务器认证服务版本更新说明
SAS(Server Authorizer Service) 是 FMO 服务器侧的接入认证服务:EMQX 把用户的登录信息转发给它,由它完成根证书 → 中间证书 → 用户证书的链验证、目标服务器校验与权限下发。
本文记录 SAS 各版本的变更内容与升级注意事项。升级只替换程序本身,不会改动 config.json,也不会删除 ~/.sas/ 下的 roots、roles、crl、archive 数据。
版本速查
| 版本 | 日期 | 主要变更 |
|---|---|---|
| v1.3.0 | 2026/11/20 | 新增审计指纹:client_attrs 返回根 / 中间 / 用户三级证书指纹与可选 CA 联系邮箱;包含 v1.2.3 全部安全修复 |
| v1.2.3 | 2026/11/20 | 安全修复:熔断归因、依赖漏洞、升级 SHA-256 校验、空 ACL、CRL SSRF、优雅关闭、归档上限 |
| v1.2.2 | 2026/11/20 | 修复 ACL 角色模板升级:补齐历史默认,未改过 ACL 的服务器不再被误判为自定义;super 模板升至 v3 |
| v1.2.1 | 2026/11/20 | 优化安装/升级/卸载脚本与服务配置路径;sas --update 仅提示官方升级命令;新增 sas --version |
| v1.2.0 | 2026/11/19 | 认证安全加固:校验 Root/Intermediate/User 一致性,新增全局限流与登录报文归档,增加 SAFEPROBE 与 deny 规则 |
升级方法
推荐使用官方安装脚本,脚本会自动识别系统平台、下载对应版本并保留现有配置与数据。
Linux / macOS:
curl -fsSL https://bg5esn.com/share/fmo/sas-installer/install.sh -o /tmp/install.sh && sudo bash /tmp/install.sh --upgrade
Windows(管理员 PowerShell):
irm https://bg5esn.com/share/fmo/sas-installer/install.ps1 -OutFile "$env:TEMP\sas-install.ps1"; iex (Get-Content "$env:TEMP\sas-install.ps1" -Raw -Encoding UTF8)
Windows 安装脚本会读取清单中的 win-x64_sha256,下载后校验 SHA-256;缺失或不匹配会立即中止。
手动升级: 读取 https://bg5esn.com/share/fmo/sas.json 中对应平台的下载地址,解压后替换安装目录下的 sas(Windows 为 sas.exe)即可。手动升级不会自动处理服务重启。
升级完成后确认版本:
./sas --version
升级前后检查
- 配置文件与数据保留:
config.json、~/.sas/roots、~/.sas/roles、~/.sas/crl、~/.sas/archive均不受影响。 - 角色文件自动同步:
~/.sas/roles/*.json若仍是官方旧默认,会被升级为当前模板,旧内容保存在同目录的.bak文件中;手工修改过的文件原样保留。 - 空 allow 角色:v1.2.3 起,
all/pub/sub全空的角色会默认拒绝启动。若确实使用只依赖deny的自定义角色,请在config.json中设置"acl": { "allowEmptyAcl": true }。 - HTTP CRL:v1.2.3 起默认只允许 HTTPS 获取 CRL。仍使用
http://CRL 的部署需设置"crl": { "allowInsecure": true },否则 CRL 不再更新(soft)或认证被拒绝(strict)。 - 配置校验:
http.maxPasswordBytes不能大于http.maxBodyBytes;archive.maxRecordBytes必须为0(不限制)或>= 200。 - strict CRL 模式:
crl.mode = "strict"时,升级后首次启动到根 CRL 拉取完成之间会拒绝认证。可先观察日志出现Root CRL updated,或临时切换为soft预热后再切回。 - 服务状态:升级脚本会自动重启服务;如手动替换二进制,请自行重启
fmo-sas服务或计划任务。
v1.3.0:审计指纹与吊销定位
认证成功时,EMQX 的 client_attrs 新增以下字段:
| 字段 | 说明 |
|---|---|
fmo_root_fingerprint |
匹配并通过验证的根 CA 证书指纹 |
fmo_issuer_fingerprint |
签发用户证书的已验证中间 CA 指纹 |
fmo_user_fingerprint |
已验证的用户证书指纹(不是目标服务器证书) |
fmo_ca_contact_email |
可选;优先根证书 issuer.email,其次中间证书 subject.email |
三个指纹均为证书待签名 CBOR 的 SHA-256,以无填充 Base64URL 编码。
用途:
- 审计事件可以精确归属到具体证书,避免同一呼号/UID 多张证书时无法区分;
- 出现异常时,可按根 / 中间 / 用户三级指纹定位证书链;
- 结合 CA 联系邮箱,联系对应 CA 管理员把证书加入 CRL,缩短吊销响应时间。
兼容性:
- 旧 EMQX、旧 FAS 和 FMO 设备不依赖这些字段,会忽略未知属性;
- 认证拒绝时不返回
client_attrs; - 不改变认证结果、ACL 和
expire_at计算; - 邮箱来自已验证的 CA 证书,是否发送通知由审计服务决定。
v1.2.3:安全修复
认证与熔断
- 修正单呼号熔断的归因时机:只有 proof 验证通过且请求
username与证书呼号一致后的失败才计数。重放公开证书包、伪造username、错误serverFingerprint等早期失败不再能定向封禁任意呼号。 is_superuser判断改为大小写不敏感,避免admins[].role = "SUPER"时 ACL 与 superuser 语义分裂。- 修正 Intermediate
pathLen != 0的错误码与日志文案,排障时不再误报为“签名无效”;UID 越界日志打印真实范围。
升级与供应链
- 安装/升级脚本强制 HTTPS,并要求版本清单提供
<rid>_sha256;下载安装包后校验 SHA-256,缺失或不匹配立即中止。Linux 与 Windows 安装脚本均启用该校验。 sas --update --yes下载的脚本改为随机临时文件名、0600 权限、校验 HTTP 状态与 shebang。- 修复
install.sh在if ! function中set -e失效导致回滚不触发的问题;备份失败会在停止服务前中止升级。
ACL 与 CRL
- 启动时拒绝
all/pub/sub全空的角色;确实需要时显式设置acl.allowEmptyAcl=true。 docker-compose.yml显式设置EMQX_AUTHORIZATION__NO_MATCH=deny,不再依赖 EMQX 5.x 默认的allow。- CRL 默认仅允许 HTTPS;拒绝 localhost、私网、loopback、链路本地、组播及 IPv4-mapped IPv6 私网地址,禁止自动重定向,限制 4 MB / 10 秒。
- roots 路径在启动时规范化,带尾斜杠或相对路径不再导致 roles/crl 目录漂移。
稳定性与合规
- 升级
System.Formats.Cbor到10.0.15,修复 CVE-2026-118747;CI 增加依赖漏洞门禁。 - 注册 SIGTERM/SIGINT,停止时等待在途请求后再 flush 归档与日志。
- 全局限流改为滑动窗口;请求体读取超时缩短为 3 秒,并兼容 chunked 请求。
- 归档记录在 summary/minimal/core 后仍超限时继续降级,保证不超过
archive.maxRecordBytes。 - 日志队列改为有界,配置文件改为原子写入并在 Unix 下设置 0600。
升级注意
- 官方
sas.json已包含各平台_sha256;如果手动替换二进制,请自行核对下载文件的 SHA-256。 - 使用
http://CRL 的部署请先设置crl.allowInsecure=true。 - 使用 deny-only 自定义角色的部署请先设置
acl.allowEmptyAcl=true。 - 检查
http.maxPasswordBytes <= http.maxBodyBytes,以及archive.maxRecordBytes为0或>= 200。
v1.2.2:修复 ACL 角色模板升级
现象
管理员从未修改过 ACL,但升级后日志出现:
ACL roles: admin.json was customised (version 0), keeping as-is; builtin version is 2
ACL roles: super.json was customised (version 0), keeping as-is; builtin version is 2
ACL roles: user.json was customised (version 0), keeping as-is; builtin version is 2
原因
~/.sas/roles/*.json 停留在最初版本的官方默认(没有 _version 字段、没有 deny 规则)时,程序没有把这一代默认收录进历史模板,于是误判为“管理员自定义”,既不升级也不会补上新增的 deny 规则。
升级后
v1.2.2 补齐了全部历史默认(包括最初的无 _version 版本),升级后日志会变成:
ACL roles: synced admin.json v0 -> v2 (backup: admin.json.bak)
ACL roles: synced super.json v0 -> v3 (backup: super.json.bak)
ACL roles: synced user.json v0 -> v2 (backup: user.json.bak)
同时补齐 FMO/SAFEPROBE/#、跨 UID 的 FMO/LATE/UID_V1/# 等 deny 规则,并把 FMO/SERVER_INFO 修正为 FMO/SERVER_INFO/#。
确认与回滚
确认生效:查看 ~/.sas/roles/user.json,应出现 "deny" 段和 FMO/SERVER_INFO/#。
回滚:用同目录下的 .bak 覆盖回原文件并重启服务即可。
v1.2.1
- 优化安装、升级、卸载脚本,修正不同系统的服务配置路径处理;
sas --update改为仅提示官方升级命令,不再自行下载;- 新增
sas --version,输出纯版本号,便于脚本比较。
v1.2.0
- 认证安全加固:严格校验 Root / Intermediate / User 三层证书的一致性;
- 新增全局限流与登录报文归档,便于管理员溯源异常登录;
- 内置角色新增
deny规则:禁FMO/SAFEPROBE/#、限制普通用户与管理员跨 UID 访问; - 新增 CRL 可用性状态与
crl.mode = "strict"模式。