/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() は 許可 を返します:
# 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 がない場合)、
2つの兄弟エンドポイントは管理者ベアラートークンを要求する一方、
/load_lora_adapter_from_tensors は NORMAL に解決され、認証情報なしで通過が許可されます。
他のすべての管理ルートが持つ @auth_level デコレータを伴わずに、1つの管理ルートが追加されました。認可モデルは
デコレータによるオプトイン方式です。つまり、デコレータを付け忘れたルートは、フェイルクローズする代わりに、
最も制限の緩い NORMAL レベルへと暗黙的にフォールバックします。
poc_sglang_missing_auth.py は、sglang 自身のコードを用いて、
GPU もモデルも RCE ペイロードも不要で、2つの独立した方法によりこの問題を実証します。
PART 1 — 静的解析、実際の http_server.py に対して: 固定されたリリースタグにおける sglang の実際の
srt/entrypoints/http_server.py を AST 解析し、3つの 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 が実際のソース内で見つけた内容に
基づいてデコレーションが決まる2つのエンドポイントをマウントし、サーバーを --admin-api-key ... として起動し、
認証情報なしのリクエストを送信します。保護された兄弟エンドポイントは 401 を返し、脆弱なエンドポイントは
200 を返します(そのハンドラに到達します)。
200 を返すスタブ化されたハンドラは意図的なものであり、十分です。この脆弱性は、モデル読み込みハンドラの
前に実行される認可レイヤーに完全に存在するため、認証情報なしのリクエストがそもそもハンドラに到達すること
自体が、認可がバイパスされた証拠となります。
この実証は、手書きの模倣物ではなく、sglang の実際の認可モジュールを駆動します。実行されない唯一の部分は、 重量級のモデル読み込みハンドラ本体(torch/CUDA を必要とする)であり、これはまさに認可がゲートすべきコードです。
PoC に必要なのは、いくつかの純粋な Python パッケージのみです。
pip install fastapi starlette httpx
解析対象の2つの 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 を必要とする。これらの注意事項は、防御側が自身の露出を正確に評価できるように記載している。
Rahul Karne によって発見・報告された。