/load_lora_adapter_from_tensors 端点缺少授权受影响版本: sglang 0.5.8 至 0.5.21(含)
修复版本: 0.5.22
CWE: CWE-862(缺少授权)
组件: sglang.srt.entrypoints.http_server → POST /load_lora_adapter_from_tensors
报告者: Rahul Karne
CNA: VulnCheck
sglang 的 HTTP 服务器通过一个按路由配置的授权装饰器 @auth_level(AuthLevel.ADMIN_OPTIONAL) 来保护其管理端点,该装饰器由 ASGI 中间件强制执行。
端点 POST /load_lora_adapter_from_tensors 缺少该装饰器,而它的两个同类 LoRA 端点(/load_lora_adapter 和 /unload_lora_adapter)都具备该装饰器。
由于未装饰的路由会解析为默认的 AuthLevel.NORMAL,该端点无法获得与其他 LoRA 管理端点相同的授权处理。在受影响的关键配置中,这允许在没有预期凭据的情况下调用管理操作。
这是一个自诞生起就存在的缺陷:该端点与 @auth_level 系统均在 0.5.8 中引入,而该端点是唯一一个发布时未带装饰器的管理路由。
/load_lora_adapter_from_tensors 是一个管理端点,它从调用方提供的数据中将 LoRA 适配器加载到正在运行的模型中。未经授权调用该端点,可使未授权调用方:
该授权缺陷独立于下游载荷处理代码中的任何弱点,并会与之叠加:一个本应要求管理员凭据的端点,绝不应在无凭据的情况下可达。
缺少装饰器的实际影响取决于服务器 API 密钥的配置方式。本报告对此刻意保持精确,因为该问题并非“对所有人始终无需认证”。
| 服务器配置 | /load_lora_adapter(同类端点) | /load_lora_adapter_from_tensors(本缺陷) | 影响 |
|---|---|---|---|
仅 --admin-api-key | 需要管理员密钥 | 无需任何凭据即可访问 | 对管理操作的无认证访问 |
同时设置 --api-key 和 --admin-api-key | 需要管理员密钥 | 使用低权限的 --api-key 即可访问 | 权限降级(普通密钥可解锁仅限管理员的操作) |
仅 --api-key | 需要 API 密钥 | 需要 API 密钥 | 此配置下无绕过 |
| 未配置任何密钥 | 开放 | 开放 | 认证中间件根本未安装;与本缺陷无关 |
最突出的情况是第一行:在设置了 --admin-api-key 的情况下,该端点完全无需任何凭据即可访问。
要触达 LoRA 代码,还需以 --enable-lora 启动服务器。另请注意,sglang 默认绑定到 127.0.0.1;网络暴露程度取决于部署方式(--host 0.0.0.0、容器端口映射等)。
sglang 使用定义在 sglang/srt/utils/auth.py 中的装饰器来授权管理路由:
def auth_level(level: AuthLevel):
"""Mark endpoint with auth level (stored in endpoint metadata)."""
def decorator(func):
func._auth_level = level
return func
return decorator
一个 ASGI 中间件(add_api_key_middleware → _ApiKeyASGIMiddleware)将每个请求解析到其路由,读取该路由的 _auth_level,并调用 decide_request_auth()。没有 @auth_level 装饰器的路由会解析为默认值:
# _get_auth_level_from_app_and_scope(...)
level = getattr(endpoint, "_auth_level", None)
return level if isinstance(level, AuthLevel) else AuthLevel.NORMAL
而对于 AuthLevel.NORMAL,当未配置明文 api_key 时,
decide_request_auth() 返回 allowed:
# decide_request_auth(..., auth_level=AuthLevel.NORMAL)
if api_key:
return AuthDecision(allowed=_check_bearer_token(authorization_header, api_key))
return AuthDecision(allowed=True) # <-- no api_key configured => allowed
在存在漏洞的版本中,http_server.py 装饰了同级函数,但没有装饰目标函数:
@app.api_route("/load_lora_adapter", methods=["POST"])
@auth_level(AuthLevel.ADMIN_OPTIONAL) # protected
async def load_lora_adapter(...):
...
@app.api_route("/load_lora_adapter_from_tensors", methods=["POST"])
# <-- NO @auth_level decorator : the bug
async def load_lora_adapter_from_tensors(...):
...
@app.api_route("/unload_lora_adapter", methods=["POST"])
@auth_level(AuthLevel.ADMIN_OPTIONAL) # protected
async def unload_lora_adapter(...):
...
当服务器以 --admin-api-key 启动(且没有普通的 --api-key)时,这两个同级端点需要管理员 bearer token,而 /load_lora_adapter_from_tensors 被解析为 NORMAL,并在没有任何凭据的情况下被放行。
添加了一个管理路由,却没有携带其他所有管理路由都有的 @auth_level 装饰器。授权模型是装饰器选择加入式的:忘记添加装饰器的路由会静默回退到限制最宽松的 NORMAL 级别,而不是失败关闭。
poc_sglang_missing_auth.py 使用 sglang 自身的代码,以两种独立方式演示该问题,且无需 GPU、无需模型、无需 RCE 载荷:
第 1 部分 — 静态分析,针对真实的 http_server.py: 它在固定的发布标签上对 sglang 实际的 srt/entrypoints/http_server.py 进行 AST 解析,并打印三个 LoRA 端点及其装饰器,显示 /load_lora_adapter_from_tensors 是唯一缺少 @auth_level 的管理 LoRA 路由。
第 2 部分 — 动态分析,针对真实的 auth.py: 它加载 sglang 真正的 srt/utils/auth.py(真实的 @auth_level 装饰器、真实的 route-level 解析器、真实的 decide_request_auth,以及真实的 add_api_key_middleware ASGI 中间件),挂载两个端点,其装饰方式由第 1 部分在真实源码中发现的结果驱动,以 --admin-api-key ... 启动服务器,并发送无凭据请求。受保护的同级端点返回 401;存在漏洞的端点返回 200(其处理程序被触达)。
返回 200 的桩处理程序是有意为之且足够的:该漏洞完全存在于授权层中,而授权层运行在模型加载处理程序之前,因此无凭据请求能够触达处理程序本身,就足以证明授权被绕过。
该演示驱动的是 sglang 真实的授权模块,而非手写的仿制品。唯一未执行的是重量级的模型加载处理程序主体(它需要 torch/CUDA),而这正是授权本应门控的代码。
该 PoC 仅需几个纯 Python 包:
pip install fastapi starlette httpx
它直接从 GitHub 上固定的发布标签获取其分析的两个 sglang 源文件(无需安装 sglang,无需 GPU)。要完全离线运行,请使用 --source/--sglang-src 将其指向本地解压的 sglang 源码树。
针对默认的易受攻击标签(v0.5.13.post1):
python poc_sglang_missing_auth.py
针对任何受影响的标签(v0.5.8 … v0.5.21):
python poc_sglang_missing_auth.py --tag v0.5.21
针对本地解压的源码树(离线):
python poc_sglang_missing_auth.py --sglang-src /path/to/sglang
检查在修复版本上不会复现:
python poc_sglang_missing_auth.py --tag v0.5.22 # exits non-zero, "not reproduced"
参见 EXPECTED_OUTPUT.txt。节选:
PART 1 -- STATIC: real http_server.py decorator audit
/load_lora_adapter @auth_level(ADMIN_OPTIONAL) -> protected
/load_lora_adapter_from_tensors (no @auth_level) -> VULNERABLE <-- TARGET
/unload_lora_adapter @auth_level(ADMIN_OPTIONAL) -> protected
>>> CONFIRMED: the target endpoint is the lone LoRA admin route missing @auth_level ...
PART 2 -- DYNAMIC: real auth.py middleware, server as `--admin-api-key ...`
POST /load_lora_adapter HTTP 401 DENIED (auth enforced) <-- PROTECTED
POST /load_lora_adapter_from_tensors HTTP 200 ALLOWED -> handler ran <-- TARGET
>>> AUTH BYPASS CONFIRMED: the protected sibling rejected the credential-free request; ...
@auth_level(AuthLevel.ADMIN_OPTIONAL)。/load_lora_adapter_from_tensors 添加缺失的
@auth_level(AuthLevel.ADMIN_OPTIONAL) 装饰器。NORMAL,这样将来遗漏的装饰器就不会在无提示的情况下
暴露某个端点。在 sglang 0.5.22 中引入:
@app.api_route("/load_lora_adapter_from_tensors", methods=["POST"])
+ @auth_level(AuthLevel.ADMIN_OPTIONAL)
async def load_lora_adapter_from_tensors(...):
通过检查从 v0.5.7 到 v0.5.23 的每个发布标签中的 python/sglang/srt/entrypoints/http_server.py 进行验证:该端点和 @auth_level 系统均首次出现在 0.5.8 中(此端点缺少该装饰器),该装饰器在 0.5.21 之前一直缺失,从 0.5.22 起开始存在。
--api-key 且未配置 --admin-api-key 的情况下,不存在绕过。127.0.0.1;网络可达性取决于运维人员如何暴露该服务器。--enable-lora。陈述这些注意事项是为了让防御者能够准确评估自身的暴露风险。
由 Rahul Karne 发现并报告。
PyPI 上的 sglang https://pypi.org/project/sglang/
sglang http_server.py 源码
https://github.com/sgl-project/sglang/blob/main/python/sglang/srt/entrypoints/http_server.py
sglang auth.py 源码
https://github.com/sgl-project/sglang/blob/main/python/sglang/srt/utils/auth.py
CWE-862 — 缺少授权 https://cwe.mitre.org/data/definitions/862.html
本仓库记录了一项协同披露的安全发现,并提供了一个无害、自包含的概念验证。
该 PoC 不执行任何破坏性操作。它从固定的发布标签读取 sglang 源码,在进程内运行 sglang 自身的授权代码,并向进程内测试服务器发送本地 HTTP 请求。它不需要 GPU,不加载任何模型,也不包含任何代码执行载荷。
本材料仅供防御性安全研究和教育目的使用。