FUXA 安全策略解读:漏洞报告边界、安全模型与部署加固实践指南

原创2026-10-02 18:01:531,844 阅读
文章标签:工业制造物联网数据可视化后端前端桌面应用

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。

报告的期望流程如下:

  1. 发送邮件说明漏洞详情;
  2. 维护者会尽快确认收到报告并展开调查;
  3. 通过负责任披露(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_auth Cookie(见 server/api/auth/index.js)。

此外,server/test/authorization 目录还包含 roleDeletionSecurity.test.js(角色删除安全)、settingsDisclosure.test.js(设置信息泄露)、socketResponseScopeSecurity.test.js(WebSocket 响应越权)等测试,共同构成了与策略"非预期访问/权限提升/数据泄露"关注点一一对应的验证体系。

部署加固清单

综合策略文件与源码实现,生产环境建议:

  1. 设置 secureEnabled: true 并配置持久化高强度 secretCode;
  2. 按访问时长设置 tokenExpiresIn,必要时开启 enableRefreshCookieAuth;
  3. 立即修改默认管理员 admin/123456 密码;
  4. 通过 allowedOrigins 收紧 CORS 白名单(默认允许本地与内网段,见 server/settings.default.js);
  5. 在可信环境之外,不要关闭认证或把 secureEnabled 置为 false;
  6. 保持升级到最新稳定版以获取安全修复;
  7. 如使用 Node-RED 集成,确认 nodeRedAuthMode: "secure" 且 nodeRedUnsafeModules: false(见 server/settings.default.js);
  8. 若发现漏洞,通过邮件 dev@frangoteam.org 私下报告,不公开发布 issue。

以上实践与官方策略保持一致:FUXA 的安全能力以"受信环境 + 管理员正确配置"为前提,任何关闭安全开关的行为都超出漏洞报告范围。

登录后查看全文
FUXA