
تدقيق للمصدر للقراءة فقط يفحص نسخة محلية من FreeSWITCH بحثًا عن بصمات حقن الأوامر في أمر api-proto الخاص بـ mod_sofia chat api لإصدار CVE-2026-116779 ويُبلّغ عن VULNERABLE أو NOT_VULNERABLE أو INCONCLUSIVE.
تدقيق محلي للقراءة فقط للمصدر والملفات التعريفية المرفقة لثغرة FreeSWITCH الواردة عبر SIP MESSAGE CVE-2026-116779. تقيّم الأداة نسخة محلية من مصدر FreeSWITCH؛ وهي لا ترسل رسائل SIP، ولا تستغل خدمة، ولا تفحص شبكة.
mod_sofia<= 1.11.2)CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:HMESSAGE اختيار بروتوكول الدردشة api. يسجّل mod_dptools ذلك البروتوكول لاستدعاء switch_api_execute()، مما يتيح تنفيذ أوامر API بصلاحيات عملية FreeSWITCH.يقول المورّد إن أي ملف تعريف SIP يقبل MESSAGE الوارد يكون متأثرًا افتراضيًا. يحجب enable-chat=false معالجة الدردشة لكنه يعطّل كل تسليم دردشة MESSAGE الوارد. المصادقة وحدها ليست إصلاحًا كاملًا. تضيف الترقعة الرسمية بوابة enable-chat-api-proto لكل ملف تعريف، وهي معطّلة افتراضيًا؛ وتُرجع البِناءات المُصلَحة 403 لبروتوكول api المحدد ما لم يُفعَّل صراحةً.
يقرأ الكاشف فقط ملفات المصدر التالية ضمن النسخة المقدَّمة:
src/mod/endpoints/mod_sofia/sofia_presence.csrc/mod/endpoints/mod_sofia/sofia.csrc/mod/endpoints/mod_sofia/mod_sofia.hيُبلّغ عن VULNERABLE فقط عندما يجد علامة اختيار البروتوكول الوارد وعلامة إرسال دردشة api دون علامة البوابة الأصلية. ويُبلّغ عن NOT_VULNERABLE عندما يحتوي فرع api الوارد على فحص PFLAG_ENABLE_CHAT_API_PROTO الأصلي. وإذا لم تكن أي من البصمتين قاطعة، يُبلّغ عن INCONCLUSIVE. تُعرض إدخالات enable-chat-api-proto=true الصريحة في ملفات XML التعريفية المرفقة للمراجعة؛ وهي لا تنفي حقيقة أن المصدر يتضمن الترقعة.
هذا الفحص القائم على البصمات ضيّق عمدًا. فهو لا يستنتج حالة ترقعة المصدر من حالة المنفذ أو اللافتات أو سلاسل الإصدار. ولا يمكنه تحديد عمليات النقل العكسي المعدّلة في المصادر الفرعية التي لا تحتفظ بعلامات النسخة الأصلية. وهو يقيّم شجرة المصدر المقدَّمة، لا نشرًا مُجمَّعًا أو قيد التشغيل. ولا تعني نتيجة NOT_VULNERABLE أن النظام آمن من نواحٍ أخرى.
Python 3.11 أو أحدث. يستخدم وقت التشغيل المكتبة القياسية؛ وpytest وruff وmypy أدوات تطوير.
python -m venv .venv
# Windows: .venv\Scripts\activate
# macOS/Linux: source .venv/bin/activate
python -m pip install -e .
يجب أن يكون --target دليلًا محليًا لنسخة مصدرية من FreeSWITCH، وليس مضيفًا بعيدًا أو دليلًا يحتوي على إعدادات فقط.
python -m cve_detector --target "C:\src\freeswitch"
python -m cve_detector --target /src/freeswitch --format json --output report.json
الخيارات: --target (مطلوب)، --format text|json (الافتراضي text)، --output FILE، --verbose، --quiet، --version، و--help. الأداة تعمل دون اتصال بالإنترنت وهي للقراءة فقط. --timeout وإعادة المحاولات والمصادقة والفحوصات النشطة غير قابلة للتطبيق وغير متوفرة.
يحتوي JSON على cve، target، status، evidence_summary، verification_method، confidence، observations، limitations، timestamp (UTC ISO 8601)، وreferences.
| رمز الخروج | الحالة |
|---|---|
| 0 | NOT_VULNERABLE |
| 1 | VULNERABLE |
| 2 | INCONCLUSIVE |
| 3 | ERROR |
المخرجات النموذجية أدناه توضيحية وليست من نظام FreeSWITCH فعلي:
{
"cve": "CVE-2026-116779",
"target": "C:/src/freeswitch",
"status": "INCONCLUSIVE",
"evidence_summary": "The source files were found, but their implementation does not match a reliable vulnerable or fixed signature.",
"verification_method": "Read-only inspection of FreeSWITCH mod_sofia source and bundled XML profiles",
"confidence": "Low; source evidence is incomplete or modified.",
"observations": [],
"limitations": [],
"timestamp": "2026-11-15T00:00:00+00:00",
"references": []
}
أسطر حالة توضيحية للتصنيفات الأربعة:
CVE-2026-116779: VULNERABLE # unguarded selector plus bundled mod_dptools source
CVE-2026-116779: NOT_VULNERABLE # upstream per-profile gate found
CVE-2026-116779: INCONCLUSIVE # signature incomplete or target layout unsupported
CVE-2026-116779: ERROR # invalid target or local file access failed
هذه أمثلة على المخرجات المحتملة، وليست نتائج اختبارات فعلية.
python -m pip install pytest ruff mypy
python -m pytest
ruff check .
ruff format --check .
mypy src
تستخدم الاختبارات عناصر اختبار محلية مؤقتة ولا تتصل بأهداف حية. يشغّل CI هذه الفحوصات على Python 3.11 و3.12. يُشغَّل تدقيق التبعيات باستخدام pip-audit.
يمكن أن تتحكم رموز خروج العملية في سير العمل. تعامل مع رمز الخروج 2 على أنه طلب لمراجعة يدوية؛ لا تعتبره مساويًا لنتيجة نظيفة. افحص فقط أشجار المصدر التي تملك مؤسستك تصريحًا بفحصها.
api-proto سيكون آلية تحقق غير آمنة.استخدمها فقط على أشجار المصدر التي تملك تصريحًا بتقييمها. لا تنفّذ الأداة شيفرة الهدف ولا تُجري أي طلبات شبكية.
يُرجى تضمين اختبارات حتمية ومراجع موثوقة لأي توقيع كشف جديد. لا تُضِف حمولات استغلال أو فحوصات تنفّذ أوامر على هدف.
MIT؛ راجع LICENSE.