Agent 审批恢复接口补上租户隔离
RagLeap Agents 0.5.0 在共享状态存储下仅凭运行 ID 恢复任务,可能让其他租户触发原任务待审批的工具调用。0.5.1 为运行和恢复接口增加持久化作用域校验,并统一异常响应以减少状态泄露。
AI 深度解读
一个 Agent 等待工具执行审批时,另一个租户如果拿到了 run ID,能不能替它点头?作者在 RagLeap Agents 0.5.0 中复现了这个问题:共享状态存储没有绑定租户,导致其他租户可以恢复暂停的任务,并触发原参数对应的工具调用。
0.5.1 的修复重点,是把运行记录与租户作用域绑定起来。对开发多租户 AI 应用的程序员,这个案例提醒了一件容易漏掉的事:工具需要审批,还得检查审批究竟来自谁。
有审批流程,为什么还能跨租户执行?
问题出在共享 Agent 实例和共享状态存储的组合上。
Tenant A 启动任务,任务在执行某个工具前暂停,等待审批。Tenant B 获得这个任务的 run ID 后,调用恢复接口。旧实现的 run() 和 resume() 都没有绑定租户作用域,存储也只用 run ID 作为键,于是 B 可以恢复 A 的任务,让工具使用原先保存的参数执行。
这里不需要篡改提示词,也不需要修改工具参数。漏洞发生在「谁有权继续这次运行」的检查上。
run ID 能定位任务,却不能单独证明调用者有权审批任务。
作者明确说这是在共享存储用法下复现的隔离缺口。不过,原文没有交代攻击者如何获得 run ID,不能据此推断它已经形成了完整的远程攻击链。
0.5.1 怎样把审批绑回所属租户?
新版本为启动和恢复接口增加了 scope,用于标识运行所属的作用域。多租户应用可以把它对应到租户边界。
下面这段代码解决启动与恢复时的作用域传递:
agent.run(task, scope="tenant-a")
agent.resume(
run_id,
decisions,
scope="tenant-a"
)
要看的是两处 scope="tenant-a":作用域会随运行记录保存,恢复请求必须与保存值一致。只在启动时传入租户、恢复时不检查,无法闭合这个边界。
错误响应也做了收敛。作用域不匹配、运行不存在、状态损坏,都返回同一个错误:
ResumeError("unknown run")
这里要留意 "unknown run"。它避免通过不同错误提示,向请求者透露其他租户是否存在某次运行;它不是在告诉运维人员,所有失败的真实原因都相同。
新生成的 run ID 改为带有 128 bits 随机性的 22 字符 URL-safe token,同时兼容已有的 12 字符十六进制 ID。更难猜的 ID 有帮助,但权限边界仍然依赖作用域校验。
应用还可以通过 Agent(..., require_scope=True) 启用强制作用域要求。子 Agent 则继承父 Agent 的作用域,避免任务向下委派后丢失租户归属。
审计和限流补上了什么,又没覆盖什么?
0.5.1 同时引入了两个组件:
AuditLog(...)记录运行元数据,不记录内容文本,便于留下操作线索。RateLimiter(...)在模型调用前应用按作用域划分的限额。
新增依赖为 ragleap-security>=0.2.0,该依赖使用 Python 标准库。原文没有展开审计字段、限流算法及具体配置,不能据此判断它们是否满足某个团队的完整运维需求。
验证方面,作者报告不仅测试了源码检出版本,还对发布后的 wheel 包运行了测试,并为已复现的问题加入回归覆盖。但原文没有列出测试数量和详细结果。
边界也写得比较明确:共享状态文件仍然依赖文件系统权限,按租户使用独立存储能提供更强隔离;限流器保存在内存中,重启后状态不会保留。Windows、macOS、真实模型供应商调用和网络文件系统,都没有纳入这次报告的验证范围。
我的判断
我认可这个修复方向。它把 Agent 安全从提示词和工具权限,推进到了任务所有权与审批归属。暂停、恢复、子任务委派都属于执行链的一部分,不能只检查最初那次请求。
但 scope 不是完整的身份认证系统。应用仍要认证用户,并传入正确的作用域。如果直接相信请求里自报的租户标识,框架再严格地比较字符串,也无法保证身份可信。
与按租户独立存储相比,共享存储加作用域校验提供了应用层的隔离检查,独立存储则增加了存储层的边界。原文没有给出两种方案的性能、成本或安全对照数据,不能替团队直接选型。
同样,发布包测试和回归测试能支持「这个已知问题有了针对性修复」,还不足以证明整个系统已经安全。作者也明确保留了独立安全审查的必要性。
能拿来做什么
- 如果你维护带审批页面的 AI 应用,应检查后端恢复接口是否根据已认证用户确定租户,并校验任务归属,不能只凭前端提交的 run ID 放行。
- 如果使用 RagLeap Agents 0.5.1,可以评估启用
require_scope=True,并检查run()、resume()以及子 Agent 路径是否保持一致的作用域。 - 给审批流程补一条跨租户回归用例:A 创建并暂停任务,B 持有同一 run ID 尝试恢复,确认请求失败且待执行工具没有被触发。
- 部署时把状态存储与限流分别检查:确认共享文件的访问权限,按隔离需求评估独立存储,并把内存限流器重启后丢失状态这一点计入运行方案。