安全基线
下面这些措施默认开启,每一项都有对应的测试或自动检查。完整的威胁防护清单和测试见仓库的安全文档。
认证与会话
- 不使用 JWT。访问令牌和刷新令牌都是随机字符串,Redis 中只保存它们的哈希值;
- 访问令牌默认 30 分钟,活跃时自动续期,但不会超过绝对上限(12 小时;勾选"保持登录"或在手机端登录时为 7 天。这两个上限是固定的,不能配置);
- 刷新令牌存放在
HttpOnly+SameSite=Strict的 cookie 中,每次使用后都会更换。旧令牌被重复使用时,会吊销整个会话链; - 刷新接口和会写入这个 cookie 的密码登录、短信登录都核对请求来源(
Origin):来自别的网站或来源为null时返回 403,防止别的网站把它自己的账号登录进你的浏览器(登录 CSRF)。反向代理要把Host和协议原样转给服务端,或者把控制台的地址写进CORS_ORIGIN,见部署 · 反向代理; - 管理员重置密码、停用或删除用户,以及用短信找回密码时,该用户的所有会话都会失效;本人修改密码时,其他会话全部失效,只保留当前这一个;强制下线只结束被强退的会话(用"强退该用户"时结束这个用户的全部会话)。被结束的会话的 WebSocket 连接也会立即断开;
- 本人修改密码、短信找回密码、管理员重置密码时,还会解除这个账号的微信小程序绑定。这样即使有人曾用泄露的密码绑定了自己的微信,改密后也登录不了了。强制下线不会解绑。
登录防护
- 限流:按 IP 和按用户名分别计数。按 IP 的计数存在 Redis 里,部署多个服务实例时共用同一份额度;Redis 暂时出错时请求直接失败(返回 500),不会放行(见部署 · 多实例部署);
- 同一个"用户名 + IP"连续失败 5 次会锁定 10 分钟。只锁这一对组合,所以别人无法借此把管理员账号锁死;
- 同一个用户名在多个 IP 上累计失败过多后,强制要求验证码;
- 不存在的用户名同样会计数,响应内容和耗时都与存在的用户名一致,无法借此探测账号是否存在;登录名必须符合账号的保存格式(全角先转成半角),其他写法返回 400,不会落到另一个计数上而暴露账号是否存在;
- 同时发出的多个密码尝试先计数、再校验密码,所以最多只有锁定阈值那么多次能走到密码校验,见仓库的安全文档;
- 支持 IP 黑名单(单个地址或 CIDR 网段,不支持
*通配,写错的条目会被忽略)、首次登录强制改密、密码过期、密码复杂度策略(前后端使用同一套规则)。
微信小程序登录
功能介绍和启用步骤见登录与账号 · 微信小程序登录。这里只列安全规则:
- 默认关闭。开关
auth.wx_mp.enabled没打开,或者缺少WX_MP_APPID/WX_MP_SECRET时,登录和绑定接口都返回 404; - 小程序传来的
code只能用一次;微信返回的session_key服务端收到后直接丢弃,既不保存,也不发给客户端; - 还没绑定的微信账号会拿到一张绑定票据:5 分钟内有效,只能用一次,只能从同一个 IP 使用;
- 绑定时要用账号密码或短信验证码证明身份,验证码、失败锁定和限流规则和普通登录一样。同一个微信账号不能绑定两次(返回 409),一个账号也只能绑定一个微信;
- 解绑不受开关限制,并且会让本人在其他手机上的登录全部失效(当前这台保留);
- 每次微信登录都记在登录日志里,类型是
wx-mp。身份验证通过但绑定被拒时,也会记一条失败的日志。
单点登录(OAuth2)
功能介绍见单点登录(OAuth2),接入细节见 OAuth2 接入指南。这里只列安全规则:
授权码方式必须用 S256 的 PKCE,只支持带密钥的机密客户端;客户端密钥只显示一次,数据库只存 SHA-256 摘要;回调地址逐字比对,请求无效时同意页从不跳转。第三方令牌只能调用用户信息接口;用户改密、被停用或被强退,或客户端被停用时,相关会话一起失效;日志里的密钥、授权码和令牌自动脱敏。规则见仓库的 OAuth2 文档。
越权访问(IDOR)
- 所有按 id 查询、修改、删除的接口,都会先检查这条记录是否在当前用户的数据范围内,超出范围返回 404;
- 防越权授予:不能给别人超过自己的权限,详见权限与数据范围。重置别人的密码、设置别人的登录手机号,要求能分配这个用户的全部角色;移动部门也按授予检查,见防越权授予;
- 流程表单的附件是私有文件:只有能查看这个流程实例、并且能看到这个附件字段的人才能下载,见工作流 · 附件。
- 审批数据按字段权限过滤:只有超级管理员和该流程的流程管理员能看到全部字段,其他人看不到在流程任一节点隐藏过的字段(页面、导出和筛选里都没有)。因为流程管理员能看全部字段,修改流程管理员名单需要单独的权限
wf.model.managers,只有wf.model.modify的人不能把自己加进去(返回 403),见工作流 · 审批数据里的字段权限。
租户隔离
开启多租户后,ORM(把代码里的对象读写翻译成 SQL 的那一层)会给每张租户表的查询、写入和联表自动加上当前租户的条件,超级管理员也跳不过;手写的 SQL 由自动检查要求带上租户条件。访问别的租户的数据,和访问不存在的数据一样返回 404;租户里的人调用平台专属页面的接口会被拒绝。会话属于哪个租户取自用户本身,没有可以切换租户的请求头。平台人员进入租户要有专门的权限,2 小时后自动退出,全程记入审计。测试入口见仓库的安全文档。
注入与代码执行
- 只使用参数化 SQL,排序字段有白名单;有检查脚本禁止把字符串拼接进 SQL;
- 禁止
eval、new Function和vm(由 lint 和脚本检查); - 定时任务只能调用白名单中的处理函数,流程条件只能用结构化规则;
- 表单设计器保存的表单结构会在别人的浏览器里渲染,所以保存时前后端用同一份白名单检查:包含函数、会被当作代码执行的字符串(比如
$FN:)、事件和联动设置、未知组件时直接返回 400,白名单以外的设置被去掉,服务端只保存过滤后的结果,见表单设计器 · 安全; - BPMN 只当作数据:只接受白名单元素,脚本、表达式、监听器、DOCTYPE 和超过 80 KiB 的文件一律拒绝,运行的是服务端从 XML 推出的树,见工作流和仓库的 BPMN 文档;
pnpm ci:local在构建之后扫描前端产物,确认里面没有白名单以外的eval/Function调用,也没有 wangeditor v4 的代码。
XSS
- 富文本在保存时就经过白名单清洗(去掉
style、on*、script和iframe); - 站内信按纯文本处理;邮件预览在沙箱 iframe 中显示;
- 前端页面带严格的内容安全策略(CSP)。
文件上传
- 按文件内容识别真实类型,不相信扩展名;使用扩展名白名单,
html、svg、js永远不允许上传; - 保存时使用随机文件名,防止路径穿越;
- 下载时强制
attachment+nosniff+CSP sandbox; - 私有文件必须通过鉴权接口下载。
SSRF
管理员可以配置的外部地址(S3、SMTP),服务端连接前会先解析 DNS,拒绝内网、本机和云厂商元数据服务的地址,只允许白名单中的端口。
修改 S3 存储配置时,只要改了服务地址(Endpoint)、存储桶或访问密钥 ID 中的任何一项,就必须重新填写访问密钥,否则返回 422,整次修改都不保存。这样,能修改存储配置的人没法把已经保存的密钥带到另一个地址去。
其他
- Excel:导出时,以
=、+、-、@开头的单元格会被转义,防止公式注入;导入时限制文件大小和行数,拒绝包含宏的文件;解析前先统计每个部分解压后的真实大小,谎报大小的文件返回 400,不会耗尽内存,见Excel 导入导出 · 导入限制; - 重复提交:新增类接口在服务端做了防重复提交,3 秒内的重复请求返回 429(写法见防重复提交、限流与锁);
- 敏感数据:密码使用 bcrypt 存储;第三方服务的密钥(比如 S3、SMTP)用 AES-256-GCM 加密后存入数据库;OAuth2 客户端密钥只存 SHA-256 摘要;日志中的密码、令牌等字段自动脱敏;
- 生产环境的密钥检查:
APP_SECRET或SEED_ADMIN_PASSWORD含not-for-production标记时,生产环境的服务和数据库命令拒绝运行。仓库里提交的测试密码都带着这个标记,所以不会被误带到生产环境;它不判断强度,生产密钥要自己生成,见仓库的安全文档; - 智能助手:智能助手按发起人本人的权限、数据范围和租户调用工具,写入从不在无人确认时执行,联网读取和外部 MCP 只连公网地址,模型等服务的密钥加密存库、只写不读,见仓库的后台智能体(智能助手);
- 演示模式:除登录、退出、进入和退出租户等少数操作外,写操作一律返回 403(超级管理员也一样),日志里的访客信息打码,见部署 · 演示模式和仓库的放行清单;
- 供应链:锁定依赖版本;新版本发布满 24 小时才允许安装;依赖的安装脚本需要逐个审核;依赖许可证自动检查;
- 依赖许可与原创性检查:
pnpm verify检查生产依赖的许可(只接受允许列表里的宽松许可,禁用包一律失败)、Web 用到的包必须登记为生产依赖、TypeScript、Vite、Vue、Element Plus 和 Vitest 在整个仓库只用一个版本,并拒绝其他后台项目的标识和冒号分隔的权限串;用模板开发的项目可以自行调整允许列表,见仓库的依赖许可与原创性检查。
报告安全漏洞
不要在公开的问题、讨论或合并请求里写漏洞细节;请用 GitHub 私密漏洞报告提交:源码仓库 → Security → Report a vulnerability。支持版本、响应、披露和范围(包括不要对在线演示做破坏性测试)见安全策略。