AI CodeOps

ما قائمة SBOM؟ محتواها وأنواعها وطريقة استخدامها

آخر تحديث

قائمة مكونات البرمجيات بالتفصيل: ما الذي تتضمنه، ومعرفات المكونات، وأنواع قوائم SBOM من التصميم حتى التشغيل، وطريقة إنشائها، وموقع بيانات VEX منها.

قائمة مكونات البرمجيات (SBOM) جرد قابل للقراءة آليا للمكونات التي يتكون منها برنامج ما: كل مكتبة أو حزمة أو وحدة، مع إصدارها ومورّدها ومعرفاتها وترخيصها وعلاقاتها بغيرها. ومثل قائمة المواد التي يعدها المصنّع لمنتج مادي، تتيح لك معرفة ما في الداخل دون تفكيك المنتج. وقيمتها تأتي مما تفعله بها: أن تجد البرمجيات المتأثرة خلال دقائق حين تعلن ثغرة، وأن تفحص التراخيص على كل تغيير، وأن تبين للعملاء والمدققين ما تطلقه.

وتتعمق هذه الصفحة في قسم SBOM من صفحة ما أمن سلسلة توريد البرمجيات؟.

ما الذي تتضمنه قائمة SBOM

في 2021 نشرت الإدارة الوطنية للاتصالات والمعلومات في الولايات المتحدة (NTIA) الحد الأدنى من عناصر قائمة SBOM. وهي تنقسم إلى ثلاث مجموعات.

حقول البيانات لكل مكون: اسم المورّد، واسم المكون، والإصدار، والمعرفات الفريدة الأخرى، وعلاقة الاعتماد، ومؤلف بيانات SBOM، وطابع زمني.

دعم الأتمتة: أن تكون قائمة SBOM بصيغة قابلة للقراءة آليا تستطيع الأدوات إنشاءها واستهلاكها. وقد سمّت NTIA صيغ SPDX و CycloneDX ووسوم SWID.

الممارسات والعمليات: متى تنتج قائمة SBOM (مع كل بناء أو إصدار جديد)، وإلى أي عمق تذهب (المكونات من المستوى الأعلى على الأقل، مع تفاصيل كافية للعثور على المكونات غير المباشرة)، وكيف تسجل «المجاهيل المعروفة» حيث تكون شجرة التبعيات ناقصة، وكيف توزع ومن يجوز له الوصول إليها، وكيف تصحح الأخطاء.

ومعظم المولدات تضيف أكثر من الحد الأدنى: بيانات التراخيص، وتجزئات الملفات، والأداة التي أنتجت القائمة، وأحيانا إشارات إلى الثغرات.

معرفات المكونات

لا تكون قائمة SBOM أنفع من معرفاتها. فعبارة «openssl، الإصدار 3» يصعب مطابقتها مع أي شيء؛ أما المعرف الدقيق فيمكن مطابقته آليا مع قواعد بيانات الثغرات وقوائم التراخيص.

  • عنوان الحزمة (purl). سلسلة نصية تسمي الحزمة داخل منظومتها، مثل pkg:npm/[email protected] أو pkg:pypi/[email protected]. وتستخدمه أدوات المصدر المفتوح على نطاق واسع.
  • معرف CPE (Common Platform Enumeration). نظام تسمية تستخدمه قاعدة بيانات الثغرات الوطنية الأمريكية لتحديد المنتجات التي تؤثر فيها الثغرة.
  • التجزئات. تجزئات تشفيرية للملفات أو الحزم، تعرّف مخرجا محددا تماما بصرف النظر عن اسمه.

المكون الذي له عنوان purl وتجزئة يمكن مطابقته بموثوقية. أما المكون الذي ليس له إلا اسم وإصدار فكثيرا ما يتعذر ذلك.

شكل قائمة SBOM

هذه قائمة SBOM مصغرة بصيغة CycloneDX JSON، مختصرة إلى تطبيق واحد وتبعية واحدة:

{
  "bomFormat": "CycloneDX",
  "specVersion": "1.5",
  "version": 1,
  "metadata": {
    "timestamp": "2026-10-21T09:30:00Z",
    "component": { "type": "application", "name": "checkout", "version": "2.4.0", "bom-ref": "checkout" }
  },
  "components": [
    {
      "type": "library",
      "bom-ref": "pkg:npm/[email protected]",
      "name": "lodash",
      "version": "4.17.21",
      "purl": "pkg:npm/[email protected]",
      "licenses": [{ "license": { "id": "MIT" } }]
    }
  ],
  "dependencies": [{ "ref": "checkout", "dependsOn": ["pkg:npm/[email protected]"] }]
}

