ماسحا OSV وSCA
اعثر على الثغرات المعروفة في اعتمادياتك، والمستغلّة منها أولًا، مع إصلاحات مُتحقق منها تراعي Spring Boot.
في هذه الصفحة 7 قسم
يتشارك ماسحان محركًا واحدًا، فيتفقان دائمًا على كل اعتمادية وكل تنبيه. يقرآن ملفات القفل والبيان ومشاريع Maven أو Gradle، ويفحصان كل إصدار حزمة محلول مقابل OSV.dev، الذي يتضمن GitHub Advisory Database وPyPA وGo وRustSec وغيرها. لا حاجة إلى حساب أو مفتاح API أو أداة سطر أوامر.
| الماسح | استخدمه من أجل |
|---|---|
| OSV Vulnerability Scanner | ثغرات CVE وتنبيهات GHSA المعروفة في كل اعتمادية، مع الإصدار المصحّح وأمر الترقية لمدير حزمك. يصدّر تقرير HTML أو JSON. |
| SCA Scanner | كل ما سبق، إضافةً إلى ثغرات CISA المعروفة باستغلالها أولًا، ودرجات CVSS من NVD حين لا تتوفر في OSV، وصحة الاعتماديات، واختيار المشاريع، وإصلاحات تراعي Spring Boot تعاينها كفرق. يصدّر بصيغة JSON أو CSV. |
| من أجل… | افعل هذا |
|---|---|
| فتح لوحة OSV | الشريط الجانبي Tools ← Security & Auth ← OSV Vulnerability Scanner، أو شغّل DevSnip Pro: OSV Vulnerability Scanner |
| فحص مساحة العمل فورًا | شغّل DevSnip Pro: Scan Workspace Dependencies for Vulnerabilities (OSV) |
| فحص ملف قفل أو بيان أو مجلد مشروع واحد | انقره بزر الفأرة الأيمن في المستكشف ← Scan for Vulnerabilities (OSV) |
| فحص ملفات دون فتح مجلد | Scan Files… في لوحة OSV |
| فتح SCA Scanner | الشريط الجانبي Tools ← Security & Auth ← SCA Scanner، أو شغّل DevSnip Pro: SCA Scanner |
| الفحص بـ SCA Scanner فورًا | شغّل DevSnip Pro: Scan Dependencies (SCA…) |
| المنظومة | الملفات المقروءة |
|---|---|
| npm | package-lock. وyarn. (v1 وBerry) وpnpm-lock. وbun. وpackage. |
| PyPI | poetry. وuv. وpdm. وPipfile. وconda-lock. وrequirements*. وpyproject. وPipfile وenvironment. |
| Maven / Gradle | pom. وbuild. وgradle. وكتالوجات الإصدارات |
| Go | go. (مع replace) |
| crates.io | Cargo. وCargo. |
| RubyGems | Gemfile. وGemfile |
| NuGet | packages. وobj/ و. (مع الإصدارات المركزية للحزم) وpackages. |
| Packagist | composer. وcomposer. |
| Pub | pubspec. وpubspec. |
| Hex | mix. |
| SwiftPM | Package. وPackage. |
| CRAN | renv. |
الملفات بصيغ غير مدعومة (sbt وCocoaPods وConan وvcpkg وBazel وغيرها) تُذكر بأسمائها، ويُعلَّم الفحص بأنه غير مكتمل.
- شجرة الاعتماديات الكاملة. تُفحص أيضًا المكتبات التي تجلبها حزم البداية والمشاريع الأم وملفات BOM (Tomcat وSpring Framework وJackson وSnakeYAML وLogback…).
- Maven أو Gradle نفسه يحلّ الشجرة إذا سمحت بذلك مرة واحدة لكل مساحة عمل موثوقة. ويعملان للقراءة فقط: لا يُترجم شيء ولا يُثبَّت ولا يُغيَّر.
- وإلا، فمحلّل مدمج يتبع قواعد Maven (المشاريع الأم، واستيراد BOM، والخصائص، والأقرب يفوز، والاستثناءات، والنطاقات)، وقارئ لنصوص بناء Gradle يفهم إضافة Spring Boot و
mavenBomوplatformوكتالوجات الإصدارات والتجاوزات على نمطextra["tomcat..version"] - المشاريع متعددة الوحدات والبنى متعددة المشاريع تُحلّ كبناء واحد. ولا يُستعلم عن وحداتك أنت كحزم أبدًا.
- Confirmed: يحدد ملف القفل أو التثبيت الدقيق الإصدار المثبّت.
- Potential: لا يُعرف إلا نطاق، ويمكن أن يشمله التنبيه.
- Not analysed: الإصدار غير معروف، أو فشل الاستعلام، أو المصدر خارج OSV (git أو مسارات أو سجلات خاصة)، مع ذكر السبب.
- تأتي الخطورة من التنبيه: تقييم GitHub المُراجَع، ثم درجة CVSS. ويسدّ SCA Scanner الفجوات من NVD ويذكر المصدر. ولا تُختلق أي درجة أبدًا.
- يُميَّز دائمًا بين Scan complete وScan incomplete، ولا يُعرض الفحص غير المكتمل الخالي من النتائج على أنه سليم أبدًا.
- المستغلة المعروفة: تُعلَّم ثغرات CVE الموجودة في كتالوج Known Exploited Vulnerabilities التابع لـ CISA بـ Exploited وتُرتَّب أولًا، مع الإجراء المطلوب من CISA واستخدامها في برامج الفدية.
- صحة الاعتماديات: الحزم المهملة والمسحوبة والمهجورة وغير النشطة مخاطر صيانة؛ والحزم القديمة للعلم فقط. ولا توصف حزمة بأنها معرّضة للثغرات لمجرد أنها قديمة.
- المشاريع: تُعرض مشاريع Maven متعددة الوحدات وبنى Gradle ومساحات عمل npm وYarn وpnpm وBun مع إصدار Spring Boot الخاص بها. افحصها كلها أو حدّد ما تريد.
- علامات التبويب: Vulnerabilities وRemediation وDependency health وDependencies وSources & notes، التي تعرض حالة كل مصدر تنبيهات والمدة التي استغرقتها كل مرحلة.
يسجّل SCA Scanner مصدر كل إصدار مُدار — ملف POM الخاص بك، أو spring-boot-starter-parent، أو BOM يستورده Boot، أو BOM تستورده أنت — ويقترح الإصلاح في مكانه الصحيح، بدءًا بالأكثر أمانًا:
- رقِّ Spring Boot إلى أدنى إصدار يدير ملف BOM فيه إصدارًا مصحّحًا: إصدارات التصحيح أولًا، ثم الثانوية، ثم الرئيسية (مع التنبيه إلى Java 17 و
jakarta.في Boot 3).* - تجاوز خاصية Boot (
tomcat.وversion snakeyaml.) أو خاصية BOM المتداخل (version spring-framework.)، لتنتقل عائلة المكتبات معًا.version - ثبّته في
<dependencyManagement>الخاص بك حين يحدده BOM مستورد. وفي Gradle: رقِّ إضافة Boot أو اضبطext['…'].
مثال: تجاوز خاصية Boot
عندما يتأثر Tomcat ويكون إصدار Boot الأحدث قفزة كبيرة جدًا، يمكن للماسح أن يقترح الخاصية التي يقرؤها BOM في Spring Boot:
<properties>
<tomcat.version>10.1.35</tomcat.version>
</properties>ينتقل كل عنصر Tomcat يديره Boot إلى ذلك الإصدار معًا.
تحصل الاعتماديات المباشرة على تعديل للإصدار في pom. أو build. أو package. أو requirements. أو . أو composer. أو Cargo.؛ وتحصل اعتماديات npm غير المباشرة على overrides أو resolutions أو pnpm..
لا يتغير شيء من تلقاء نفسه. يفتح Preview Change فرقًا، ويطلب Apply… أو Run… التأكيد أولًا. تحافظ التعديلات على تنسيقك وعوامل النطاقات، ولا تُعدَّل ملفات القفل أبدًا، ولا يُثبَّت أو يُبنى شيء. والتعديلات معطّلة في مساحات العمل غير الموثوقة.
| الخدمة | ما تتلقاه |
|---|---|
| OSV.dev | أسماء الحزم وإصداراتها |
| سجلات الحزم (فحوصات صحة SCA) | أسماء الحزم |
| NVD (SCA) | معرّفات CVE |
| Maven Central | إحداثيات POM وBOM |
| CISA (SCA) | لا شيء: يُنزَّل الكتالوج العام |
لا تُرسل أبدًا الشيفرة المصدرية أو محتوى الملفات أو المسارات أو أسماء المشاريع أو بيانات الاعتماد.
تُبلغ الماسحات عن الإصدارات المتأثرة؛ ولا تتحقق مما إذا كانت شيفرتك تستدعي الدالة المعرّضة للثغرة. ولا يُبلَّغ إلا عن التنبيهات المنشورة في OSV وقت الفحص. احفظ ملفات القفل في المستودع: فمن دونها تكون النتائج Potential فقط.