ماسحا OSV وSCA

اعثر على الثغرات المعروفة في اعتمادياتك، والمستغلّة منها أولًا، مع إصلاحات مُتحقق منها تراعي Spring Boot.

قراءة في 5 دقيقة
في هذه الصفحة 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…)

المنظومات المدعومة

المنظومةالملفات المقروءة
npmpackage-lock.json وyarn.lock ‏(v1 وBerry) وpnpm-lock.yaml وbun.lock وpackage.json
PyPIpoetry.lock وuv.lock وpdm.lock وPipfile.lock وconda-lock.yml وrequirements*.txt وpyproject.toml وPipfile وenvironment.yml
Maven / Gradlepom.xml وbuild.gradle(.kts) وgradle.lockfile وكتالوجات الإصدارات
Gogo.mod (مع replace)
crates.ioCargo.lock وCargo.toml
RubyGemsGemfile.lock وGemfile
NuGetpackages.lock.json وobj/project.assets.json و.csproj (مع الإصدارات المركزية للحزم) وpackages.config
Packagistcomposer.lock وcomposer.json
Pubpubspec.lock وpubspec.yaml
Hexmix.lock
SwiftPMPackage.resolved وPackage.swift
CRANrenv.lock

الملفات بصيغ غير مدعومة (sbt وCocoaPods وConan وvcpkg وBazel وغيرها) تُذكر بأسمائها، ويُعلَّم الفحص بأنه غير مكتمل.

Spring Boot وMaven وGradle

  • شجرة الاعتماديات الكاملة. تُفحص أيضًا المكتبات التي تجلبها حزم البداية والمشاريع الأم وملفات 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، ولا يُعرض الفحص غير المكتمل الخالي من النتائج على أنه سليم أبدًا.

ما يضيفه SCA Scanner

  • المستغلة المعروفة: تُعلَّم ثغرات CVE الموجودة في كتالوج Known Exploited Vulnerabilities التابع لـ CISA بـ Exploited وتُرتَّب أولًا، مع الإجراء المطلوب من CISA واستخدامها في برامج الفدية.
  • صحة الاعتماديات: الحزم المهملة والمسحوبة والمهجورة وغير النشطة مخاطر صيانة؛ والحزم القديمة للعلم فقط. ولا توصف حزمة بأنها معرّضة للثغرات لمجرد أنها قديمة.
  • المشاريع: تُعرض مشاريع Maven متعددة الوحدات وبنى Gradle ومساحات عمل npm وYarn وpnpm وBun مع إصدار Spring Boot الخاص بها. افحصها كلها أو حدّد ما تريد.
  • علامات التبويب: Vulnerabilities وRemediation وDependency health وDependencies وSources & notes، التي تعرض حالة كل مصدر تنبيهات والمدة التي استغرقتها كل مرحلة.

إصلاحات تراعي Spring Boot

يسجّل SCA Scanner مصدر كل إصدار مُدار — ملف POM الخاص بك، أو spring-boot-starter-parent، أو BOM يستورده Boot، أو BOM تستورده أنت — ويقترح الإصلاح في مكانه الصحيح، بدءًا بالأكثر أمانًا:

  1. رقِّ Spring Boot إلى أدنى إصدار يدير ملف BOM فيه إصدارًا مصحّحًا: إصدارات التصحيح أولًا، ثم الثانوية، ثم الرئيسية (مع التنبيه إلى Java 17 وjakarta.* في Boot 3).
  2. تجاوز خاصية Boot ‏(tomcat.version وsnakeyaml.version) أو خاصية BOM المتداخل (spring-framework.version)، لتنتقل عائلة المكتبات معًا.
  3. ثبّته في <dependencyManagement> الخاص بك حين يحدده BOM مستورد. وفي Gradle: رقِّ إضافة Boot أو اضبط ext['…'].
مثال: تجاوز خاصية Boot

عندما يتأثر Tomcat ويكون إصدار Boot الأحدث قفزة كبيرة جدًا، يمكن للماسح أن يقترح الخاصية التي يقرؤها BOM في Spring Boot:

pom.xml
<properties>
  <tomcat.version>10.1.35</tomcat.version>
</properties>

ينتقل كل عنصر Tomcat يديره Boot إلى ذلك الإصدار معًا.

تحصل الاعتماديات المباشرة على تعديل للإصدار في pom.xml أو build.gradle أو package.json أو requirements.txt أو .csproj أو composer.json أو Cargo.toml؛ وتحصل اعتماديات npm غير المباشرة على overrides أو resolutions أو pnpm.overrides.

نصيحة

لا يتغير شيء من تلقاء نفسه. يفتح Preview Change فرقًا، ويطلب Apply… أو Run… التأكيد أولًا. تحافظ التعديلات على تنسيقك وعوامل النطاقات، ولا تُعدَّل ملفات القفل أبدًا، ولا يُثبَّت أو يُبنى شيء. والتعديلات معطّلة في مساحات العمل غير الموثوقة.

الخصوصية

الخدمةما تتلقاه
OSV.devأسماء الحزم وإصداراتها
سجلات الحزم (فحوصات صحة SCA)أسماء الحزم
NVD ‏(SCA)معرّفات CVE
Maven Centralإحداثيات POM وBOM
CISA ‏(SCA)لا شيء: يُنزَّل الكتالوج العام

لا تُرسل أبدًا الشيفرة المصدرية أو محتوى الملفات أو المسارات أو أسماء المشاريع أو بيانات الاعتماد.

تنبيه

تُبلغ الماسحات عن الإصدارات المتأثرة؛ ولا تتحقق مما إذا كانت شيفرتك تستدعي الدالة المعرّضة للثغرة. ولا يُبلَّغ إلا عن التنبيهات المنشورة في OSV وقت الفحص. احفظ ملفات القفل في المستودع: فمن دونها تكون النتائج Potential فقط.