تصف كتلة metadata موضوع القائمة ووقت إنشائها. وكل إدخال في components مكون واحد مع معرفاته وترخيصه. وتسجل كتلة dependencies أي مكون يعتمد على أي مكون، لكي يمكن إعادة بناء الشجرة. ويسجل SPDX المعلومات نفسها ببنية وأسماء مختلفة. وللمقارنة بين الصيغتين، راجع المقارنة بين CycloneDX و SPDX.

أنواع قوائم SBOM: متى أنشئت في دورة الحياة

قائمة SBOM المنشأة من مستند تصميم تقول شيئا مختلفا عن قائمة منشأة من حاوية تعمل. ويسمي مستند أصدرته CISA في 2023 بعنوان Types of Software Bill of Material (SBOM) Documents ستة أنواع:

النوعمصدر إنشائهاما تخبرك به
التصميم (Design)الخطط أو المتطلبات، قبل وجود البرنامجما يعتزم إدراجه
المصدر (Source)مستودع المصدر وملفات تعريف التبعيات فيهما يعلن الكود أنه يعتمد عليه
البناء (Build)عملية البناء، من التبعيات المحلولةما دخل في عملية بناء بعينها
المحللة (Analyzed)فحص مخرج مبني، مثل صورة حاويةما تجده أداة فحص في المخرج
المنشورة (Deployed)البرنامج كما هو مثبت في بيئة ماما هو موجود حيث يعمل، ومنه الإعدادات
وقت التشغيل (Runtime)مراقبة النظام وهو يعملما يحمّل وينفذ فعلا

وللاستجابة للثغرات وفحص التراخيص، تكون قائمة البناء عادة أنفع نقطة بداية: فهي تعكس الإصدارات المحلولة، ومنها التبعيات غير المباشرة، لمخرج أطلقته فعلا.

كيف تنشأ قوائم SBOM

تنتج قوائم SBOM بالأدوات، لا بالكتابة اليدوية. فالمولدات تقرأ ملفات القفل وملفات تعريف التبعيات، أو تفحص المخرجات المبنية أو صور الحاويات، أو ترتبط بعملية البناء نفسها. ومن الأمثلة مفتوحة المصدر Syft و Trivy و cdxgen، ولكثير من منظومات البناء إضافاتها الخاصة.

وللحصول على قائمة SBOM يمكنك الاعتماد عليها:

  • أنشئها في CI، من البناء. فذلك يربطها بمخرج وإيداع، ويزيل الخطوة التي ينساها الناس.
  • استخدم الإصدارات المحلولة. ملف تعريف التبعيات بنطاقات إصدارات يقول ما المسموح به؛ أما ملف القفل أو المخرج المبني فيقول ما الذي استخدم.
  • ضمّنها التبعيات غير المباشرة، وسجل المواضع التي تكون فيها الشجرة ناقصة.
  • خزنها مع الإصدار، مع تجزئة، لتستطيع استرجاع قائمة SBOM لما كان يعمل في وقت معين.
  • افحصها. افتح بضع قوائم وتأكد من أن المكونات والإصدارات والتراخيص تبدو صحيحة. فالمولد المضبوط على مجلد خاطئ ينتج قائمة SBOM صالحة وشبه فارغة.

استخدام قائمة SBOM

  • الاستجابة للثغرات. طابق معرفات المكونات مع التنبيهات الأمنية. وحين تعلن ثغرة جديدة، ابحث في قوائم SBOM المخزنة لديك بدل البحث في كل مستودع.
  • الامتثال للتراخيص. اجمع التراخيص عبر المكونات وقارنها بسياستك، على كل تغيير لا عند الإصدار فقط.
  • الجرد وتتبع نهاية الدعم. اعثر على المكونات التي بلا صيانة أو التي تجاوزت تاريخ انتهاء دعمها.
  • طلبات العملاء والجهات التنظيمية. في الولايات المتحدة، دفع الأمر التنفيذي 14028 قوائم SBOM إلى مشتريات البرمجيات الفدرالية. وفي الاتحاد الأوروبي، يشترط قانون المرونة السيبرانية على مصنعي المنتجات ذات العناصر الرقمية إعداد قائمة SBOM، تغطي التبعيات من المستوى الأعلى على الأقل، جزءا من وثائقهم الفنية.

