Skip to content

Security: ZhaoJun233/bot-agent

Security

SECURITY.md

安全策略

简体中文 | English

报告安全问题的渠道

不要用公开 issue 报安全问题,也不要在 issue / PR / 讨论里贴出可复现的生产凭据、群聊正文、成员档案、协议端原始报文、日志片段或截图。

请私下联系仓库所有者(GitHub 上 @ZhaoJun233),或在仓库的 Security 页使用 "Report a vulnerability" 私密通道。报告请尽量给出:

  • 受影响的功能与入口(哪个端点 / 哪条命令 / 哪个插件路径);
  • 触发条件与最小复现步骤(用合成数据,不要用线上会话);
  • 影响判断(读到什么、改到什么、能不能持久化);
  • 你认为的修复方向(可选)。

响应承诺

本项目是个人维护的项目,不承诺响应时限,也不承诺修复时间。收到报告后会尽力确认、评估影响并安排修复,但不构成 SLA。

本项目的威胁模型(先读这几条,能省一轮沟通)

  1. 插件没有沙箱。 插件是在宿主进程内加载的 .NET 程序集(PluginPackageLoader 是可回收的 AssemblyLoadContext,直接 LoadFromAssemblyPath + Activator.CreateInstance)。也就是说,任何被启用的插件都能执行任意代码、读写宿主可访问的一切(数据库、密钥、日志、网络)。因此:
    • 插件来源的可信度就是宿主的可信度;
    • 安装 / 启用插件属于高权限操作,默认关闭,需要管理员显式开启;安装、更新与启停会热应用到运行中的宿主,不需要为此重启进程(升级与排障仍建议放在维护窗口内操作);
    • "这个插件会不会干坏事" 不是沙箱能回答的问题,只能靠来源审查。
  2. SHA256 只证明字节完整性,不证明代码安全。 清单里的哈希能保证"下到的包和作者发布的是同一份字节",不能保证这份字节没有恶意行为。签名与哈希都不改变第 1 条。
  3. 权限声明只是信息披露,不是强制约束。 插件清单里的 permissions 字段用于展示与审核提示,宿主不会因为声明了少权限就限制它能做什么。
  4. 凭据与会话数据是最高价值目标。 模型 API Key、面板令牌、ZBA 令牌、官方通道 App Secret 都在宿主进程内存与 SQLite 里;数据库文件与 secrets 表在宿主可读的位置上。能执行代码的攻击者(包括恶意插件)可以拿走它们 —— 这也是为什么插件默认禁用。
  5. 默认失败关闭。 没有配置 ZBA 令牌时管理端点返回 503,只有 /zba/v1/health 可读;面板令牌缺失时管理写入口不可用。如果你发现某个入口在缺令牌时仍然可用,那是安全缺陷,请按上面的渠道报告。

不在本项目范围内的

  • 上游依赖(.NET 运行时、NuGet 包、NapCat、Caddy、Cloudflare 隧道、模型网关)自身漏洞:请报给对应项目;本项目通过 NuGet 审计门(NU1903/NU1904 作为还原错误)与钉版本处理已知项。
  • 你自己部署环境的加固(反向代理、防火墙、主机权限、备份介质保管):属于部署方责任,仓库只提供回滚与备份的操作口径。
  • 拿真实群聊数据做出来的任何结论或外传:见 AGENTS.md 的隐私红线。

部署方的最低要求

  • 面板与协议端只绑回环,经反向代理对外;
  • 数据库文件权限 600(Unix),备份文件同等对待;
  • 不把 .env、数据库、日志纳入镜像或公开快照;
  • 升级前按 docs/operations/rollback-playbook.md 做快照;
  • 容器默认不挂载 docker socket(compose 的 volumes 只有 ./data,#131):// 的 docker 能力与 面板一键部署因此不可用,宿主会如实回读这一点(工具表里不出现 docker、状态面标出不可用)。 要启用必须由部署方显式挂载 /var/run/docker.sock —— 那等于把宿主 root 交给容器里的进程 (见本文威胁模型第 1 条),请自行评估后再打开对应开关。
  • 只启用来源可信的插件。

There aren't any published security advisories