智能体防护工具为何自行解锁存储
agentinbox 的实机测试发现,存储权限异常时,数据库初始化逻辑会主动改写权限并继续运行。工具最终显示没有待处理请求,掩盖了本应阻断操作的异常。
AI 深度解读
agentinbox v0.1.0 的一次现场测试发现,收件箱数据库被设为不可读写后,CLI 会先恢复文件权限,再照常打开数据库。它显示没有待处理请求,以成功状态退出,连自带的 doctor 都把恢复后的权限判为健康。
这次故障对写 CLI 和本地开发工具的人很实用。打开文件、顺手修权限、检查健康状态,单看都合理,串起来却可能把一次本应中止的操作变成成功。作者用一条从进程外改变文件权限的测试,把这个问题从 930 条全绿的单测里找了出来。
为什么锁住的数据库还能打开
agentinbox 是 agentic-suite 中面向 AI Agent 的安全工具。作者在故障矩阵里给权限锁定的存储定义了明确的行为:触发异常时停止操作,也就是 fail closed,并由 CLI 返回预留的退出码 4。现场用例 FT-SC-24-LIVE 从测试运行器的 shell 用 chmod 000 锁住已有的 inbox.db,随后运行 agentinbox inbox。实际拿到的是 rc=0。
旧驱动在打开数据库之前就会处理权限。新文件用 os.open 创建,目标权限是 0o600,即只有所有者可以读写。文件已经存在时,驱动也会直接调用 _chmod(self.path, 0o600)。这里容易混淆两件事:000 禁止普通进程按文件权限读写,文件所有者仍然可以修改权限。驱动正是以所有者身份运行的,于是 SQLite 尝试连接时,锁已经被驱动自己解开了。doctor 随后读到的是改过的 600,原先的锁定状态已经丢失。
930 条单测为什么给了全绿
已有测试覆盖存储一致性、崩溃恢复、迁移和权限检查,甚至有一条叫 test_store_does_not_loosen_permissions_on_open。但作者描述的测试夹具通常在临时目录里创建新库,再对刚建好的库做断言。现场用例多做了一个动作:在库已经存在的情况下,由应用进程外的 shell 改变权限,再观察 CLI 的退出码。
这轮共跑了 53 个现场测试单元,报告只发现 1 个产品缺陷,就是这个用例揭出的权限问题。其余 5 个失败涉及测试运行框架的问题,以及团队主动决定不做人体研究。作者估计,跑通这个现场用例花了大约一天搭建测试框架。这个数字说明了该次验证的成本,报告没有提供与其他测试方案的成本对照。
修复之后,怎么证明锁还在
补丁保留了新库的私有权限,并在处理已有文件前先读取当前权限位。
if not self.path.exists():
# a new db is created private
descriptor = os.open(self.path, os.O_CREAT | os.O_RDWR, 0o600)
os.close(descriptor)
else:
# never chmod a file we cannot read
mode = stat.S_IMODE(self.path.stat().st_mode)
if mode & 0o444: # readable but permissive: tighten only
_chmod(self.path, 0o600)
关键是 if mode & 0o444 这一行。000 没有任何读权限位,因此会跳过 _chmod。之后 SQLite 连接抛出 sqlite3.OperationalError,应用将它包装为 StoreError,CLI 再映射到退出码 4。文件仍是 000,诊断也就能看到锁定状态。
作者先在旧构建上跑 tests/store/test_locked_store.py,确认回归测试会失败,再验证补丁生效。测试同时断言 load_store 抛出 StoreError 和文件权限仍为 000。另一条测试确认新库仍以 0600 创建。最后,作者在现场重跑 FT-SC-24-LIVE,拿到了预期的 rc=4。文中给出的发布包是 agentsec-agentinbox==0.1.0。
我的判断
最有说服力的是两条断言配合起来:错误必须传到调用者,触发错误的状态也必须保留下来。只断言异常或退出码,可能漏掉应用先改写现场再报错的情况。把这两条断言放进真实文件系统上的集成测试,也能覆盖这个缺陷。相比之下,完整的现场重跑还能验证发布构建的 CLI 是否正确映射错误。原文没有做方案对照,「一定要到现场才抓得住」属于作者的经验判断。
补丁的结论也应限定在已验证的场景。0o444 检查的是所有者、组和其他用户中是否有任意读位,代码通过这一关后仍会尝试把已有文件改为 0600。所以文中关于「权限只在创建时改变」的表述比实际代码更强。这组回归证据直接坐实的是 000 锁定会保留,以及新库仍按 0600 创建。
能拿来做什么
- 给 Node CLI 或构建工具的本地数据库、缓存和状态文件补权限测试时,先通过正常入口创建文件,再从测试运行器改变状态,最后通过 CLI 入口验证错误和退出码。
- 如果工具带有
doctor或其他诊断命令,把诊断结果也加进故障用例。操作失败后再查一次,确认诊断能反映故障留下的实际状态。 - 让 AI 编程助手修这类问题时,要求它先在旧实现上跑出失败,再同时验证调用方收到错误、原始状态得到保留、正常初始化仍然成功。