Skip to content

Security: yijiu2025/CoreFlow

SECURITY.md

安全策略

CoreFlow 重视安全问题。如果你发现了安全漏洞或安全隐患,请通过本页的私密渠道报告,不要提交公开 Issue、不要在讨论区或社交媒体披露细节。

报告漏洞

唯一推荐渠道(私密,仅维护者可见):

https://github.com/yijiu2025/CoreFlow/security/advisories/new

请在报告中尽量包含以下信息:

  1. 受影响的组件与版本(或 commit SHA)
  2. 复现步骤 / PoC
  3. 影响评估(越权?数据泄露?远程执行?)
  4. 你建议的修复方向(如有)
  5. 是否希望公开致谢

响应承诺

阶段 时限
确认收到报告 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)
  • 社会工程、物理攻击
  • 部署环境配置错误(请先对照部署文档自查,这属于使用问题而非漏洞)

处理流程

  1. 维护者确认报告并复现问题
  2. 在私密分支准备修复与补丁版本
  3. 发布补丁版本,并创建 GitHub Security Advisory(GHSA)
  4. 经报告者同意后,在公告中致谢(可选)

加固参考

部署与加固自查可参考:

  • 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)。

禁止事项

  • 不要在未授权的情况下测试他人部署的实例
  • 不要访问、修改、破坏不属于你的数据
  • 不要在补丁发布前公开未修复漏洞的细节

There aren't any published security advisories