FUXA 安全策略解读:漏洞报告边界、安全模型与部署加固实践指南
FUXA 安全策略解读:漏洞报告边界、安全模型与部署加固实践指南
FUXA 是一款基于 Web 的工业过程可视化(SCADA/HMI/Dashboard)软件,其官方安全策略(SECURITY.md)明确了漏洞报告渠道、安全审查范围、不受支持的安全场景以及版本支持政策。本文以该策略文件为骨架,结合仓库内认证中间件、速率限制、刷新令牌与安全测试等源码实现,帮助你理解 FUXA 的安全模型,并掌握从"启用安全模式"到"漏洞报告"的完整实操路径。
安全模型与适用范围(Scope)
FUXA 定位为运行在**受信环境(trusted environments)**中的工业 SCADA/HMI 平台,该环境由系统管理员负责管理。这一前提决定了它的安全边界:
- 平台刻意提供的功能不算漏洞:服务端脚本(server-side scripting)、自动化逻辑(automation logic)、设备集成(device integrations)等属于平台的预期能力,只要按设计用途使用,就不属于安全漏洞。
- 安全报告应聚焦四类问题:非预期访问(unintended access)、权限提升(privilege escalation)、认证绕过(authentication bypass)和数据泄露(data exposure)。
因此,在向 FUXA 提交安全报告前,请先判断问题是否落在上述四类范围内,避免将"功能设计差异"误报为安全漏洞。
漏洞报告流程(Reporting a Vulnerability)
官方策略规定:发现 FUXA 安全漏洞后,请私下通过邮件报告至 dev@frangoteam.org,不要为安全漏洞公开发布 GitHub issue。
报告的期望流程如下:
- 发送邮件说明漏洞详情;
- 维护者会尽快确认收到报告并展开调查;
- 通过负责任披露(responsible disclosure)机制,在漏洞公开前先完成修复。
仓库中与认证、授权相关的安全修复均伴随回归测试,例如 server/test/authorization 目录下的
jwtLifecycleSecurity.test.js、roleDeletionSecurity.test.js、rateLimiterOrderSecurity.test.js等,可作为验证漏洞是否已被修复的参考。
支持版本与安全更新(Supported Versions & Security Updates)
- 只有最新稳定版(latest stable release)会收到安全更新。报告漏洞前,请先确认问题在最新版本中仍然存在。
- 安全修复会随常规版本发布一起放出,适当时会在 release notes 中说明。
这意味着:升级到最新稳定版是获取安全修复的唯一渠道,生产环境应保持版本更新节奏。
明确不受支持的安全场景(Out of Scope)
以下配置被判定为"设计上不安全(insecure by design)",不在漏洞受理范围内:
secureEnabled=false的部署;- 有意禁用认证与授权的部署;
- 需要管理员显式关闭安全特性的场景;
- 在关闭安全功能后访问"被刻意暴露的功能"的报告。
策略特别说明:当 secureEnabled=false 时,FUXA 运行在仅适用于受信环境的非安全模式,该模式下因缺少认证或授权而产生的行为不视为安全漏洞。
安全加固实践:从启用 secureEnabled 开始
FUXA 的安全模式默认关闭,需要管理员在服务端配置中显式开启。官方文档 docs/Settings.md 给出了最小配置:
secureEnabled: true, // enable or disable
secretCode: '<strong-random-secret>', // secret code to encode the token
tokenExpiresIn: '1h' // '1h'=1hour, 60=60seconds, '1d'=1day
完整的安全相关配置项位于 server/settings.default.js,除上述三项外还包括:
| 配置项 | 说明 | 示例 / 默认值 |
|---|---|---|
secureEnabled |
总开关,启用认证与授权 | true(默认注释关闭) |
secretCode |
JWT 签名密钥 | 强烈建议设置高强度随机串 |
tokenExpiresIn |
访问令牌有效期 | '1h'、60、'1d' |
enableRefreshCookieAuth |
使用 HttpOnly 刷新 Cookie 流程 | false |
refreshTokenExpiresIn |
刷新令牌有效期 | '7d'、'12h'、3600 |
apiRateLimitWindowMs / apiRateLimitMax |
普通 API 限流窗口与上限 | 5 * 60 * 1000 / 1000 |
authRateLimitWindowMs / authRateLimitMax |
登录/刷新接口限流窗口与上限 | 5 * 60 * 1000 / 100 |
allowedOrigins |
CORS 允许来源白名单 | 默认 localhost / 127.0.0.1 / 192.168.* / 10.* |
apiMaxLength |
HTTP 请求体最大体积 | 默认 100mb |
关于密钥生成的自动兜底
若 secureEnabled=true 但未提供 secretCode,服务端会自动生成随机 JWT 密钥并在日志中告警。对应实现位于 server/api/index.js:
if (req.body.secureEnabled && !req.body.secretCode) {
req.body.secretCode = utils.generateSecretCode();
runtime.logger.warn('Generated random JWT secret because secureEnabled=true and no secretCode was provided.');
}
自动生成的密钥可以保证"启用即安全",但重启后密钥不持久会导致令牌失效,生产环境务必显式配置持久化的强密钥。
默认管理员账号
FUXA 默认提供用户 admin,初始密码为 123456(见 docs/Settings.md)。启用安全模式后,应立即修改默认密码。
认证链路源码解析:JWT、Guest 与刷新令牌
令牌签发与校验
服务端使用 jsonwebtoken 签发 JWT,核心实现在 server/api/auth/index.js 与 server/api/jwt-helper.js:
- 登录成功后将
{ id: username, groups: user.groups }签入访问令牌(buildAccessToken),密码使用bcryptjs做比对(bcrypt.compareSync,见 server/api/auth/index.js); - 中间件
verifyToken从x-access-token请求头取令牌,校验失败时降级为 guest(见 server/api/jwt-helper.js); - 管理员组判定
adminGroups = <a href="https://link.gitcode.com/i/1d68fc7cfcffeaaeac49f1197e5c2ff5" target="_blank">-1, 255],通过haveAdminPermission复用(见 [server/api/jwt-helper.js)。
刷新令牌(HttpOnly Cookie)流程
当 enableRefreshCookieAuth=true 时,登录会额外签发刷新令牌并写入名为 fuxa_refresh 的 HttpOnly Cookie(见 server/api/auth/index.js):
const options = {
httpOnly: true,
sameSite: 'lax',
secure: !!runtime?.settings?.https,
path: BASE_PATH + '/api/refresh'
};
刷新接口 POST /api/refresh 仅在 secureEnabled=true && enableRefreshCookieAuth=true 时生效,且会重新读取数据库中当前用户的 groups 再签发新令牌——这意味着管理员降权(demotion)后,其旧令牌会立即失去旧权限(见 server/api/auth/index.js)。
心跳续期
前端心跳接口同样具备令牌续期能力:携带旧令牌调用 /api/heartbeat 时,若用户仍存在,会按当前存储的 groups 重签令牌(见 server/api/index.js)。
登录接口与 API 的速率限制
为防止暴力破解,服务端为登录/刷新接口与普通 API 分别设置了速率限制(见 server/api/index.js):
- 认证接口:5 分钟窗口内最多
100次; - 普通 API:5 分钟窗口内最多
1000次(官方注释说明该值刻意放宽,以兼容同一代理/NAT 后的 HMI/SCADA 客户端)。
对应的安全回归测试见 server/test/authorization/rateLimiterOrderSecurity.test.js。
安全测试证据:策略如何被验证
仓库中的安全测试覆盖了策略文件中提到的关键关注点,最有代表性的是 server/test/authorization/jwtLifecycleSecurity.test.js:
- 登录失败响应不泄露用户是否存在:未知用户名与错误密码返回完全相同的 401 响应体,防止用户枚举;
- 已删除用户的刷新令牌被拒绝:即使刷新令牌仍有效,若用户已被删除则返回 401,避免"死账户"持续使用旧权限;
- 降权后令牌权限立即回收:刷新令牌携带的旧
groups不被信任,新令牌始终以数据库当前 groups 签发; - 用户接口不泄露密码哈希:
/api/users响应中不包含password字段; - 登出清理 Node-RED 认证 Cookie:
POST /api/signout会同时清除nodered_authCookie(见 server/api/auth/index.js)。
此外,server/test/authorization 目录还包含 roleDeletionSecurity.test.js(角色删除安全)、settingsDisclosure.test.js(设置信息泄露)、socketResponseScopeSecurity.test.js(WebSocket 响应越权)等测试,共同构成了与策略"非预期访问/权限提升/数据泄露"关注点一一对应的验证体系。
部署加固清单
综合策略文件与源码实现,生产环境建议:
- 设置
secureEnabled: true并配置持久化高强度secretCode; - 按访问时长设置
tokenExpiresIn,必要时开启enableRefreshCookieAuth; - 立即修改默认管理员
admin/123456密码; - 通过
allowedOrigins收紧 CORS 白名单(默认允许本地与内网段,见 server/settings.default.js); - 在可信环境之外,不要关闭认证或把
secureEnabled置为false; - 保持升级到最新稳定版以获取安全修复;
- 如使用 Node-RED 集成,确认
nodeRedAuthMode: "secure"且nodeRedUnsafeModules: false(见 server/settings.default.js); - 若发现漏洞,通过邮件
dev@frangoteam.org私下报告,不公开发布 issue。
以上实践与官方策略保持一致:FUXA 的安全能力以"受信环境 + 管理员正确配置"为前提,任何关闭安全开关的行为都超出漏洞报告范围。