CVE-2026-112936 的离线教学模型(filelock SQLite 符号链接跟随)
用于 CVE-2026-112936(GHSA-j8f7-rjxc-mr56)的本地实验环境:filelock 的
ReadWriteLock 以 Path(lock_file).resolve() 作为其实例的键,并允许
sqlite3.connect() 打开锁路径,因此在该路径上放置的符号链接会被跟随:进程创建或锁定了链接所指向的文件,
而重新指向该链接则使两个进程在不同文件上持有“那个”写锁。修复提交 4d45e83caf7e(filelock 4.0.9)使用
O_NOFOLLOW | O_NONBLOCK 打开路径,拒绝任何非普通文件,
仅解析父目录以生成键,并通过
/proc/self/fd/N 连接 SQLite。教学用途、确定性、C11 代码经 ASan/UBSan 检查。
无 SQLite、无 filelock、无网络、无其他用户。 每个用例在全新的 mkdtemp() 沙箱内构建
自己的名称,使用真实
系统调用执行两次打开操作并删除沙箱;输出仅为标签和沙箱相对
键。
西班牙语:README.es.md。练习:PRACTICE.md。
src/filelock/_read_write.py)| Diff 行 | 代码 | 实验 |
|---|---|---|
| 旧 212,旧 309 | pathlib.Path(lock_file).resolve() | pre 键:fl_resolve(非严格,跟随链接) |
| 新 224-225,新 322 | pathlib.Path(_canonical(lock_file)),“仅解析父目录” | post 键:fl_canonical(父目录已解析,名称保留) |
| 旧 740-746 | sqlite3.connect(database, ...) | pre 打开:open(name, O_RDWR|O_CREAT|O_NONBLOCK) 替代实现 |
| 新 54-55 | _DB_OPEN_FLAGS = O_RDWR|O_CREAT|O_NOFOLLOW|O_NONBLOCK | post 打开标志,模式 0600(新 775) |
| 新 776-779 | if not S_ISREG(os.fstat(fd).st_mode):关闭,“拒绝非普通锁数据库” | REFUSED_NONREG |
| 新 753-765,59 | 持有 fd;target = f"{_FD_DIR}/{fd}"(Linux 上为 /proc/self/fd) | reopen 操作 |
GHSA 指出 SQLite 的 VFS 在用户空间解析最终的符号链接,因此
fs.protected_symlinks 和粘滞位无法阻止它;实验中的 pre
替代实现让内核跟随链接,这在单用户沙箱中产生相同
结果。_canonical 位于 _api.py 中,不在
diff 范围内:仅对其注释(“仅解析父目录”)进行建模。
results/)| 锁路径处 | 修复前 | 修复后 |
|---|---|---|
指向 private/pwned.flag(不存在)的符号链接,也通过链式链接 | FOLLOWED_CREATED,在锁路径之外创建新文件 | REFUSED_SYMLINK,未创建任何内容 |
| 指向现有文件的符号链接(绝对或相对) | FOLLOWED_EXISTING,键 = 目标 | REFUSED_SYMLINK,键 = 链接 |
| 指向 FIFO / 目录 / 自身 / 不存在目录的符号链接 | OPENED_NONREG / ERR_EISDIR / ERR_ELOOP / ERR_ENOENT | REFUSED_SYMLINK |
| FIFO | OPENED_NONREG | REFUSED_NONREG |
| 两次打开之间重新指向链接(GHSA PoC 第 3 步) | EXCLUSION_BROKEN,键为 S/a.db 和 S/b.db | REFUSED |
| 验证后替换链接,然后连接 | REOPEN_FOLLOWED(名称被再次打开) | REOPEN_SAME_INODE(/proc/self/fd/N) |
| 普通文件、不存在的名称、目录、符号链接父目录、硬链接 | 两者相同 | 两者相同 |
results/sweep.csv 在锁路径处跨越 13 种对象类型。在 400
个随机设置中,测试检查 post 从不在锁路径之外创建名称,
始终拒绝最终的符号链接,并且在没有最终符号链接时
两个版本除非常规文件外结果一致。
有两个用例是实验的观察结果,并非发现:路径处的硬链接
(c13)被两个版本都打开(O_NOFOLLOW 针对符号链接;
fs.protected_hardlinks 未建模),以及在两次打开之间将锁文件重命名移走
并创建新文件(s04)在两个版本中都会分裂 inode;
在粘滞目录中对其他用户的文件执行此操作需要实验未建模的
权限。
sh scripts/build.sh test # -Wall -Wextra -Werror, ASan + UBSan
python3 scripts/derive_expected.py | diff - fixtures/expected.tsv
sh scripts/build.sh results /tmp/r && diff -r results /tmp/r
./build/fllab case pre 'F:a.db;L:lock.db>a.db' 'open:lock.db'
fixtures/cases.tsv 包含正例、反例、边界用例和域外用例,其标签由人工推导得出。fixtures/expected.tsv 来自 scripts/derive_expected.py,后者在自身的沙箱中运行 Python 的 os 模块来执行相同的场景,并使用 pathlib 真实的 resolve() 计算 pre 键;C 测试会将标签和键与这两者进行比对。
模型并不等同于发现:参见 LIMITATIONS.md 和 SOURCES.md。许可证:Apache-2.0。