
فقدان التفويض على نقطة نهاية sglang /load_lora_adapter_from_tensors (CVE-2026-127222)
/load_lora_adapter_from_tensors في sglangالمتأثر: 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
يحمي خادم HTTP في sglang نقاط النهاية الإدارية الخاصة به عبر مُزخرف
تفويض لكل مسار، @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 العادي)،
فإن الشقيقين يتطلبان رمز حامل المسؤول (admin bearer token)، بينما
يُحلّ /load_lora_adapter_from_tensors إلى NORMAL ويُسمح بالمرور
دون أي بيانات اعتماد.
أُضيف مسار إداري واحد دون المزخرف @auth_level الذي تحمله
كل مسارات إدارية أخرى. نموذج التفويض هو
اشتراك بالمزخرف (decorator-opt-in): المسار الذي ينسى المزخرف يعود بصمت إلى
المستوى الأقل تقييدًا NORMAL بدلًا من الفشل المُغلَق.
يوضّح poc_sglang_missing_auth.py المشكلة
باستخدام كود sglang الخاص به، وبطريقتين مستقلتين، دون GPU، ودون نموذج، ودون
حمولة RCE:
الجزء 1 — ساكن، مقابل http_server.py الحقيقي: يقوم بتحليل AST لملف sglang
الفعلي srt/entrypoints/http_server.py عند وسم إصدار مثبّت ويطبع
نقاط نهاية LoRA الثلاث مع مزخرفاتها، موضحًا أن
/load_lora_adapter_from_tensors هو مسار LoRA الإداري الوحيد الذي يفتقد
@auth_level.
الجزء 2 — ديناميكي، مقابل auth.py الحقيقي: يحمّل ملف sglang الأصلي
srt/utils/auth.py (المزخرف @auth_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
يجلب ملفَّي مصدر sglang اللذين يحللهما مباشرةً من وسم الإصدار المثبَّت على GitHub (دون تثبيت sglang، ودون GPU). للتشغيل دون اتصال بالإنترنت بالكامل، وجّهه إلى شجرة مصدر sglang مستخرجة محليًا باستخدام --source/--sglang-src.
مقابل الوسم الافتراضي المعرَّض للثغرات (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 ...