给小工具补上的路径检查课
路径规则要写到测试里
把失败写成能读懂的结果
我会给这类工具再留几条反例:输入为空、外部依赖拒绝、重复执行和中途取消。断言不仅检查 Result,也检查状态是否被提前修改、临时文件是否清理。这样失败时可以直接判断是契约改变,还是某条收尾分支漏掉了。
错误信息也要指向用户能处理的位置。说明哪个参数或文件有问题,保留必要的底层上下文,不把一长串内部调用栈当作提示。可预测的失败路径比“尽量自动修复”更适合小工具。
允许目录不是一个口头约定。把根目录、允许的扩展名和符号链接策略收进一个小函数,所有读写都从它走。规范化路径之后再判断前缀,避免看起来在工作目录内、实际跳到别处的输入。遇到不能解析的路径,报错比悄悄跳过更容易发现配置问题。
拒绝样例很有价值:父目录穿越、绝对路径、软链接指向工作区外、空路径,各留一个。它们不需要模拟完整命令行,只要证明校验层没有被绕开。后面新加子命令时,复用同一入口,才不会每个命令再写一遍各不相同的保护。
写本地工具时,我以前把“用户传进来的路径”当成普通字符串。后来才明白,路径会同时影响配置读取、输出位置和错误信息,处理得随意就容易越过预期目录。这里记录的是我给练习项目补安全检查的过程,不是完整的权限系统。
先明确工具允许碰什么
开始前先列一张很朴素的表:配置只能从项目目录读取,生成物只能写进指定输出目录,缓存目录单独传入。这样函数不必拿整个工作区路径,更不用到处调用当前目录。若命令需要网络、子进程或环境变量,也要分别说明;文件路径检查只能限制文件访问,不能替代这些权限。
路径校验不能只搜索 ../。不同系统有绝对路径、符号链接和分隔符差异。一个容易理解的做法是先把候选路径与根目录拼接,规范化后检查它是否仍以根目录开头。文件可能还不存在,因此不能把“能否规范化”为唯一判断。对准备创建的文件,应分别校验父目录与最终文件名。
用拒绝样例固定边界
测试里我会把正常路径和越界路径放在一起看,重点不是让测试名字好看,而是让失败原因清楚:
#[test]
fn rejects_parent_directory_escape() {
let root = std::path::Path::new("fixtures/work");
assert!(checked_path(root, "notes/today.txt").is_ok());
assert!(checked_path(root, "../secret.txt").is_err());
}
接着运行 cargo test path_policy。如果实现需要依赖真实目录,就在临时目录创建最少文件,不要借用自己的家目录。错误信息也不要把机器上的完整敏感路径直接打印给终端用户;对外可以说明“路径不在允许目录中”,调试时再记录受控的上下文。
不把检查误当成保证
一个常见误区是校验通过后,再用原始字符串去打开文件。这样等于绕过刚做的工作,后续操作必须使用校验函数返回的路径。另一个误区是忽略符号链接:在有链接的目录里,字符串前缀看起来安全,实际目标可能已经离开根目录。是否需要处理它,要由工具的运行环境决定,不能照抄一段代码就宣称解决了所有问题。
我给自己留的检查顺序是:先收窄能力,再校验输入,再写拒绝测试,最后在命令层显示实际操作范围。这个顺序不酷,但对刚学 Rust 的我来说,比试图一次搭出“安全框架”更容易验证和维护。
402



被折叠的 条评论
为什么被折叠?



