CoreFlow 重视安全问题。如果你发现了安全漏洞或安全隐患,请通过本页的私密渠道报告,不要提交公开 Issue、不要在讨论区或社交媒体披露细节。
唯一推荐渠道(私密,仅维护者可见):
https://github.com/yijiu2025/CoreFlow/security/advisories/new
请在报告中尽量包含以下信息:
- 受影响的组件与版本(或 commit SHA)
- 复现步骤 / PoC
- 影响评估(越权?数据泄露?远程执行?)
- 你建议的修复方向(如有)
- 是否希望公开致谢
| 阶段 | 时限 |
|---|---|
| 确认收到报告 | 48 小时内 |
| 完成评估并给出修复计划 | 10 个工作日内 |
| 发布补丁 | 按严重程度尽快,高危优先 |
| 协同披露 | 补丁发布后经双方同意(默认不超过 90 天) |
如果因假期等原因延迟,我们会提前在私密渠道说明。
版本号跟随 git tag(发版规则见 CONTRIBUTING.md)。只有 main 分支的最新版本线接收安全修复,请始终升级到最新 tag 对应的版本再排查问题。
属于范围:
- 认证 / 会话 / OAuth 2.1 实现缺陷(
src/framework/security/auth/、src/api/oauth21/、src/app/oauth21/) - 权限绕过(PBAC /
guard) - 密码学误用、密钥管理缺陷
- 注入类漏洞(SQL / 命令 / 模板等)
- 供应链问题:依赖链中可被本项目利用的漏洞
不属于范围:
- 第三方服务自身的问题(请直接报告给对应厂商)
- 无复现路径的理论问题
- 纯流量型拒绝服务(DoS)
- 社会工程、物理攻击
- 部署环境配置错误(请先对照部署文档自查,这属于使用问题而非漏洞)
- 维护者确认报告并复现问题
- 在私密分支准备修复与补丁版本
- 发布补丁版本,并创建 GitHub Security Advisory(GHSA)
- 经报告者同意后,在公告中致谢(可选)
部署与加固自查可参考:
docs/standards/best-practices/security.md— 后端安全最佳实践(密码哈希 / 防重放 / CSRF / 限频 / 失败锁定 / Cookie / 安全响应头 / 代理信任)docs/standards/auth-integration.md— 认证接入标准(前后端线协议)docs/standards/best-practices/performance.md— 性能相关(含权限缓存键的正确形态、连接池、优雅关闭)- README「防火墙:五层管道」「权限:三级守卫」章节 — 五层拦截与三级守卫的设计
前端安全标准已随前端工程迁出本仓(归档在
docs/archive/legacy-frontend/frontend-security.md)。
- 不要在未授权的情况下测试他人部署的实例
- 不要访问、修改、破坏不属于你的数据
- 不要在补丁发布前公开未修复漏洞的细节