قوائم SBOM وبيانات VEX

تقول قائمة SBOM ما هو موجود. وأداة فحص الثغرات التي تطابقها مع التنبيهات الأمنية ستنبه إلى كل مكون فيه ثغرة معروفة، ومنها المكونات التي لا يستدعى فيها الكود المعرض للثغرة أبدا. وتسجل بيانات VEX (Vulnerability Exploitability eXchange) تقييم المورّد لكل حالة، بحالات مثل غير متأثر، ومتأثر، ومصلح، وقيد التحقيق، مع مسوغ لحالة «غير متأثر»، مثل أن الكود المعرض للثغرة غير موجود أو لا يمكن الوصول إليه.

ويمكن نشر بيانات VEX بصيغة CycloneDX، أو بصيغة CSAF، أو في مستندات OpenVEX. ومعا، تتيح قائمة SBOM وبيانات VEX للعميل أن يعرف أي نتائج أداة الفحص تحتاج إلى إجراء.

كيف يفعل AI CodeOps ذلك

يتتبع AI CodeOps قوائم SBOM لكل مشروع، بصيغة CycloneDX أو SPDX. ولا ينشئها: فأنت تنشئ القائمة بأداتك المعتادة، وتحفظ الملف مع مخرجات البناء، وتسجل لقطة منها مع صيغتها وإيداعها وتجزئتها ورابط تنزيلها وعدد مكوناتها وملخص تراخيصها. وفي مرحلة بيتا المفتوحة تسجل اللقطة بطلب إلى /api/sbom من جلسة مسجلة الدخول؛ أما تسجيلها من CI بمفتاح API فغير متاح بعد.

ويستطيع فحص الإصدار الذي يستدعيه CI لديك أن يرفض التغيير حين تحتوي أحدث قائمة SBOM للمشروع على ترخيص منعته، ويرفضه حين تكون قاعدة للتراخيص مضبوطة ولا قائمة SBOM للمشروع. وتظهر قوائم SBOM تحت Secure → Security وفي صفحة كل مشروع.

راجع الأمان و SBOM للتفاصيل، ومدخل قائمة مكونات البرمجيات (SBOM) في المسرد، وعارض SBOM المجاني الذي يفتح ملف CycloneDX بصيغة JSON داخل متصفحك دون رفعه.

الأسئلة الشائعة

ما الفرق بين قائمة SBOM وملف القفل؟

يثبت ملف القفل إصدارات التبعيات لمدير حزم واحد لتكون عمليات البناء قابلة للتكرار. أما قائمة SBOM فتصف كل مكونات البرنامج الذي أطلق بصيغة معيارية، مع المعرفات والتراخيص والعلاقات، لكي تستطيع أدوات أخرى ومؤسسات أخرى قراءتها.

هل تتضمن قائمة SBOM التبعيات غير المباشرة؟

القائمة الجيدة تتضمنها. فتبعيات تبعياتك هي مصدر معظم المكونات، وفيها توجد كثير من الثغرات. راجع إعدادات المولد لديك، وسجل الحالات التي يكون فيها العمق ناقصا.

كم مرة ينبغي أن أنشئ قائمة SBOM؟

لكل إصدار على الأقل، والأفضل لكل عملية بناء يمكن نشرها. فقائمة SBOM تصف إصدارا واحدا من البرنامج، والبناء الجديد بتبعيات مختلفة يحتاج إلى قائمة جديدة.

هل ينبغي أن أشارك قوائم SBOM مع العملاء؟

كثير من العملاء والجهات التنظيمية يطلبونها الآن. قرر من يجوز له تلقيها وكيف، لأن قائمة SBOM تبين بالضبط المكونات والإصدارات التي تشغلها.

ما بيانات VEX؟

بيانات قابلية استغلال الثغرات (Vulnerability Exploitability eXchange) بيان يذكر هل تؤثر ثغرة معروفة فعلا في منتج ما، مع حالة مثل غير متأثر أو متأثر أو مصلح أو قيد التحقيق. وهي ترافق قائمة SBOM لتقليل الضجيج الصادر عن أدوات الفحص.