安全与合规
BizBuddy 的安全口径是四句话:最小权限、默认拒绝、全链路留痕、最坏情况能兜底。 本页只写已经落进代码并能复跑验证的部分。
权限:三档与代码级兜底
| 档位 | 行为 | 适用 |
|---|---|---|
| 允许 | 直接执行,写入审计 | 只读查询、明确无害的工具 |
| 需确认 | 暂停本轮,弹卡片等待处置 | 写库、写外部系统、执行命令(ASK 档) |
| 禁止 | 不注册给模型 | 未授权工具、无人值守链路的写工具 |
无人值守场景(定时任务、渠道接入)没有人类可确认,因此写工具一律代码级拒绝,只有列入「无人值守白名单」的工具才执行。白名单修改需要独立权限并填写变更理由,保存后即时生效。
审计:六类留痕
| 留痕 | 能回答的问题 |
|---|---|
| 会话与消息 | 用户和智能体到底说了什么 |
| 工具调用 | 调了哪个工具、入参出参、状态与耗时 |
| 权限决策 | 这次为什么被允许 / 被拒 / 被要求确认 |
| 链路追踪 | 这一轮经过了哪些环节、为什么降级 |
| 编排运行 | 路由命中、专家调用与终态 |
| 平台运行日报 | 每天的平台运行摘要 |
内容安全
输入、输出、渠道出站、工具结果、知识库入库、MCP 出口六条链路均可过审;支持本地词库与外部内容安全 API,缺少端点或密钥时自动降级本地词库。PII 脱敏与提示词注入防护可独立配置。
内容审核默认关闭以避免误杀;建议先以「只留痕」方式灰度,再切拦截。
沙箱:边界写清楚
沙箱默认关闭。启用后:
- 执行容器非 root、能力全 drop、默认无网络、不挂宿主目录;
execute三态授权,无人值守链路恒为拒绝;- 应用容器内不存在
/var/run/docker.sock,宿主接口经受限代理转发; archive只对带bizbuddy.sandbox=1标签的容器放行,非沙箱容器一律拒绝。
残余风险
socket 代理按「方法 + 路径」白名单转发,不校验请求体语义。能调用代理的后端仍可在白名单范围内创建容器;真正的最小权限需要受限执行服务或 rootless daemon。我们不把「代理」表述为「强隔离」。
数据与存储
- 会话产物写入对象存储,数据库只存元数据;私有桶下由后端按需签发下载地址。
- 产物随消息 / 会话删除级联回收,避免孤儿对象。
- 沙箱工作区不挂载宿主目录;跨轮保留依赖快照,按保留策略清理。
自己验证
安全能力不靠承诺,靠可复跑的用例:
bash
# 双栈 HTTP e2e(含权限、HITL、无人值守、沙箱执行、产物导出)
node e2e/http/run.mjs
node e2e/http/run.mjs --base-url http://localhost:8081
# 单元 + 真库集成
cd code/back-end
BIZBUDDY_IT=true ./mvnw -o -pl ruoyi-admin -am test发版门禁与实测基线见仓库 docs/release-checklist.md。