
sglang /load_lora_adapter_from_tensors 엔드포인트의 인가 누락 (CVE-2026-127222)
/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 서버는 ASGI 미들웨어에 의해 적용되는 라우트별 인가 데코레이터인
@auth_level(AuthLevel.ADMIN_OPTIONAL)로 관리 엔드포인트를 보호합니다.
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()는 허용됨을 반환합니다:
# 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 없이)로 서버를 실행하면, 두 형제 엔드포인트는 admin bearer 토큰을 요구하지만, /load_lora_adapter_from_tensors는 NORMAL로 판정되어 자격 증명 없이 통과된다.
다른 모든 관리자 라우트가 갖추고 있는 @auth_level 데코레이터 없이 하나의 관리자 라우트가 추가되었다. 권한 부여 모델은 데코레이터 옵트인(decorator-opt-in) 방식이다. 즉, 데코레이터를 빠뜨린 라우트는 fail-closed로 동작하는 대신 조용히 가장 덜 제한적인 NORMAL 레벨로 폴백된다.
poc_sglang_missing_auth.py는 sglang 자체 코드를 사용하여 두 가지 독립적인 방식으로 이 문제를 입증하며, GPU도, 모델도, RCE 페이로드도 필요로 하지 않는다:
PART 1 — 정적 분석, 실제 http_server.py 대상: 고정된 릴리스 태그에서 sglang의 실제 srt/entrypoints/http_server.py를 AST 파싱하여 세 개의 LoRA 엔드포인트와 그 데코레이터를 출력하며, /load_lora_adapter_from_tensors가 @auth_level이 빠진 유일한 관리자 LoRA 라우트임을 보여준다.
PART 2 — 동적 분석, 실제 auth.py 대상: sglang의 진짜 srt/utils/auth.py(실제 @auth_level 데코레이터, 실제 라우트 레벨 리졸버, 실제 decide_request_auth, 그리고 실제 add_api_key_middleware ASGI 미들웨어)를 로드하고, PART 1이 실제 소스에서 발견한 내용에 따라 데코레이션이 결정되는 두 엔드포인트를 마운트한 뒤, --admin-api-key ...로 서버를 시작하고 자격 증명 없는 요청을 전송한다. 보호된 형제 엔드포인트는 401을 반환하고, 취약한 엔드포인트는 200을 반환한다(핸들러에 도달함).
200을 반환하는 스텁 핸들러는 의도적이며 충분하다. 취약점은 모델 로딩 핸들러 이전에 실행되는 권한 부여 계층에 전적으로 존재하므로, 자격 증명 없는 요청이 핸들러에 도달한다는 것 자체가 권한 부여가 우회되었음을 증명한다.
이 시연은 손으로 작성한 모방이 아니라 sglang의 실제 권한 부여 모듈을 구동한다. 실행되지 않는 유일한 부분은 무거운 모델 로딩 핸들러 본문(torch/CUDA 필요)이며, 이는 바로 권한 부여가 게이트해야 하는 코드이다.
PoC에는 몇 가지 순수 Python 패키지만 필요하다:
pip install fastapi starlette httpx
분석 대상인 두 개의 sglang 소스 파일을 GitHub의 고정된 릴리스 태그에서 직접 가져옵니다(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)이 적용된 sglang 0.5.22 이상으로 업그레이드하십시오./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가 필요합니다.이러한 주의 사항은 방어자가 자신의 노출 정도를 정확히 평가할 수 있도록 명시한 것입니다.