AI CodeOps

خدمة Python: قائمة SBOM وبوابة للتراخيص

آخر تحديث

دقق تبعيات خدمة Python بحثا عن تراخيص الحقوق المتروكة بسير العمل Dependency Refresh، وسجل قائمة SBOM بصيغة CycloneDX، واجعل CI يرفض الإصدارات التي تطلق كود GPL.

استخدم هذا القالب

مشكلات التراخيص أرخص إصلاحا قبل الإصدار منها بعد تدقيق يجريه عميل. وهذا القالب يجعل الوكلاء يجدون تبعيات الحقوق المتروكة (copyleft) ويستبدلونها، ثم يعطي CI لديك فحصا صارما في ضوء قائمة SBOM الخاصة بالمشروع.

الوكلاء الذين يعملون

  1. Audit، ويتولاها وكيل Dependency Auditor: يقرأ pyproject.toml وملف README، ويسرد الحزم ذات تعارضات التراخيص، أو الثغرات المعروفة (من معرفة النموذج، لا من قاعدة بيانات حية)، أو التي بلا صيانة، مع مسار ترقية لكل منها.
  2. Upgrade، ويتولاها وكيل Migration Specialist: خطة الاستبدال أو الإزالة، مع ملاحظات للتراجع.
  3. Test، ويتولاها وكيل Tester: هل يبين التغيير المكتوب وتشغيل الاختبار المسجل له أن شيئا لم ينكسر، وأي الحالات ما زالت ناقصة.
  4. Verify secure، ويتولاها وكيل Security Auditor: يفحص التغيير المكتوب.

يكتب التغيير بعد خطوة Upgrade، وتعمل اختباراتك عليه. وتعمل Test و Verify secure بعد ذلك، فتقرآن الفروقات الفعلية ونتيجة اختبارها.

ولا يقرأ الوكيل إلا التبعيات المباشرة. فملفات القفل مثل poetry.lock غير مضمّنة، ولذلك تبقى تراخيص التبعيات غير المباشرة خفية عنه في الغالب؛ وهذا ما يغطيه فحص قائمة SBOM.

تعمل مجموعة اختباراتك في بيئة معزولة غير متصلة بالشبكة. وبعد الخطوة الأخيرة، يمر التغيير بمراجعة الملاحظات، والتدقيق سياق لها (وتظهر ملاحظات التبعيات في صفحة التشغيل)، وبموافقة بشرية.

سجل قائمة SBOM

لا ينشئ AI CodeOps قوائم SBOM. أنتج ملفا بصيغة CycloneDX أو SPDX بأدوات البناء لديك، ثم سجله على المشروع من جلسة مسجلة الدخول عبر /api/sbom؛ فلا يوجد في مرحلة بيتا المفتوحة نموذج رفع ولا تسجيل بمفتاح API. ويعرض تجميع التراخيص تحت Secure → Security سلاسل التراخيص كما وجدها بالضبط. وسجل قائمة SBOM جديدة بعد دمج تغيير التبعيات، لأن البوابة تقرأ أحدث قائمة للمشروع.

طبق البوابة على الإصدارات حسب التراخيص

curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
  -H "Authorization: Bearer $WORKSPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"pullRequestURL\":\"$PR_URL\",\"disallowedLicenses\":[\"GPL-3.0-only\",\"GPL-3.0-or-later\",\"AGPL-3.0-only\",\"AGPL-3.0-or-later\"]}" \
  | jq -e '.allowed == true'

المطابقة تامة ولا تتأثر بحالة الأحرف، فلا يطابق GPL-3.0 المعرف GPL-3.0-only. اذكر كل معرف كما يظهر في تجميع التراخيص في قائمة SBOM لديك. والمطابقة ترفض الإصدار مع licenseViolations. راجع الأمان و SBOM.

وللتغييرات في الكود التي تحتاج إلى تدقيق أمني لا إلى تدقيق للتبعيات، استخدم قالب تغييرات المصادقة.

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

هل ينشئ AI CodeOps قائمة SBOM؟

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

لماذا رفض الإصدار مع أنه لا توجد مخالفات للتراخيص؟

حين يضبط disallowedLicenses، لا يمكن فحص المشروع الذي لا قائمة SBOM له، فيرفض ويذكر في licenseEvidenceMissing.

هل تدقيق التراخيص استشارة قانونية؟

لا. ملاحظات الوكيل عن التراخيص تساعدك على إيجاد الحزم المرشحة. أما ما يجوز لك إطلاقه فيقرره فريقك القانوني.