AI CodeOps

معيار CycloneDX

آخر تحديث

CycloneDX هو معيار OWASP لقوائم المكونات، ومنشور أيضا باسم ECMA-424. ما الذي يحتويه ملف CycloneDX، وكيف يسجل AI CodeOps هذه الملفات ويقرؤها.

معيار CycloneDX معيار مفتوح لقوائم المكونات، نشأ في مجتمع OWASP، وتنشره أيضا منظمة Ecma International باسم ECMA-424. ومستند CycloneDX يسرد المكونات في برنامج ما، مع إصداراتها ومعرفاتها وتراخيصها والعلاقات بينها، بصيغة JSON أو XML أو Protocol Buffers.

التعريف

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

وهذا شكل أصغر قائمة SBOM بصيغة CycloneDX JSON:

{
  "bomFormat": "CycloneDX",
  "specVersion": "1.5",
  "metadata": { "component": { "name": "checkout", "version": "2.4.0" } },
  "components": [
    {
      "type": "library",
      "name": "express",
      "version": "4.19.2",
      "purl": "pkg:npm/[email protected]",
      "licenses": [{ "license": { "id": "MIT" } }]
    }
  ]
}

يعرّف الحقلان bomFormat و specVersion المستند. ولكل مكون نوع واسم وإصدار، وعادة عنوان حزمة (purl) ومعرفات تراخيص من قائمة تراخيص SPDX.

الأهمية

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

في AI CodeOps

يستخدم AI CodeOps معيار CycloneDX في موضعين.

سجلات SBOM. حين تسجل قائمة SBOM لمشروع، تكون قيمة format هي cyclonedx (أو spdx)، وقيمة formatVersion هي specVersion الخاصة بالمستند. وترسل أيضا licenseSummary، وهو عدد المكونات لكل ترخيص، وتبنيه من إدخالات licenses في الملف، كما يلي:

{ "format": "cyclonedx", "formatVersion": "1.5", "licenseSummary": { "MIT": 301, "Apache-2.0": 74 } }

هذا الملخص هو ما تقرؤه سياسة التراخيص في فحص الإصدار. ولا يحلل AI CodeOps الملف وقت التسجيل، فأعد الملخص من الملف نفسه الذي تسجل تجزئة SHA-256 الخاصة به. والطلب الكامل في صفحة الأمان و SBOM.

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

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

هل CycloneDX أفضل من SPDX؟

لا أحد منهما أفضل بوجه عام. فكلاهما يصف المكونات والتراخيص. نشأ CycloneDX من حالات الاستخدام الأمنية، ونشأ SPDX من الامتثال للتراخيص. ويسجل AI CodeOps أيا منهما.

هل يرفع عارض SBOM في AI CodeOps ملفي؟

لا. يحلل ملف CycloneDX بصيغة JSON داخل متصفحك، ولا يرسله إلى أي مكان أبدا.

هل يقرأ AI CodeOps ملف CycloneDX حين أسجل قائمة SBOM؟

لا. يخزن الأرقام التي ترسلها، وتجزئة SHA-256، ورابطا إلى الملف. أما ملخص التراخيص فيأتي منك.