🔐 تثبيت Dependency-Track — تحليل الثغرات عبر SBOM

انشر Dependency-Track على Ubuntu باستخدام Docker — منصة من OWASP تراقب باستمرار قائمة مكونات برمجياتك (SBOM) بحثاً عن الثغرات المعروفة، مع واجهة أمامية على المنفذ 8247 وAPI على المنفذ 8246.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت آلي — أمر واحد ينشر سيرفر API وواجهة Dependency-Track الأمامية على المنفذين 8246 و8247. يحتاج نحو 5 جيجابايت رام و5-10 دقائق لتحميل بيانات الثغرات.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/security/dependency-track/dependency-track-ubuntu.sh
chmod +x dependency-track-ubuntu.sh
./dependency-track-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/security/dependency-track/dependency-track-ubuntu.sh

2 منحه صلاحية التنفيذ

chmod +x dependency-track-ubuntu.sh

3 تشغيل المثبت

./dependency-track-ubuntu.sh

4 تسجيل الدخول وتغيير كلمة المرور

http://your-server-ip:8247

المنافذ المستخدمة

المنفذالغرض
8247Web frontend you log into (mapped from container port 8080)
8246API server — CI pipelines upload SBOMs here (mapped from container port 8080)

نظرة عامة

Dependency-Track هو مشروع رائد من OWASP لتحليل تركيب البرمجيات (SCA) بشكل مستمر. بدلاً من فحص الكود مرة واحدة، يستقبل قائمة مكونات برمجية (SBOM) — عادة بصيغة CycloneDX تُولَّد من خط الإنتاج (pipeline) أو أداة مثل Trivy أو Syft — ويحتفظ بجرد دائم لكل مكون في كل إصدار من كل تطبيق تسجله. يُراجَع هذا الجرد باستمرار مقابل عدة مصادر لمعلومات الثغرات، لذا عندما تُنشر ثغرة CVE جديدة لمكتبة نشرتها منذ ستة أشهر، يُنبّهك Dependency-Track فوراً بدلاً من انتظار الفحص التالي.

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

أدوات الفحص اللحظي تخبرك بما كان معرضاً للخطر يوم شغّلتها فقط. أما Dependency-Track فيخبرك بما هو معرض للخطر اليوم، عبر كامل محفظة تطبيقاتك، دون إعادة فحص أي شيء — لأن الخطر يتغير مع ظهور ثغرات CVE جديدة، لا مع تغيّر كودك. بالنسبة للفرق التي تُطلق تطبيقات وخدمات عديدة، يحوّل هذا إدارة الثغرات من مهمة يدوية تُنجَز قبل كل إصدار إلى رؤية مركزية محدّثة باستمرار لمخاطر سلسلة التوريد، يستطيع فريق الأمان فرزها من لوحة تحكم واحدة بدل ملاحقة جداول بيانات من عشرات خطوط البناء.

متى تحتاجه

  • مؤسستك تُطلق عدة تطبيقات أو خدمات مصغّرة وتحتاج رؤية مركزية واحدة لمخاطر المكونات الخارجية بدلاً من تقارير فحص منفصلة لكل مستودع
  • تحتاج إثبات الامتثال لسلسلة توريد البرمجيات وفق معايير مثل Executive Order 14028 أو NIST SSDF أو متطلبات SBOM من عملائك
  • تريد تنبيهاً تلقائياً عند نشر ثغرة CVE جديدة لمكتبة سبق أن نشرتها، دون إعادة تشغيل أي فحص
  • خط CI/CD لديك يُولّد بالفعل ملفات SBOM (عبر Syft أو Trivy أو إضافات أدوات البناء الأصلية) وتحتاج مكاناً لتخزينها وتتبعها والتنبيه بشأنها
  • تحتاج فرض سياسات امتثال الترخيص (مثل حظر مكتبات GPL في منتج مملوك) جنباً إلى جنب مع تتبع الثغرات

من يحتاجه

  • فرق أمان التطبيقات (AppSec) المسؤولة عن تتبع مخاطر المكونات الخارجية ومفتوحة المصدر عبر فرق تطوير عديدة
  • مهندسو DevSecOps الذين يبنون خطوط CI/CD تحتاج رفع SBOM آلياً وبوابات سياسات قبل النشر
  • فرق الامتثال والحوكمة المحتاجة أدلة جاهزة للتدقيق على المراقبة المستمرة للمكونات لأغراض تنظيمية أو تعاقدية
  • مزوّدو البرمجيات الملزمون بإصدار وإدارة SBOM لعملائهم كجزء من متطلبات أمان سلسلة التوريد
  • فرق هندسة المنصات التي تدير عشرات الخدمات المصغّرة وتحتاج لوحة مخاطر واحدة بدلاً من تقارير فحص متفرقة
  • المؤسسات التي تستجيب لحوادث شبيهة بـ Log4Shell وتحتاج معرفة فورية بالتطبيقات التي تستخدم مكتبة أصبحت معرضة للخطر حديثاً

حالات الاستخدام الشائعة

  • مراقبة تبعيات كل تطبيق باستمرار بحثاً عن ثغرات CVE مُكتشَفة حديثاً دون إعادة فحص الكود المصدري
  • ربط نشر خطوط CI/CD بمخالفات السياسات — منع إصدار عند اكتشاف ثغرة حرجة أو ترخيص محظور
  • الاحتفاظ بجرد قابل للاستعلام على مستوى المحفظة لكل مكون مفتوح المصدر مستخدم عبر كل التطبيقات وإصداراتها
  • توليد مستندات VEX (تبادل قابلية استغلال الثغرة) لتوضيح أي ثغرات في SBOM لديك قابلة للاستغلال فعلياً
  • تتبع الامتثال الترخيصي عبر شجرة تبعياتك ووضع علامة على تراخيص copyleft المتعارضة مع نموذج ترخيص منتجك
  • الاستجابة لثغرات يوم الصفر (مثل Log4Shell) خلال دقائق عبر الاستعلام عن التطبيقات التي تستخدم المكون والإصدار المتأثرين

الميزات الرئيسية

  • استيعاب SBOM بصيغتي CycloneDX وSPDX، مع تحويل تلقائي وإعادة تحليل دورية عند رفع ملفات SBOM جديدة
  • ربط مستمر للثغرات مقابل NVD وGitHub Advisories وSonatype OSS Index وOSV، واختيارياً Snyk
  • محرك سياسات قابل للتهيئة للسياسات الأمنية والتشغيلية وسياسات الترخيص، يمكنه وضع علامة على المخالفات أو منعها تلقائياً
  • لوحات معلومات على مستوى المحفظة تعرض درجة الخطر والمكونات المعرضة للخطر ومخالفات السياسات عبر كل مشروع وإصدار مسجّل
  • REST API مصمم للتكامل مع CI/CD — رفع SBOM والاستعلام عن النتائج برمجياً من Jenkins أو GitLab CI أو GitHub Actions
  • دعم صيغة VEX من OWASP لتوثيق ما إذا كانت ثغرة معروفة قابلة للاستغلال فعلياً في نشرتك المحددة
  • ناشرو تنبيهات لـ Slack وMicrosoft Teams والبريد الإلكتروني وwebhooks عامة عند ظهور ثغرات أو مخالفات سياسات جديدة
  • تحكم بالوصول قائم على الأدوار مع فرق وصلاحيات ومفاتيح API مخصصة لمشاريع محددة في المؤسسات متعددة الفرق

كيفية الاستخدام بعد التثبيت

  • سجّل الدخول ببيانات الاعتماد الافتراضية admin / admin وغيّر كلمة المرور فوراً — هذا مفروض عند أول تسجيل دخول
  • انتظر اكتمال التحميل الأولي لقاعدة بيانات الثغرات (نحو 5-10 دقائق) قبل أن تبدو النتائج مكتملة
  • أنشئ مشروعاً لكل تطبيق تريد تتبعه، مع إمكانية تنظيمها في تسلسل هرمي أب/ابن اختياري
  • ولّد SBOM بصيغة CycloneDX من عملية البناء لديك (عبر Syft أو cdxgen أو إضافة CycloneDX الأصلية للغتك) وارفعه للمشروع المطابق
  • أنشئ مفتاح API تحت Administration → Access Management واربطه بخط CI/CD لأتمتة رفع SBOM مع كل بناء
  • اضبط السياسات تحت Policy Management لتحديد درجات الخطورة أو التراخيص أو درجات CVSS التي تُطلق مخالفة
  • أعدّ ناشر تنبيهات (Slack أو Teams أو بريد إلكتروني أو webhook) ليصل التنبيه لفريقك فور ظهور ثغرة جديدة
  • راجع لوحة المحفظة بانتظام لفرز الثغرات المكتشَفة حديثاً عبر كل المشاريع المسجّلة

أفضل ممارسات الأمان

  • غيّر كلمة مرور admin الافتراضية فوراً — يأتي Dependency-Track ببيانات اعتماد admin/admin معروفة يجب ألا تصل للإنتاج
  • ضع الواجهة الأمامية وAPI خلف وكيل عكسي مع HTTPS — يجب ألا تنتقل بيانات الاعتماد وSBOM عبر HTTP عادي أبداً
  • قصر المنفذ 8246 (API) على أنظمة CI/CD والشبكات الموثوقة فقط — فهو يستقبل رفع SBOM ويجب ألا يكون متاحاً للعامة
  • أنشئ مفاتيح API محددة النطاق لكل فريق أو خط أنابيب بدلاً من مشاركة مفتاح بصلاحيات admin عبر كل التكاملات
  • فعّل مصادقة LDAP أو OpenID Connect للنشرات الإنتاجية بدلاً من الاعتماد فقط على الحسابات المحلية
  • خذ نسخاً احتياطية دورية من قاعدة بيانات PostgreSQL التي يستخدمها Dependency-Track — فهي تحتوي كامل سجل الثغرات وإعدادات السياسات
  • حافظ على تحديث صورة Dependency-Track — الإصدارات الجديدة غالباً ما تحسّن دقة ربط الثغرات وتصلح مشكلات أمنية
  • راجع صلاحيات الفرق دورياً وأزل وصول المستخدمين أو مفاتيح API غير المرتبطة بمشاريع نشطة

المنافذ وإعدادات جدار الحماية

تكشف النشرة الافتراضية منفذين، كلاهما معيّن من منفذ الحاوية 8080: 8247 للواجهة الأمامية التي تسجّل الدخول إليها، و8246 لسيرفر API الذي تستخدمه خطوط CI/CD لرفع SBOM والاستعلام عن النتائج. لا يجب كشف أي من المنفذين مباشرة للإنترنت العام — ضعهما خلف وكيل عكسي مع HTTPS، أو قيّد الوصول بجدار حماية على شبكة مكتبك وVPN ونطاقات IP الخاصة بمُشغّلات CI/CD. سيرفر API تحديداً يقبل طلبات غير مصادَق عليها لبعض المسارات ما لم يُهيَّأ بشكل صحيح، لذا عامل المنفذ 8246 كبنية تحتية حساسة لا كواجهة API عامة.

النسخ الاحتياطي والصيانة

  • خذ نسخة احتياطية من قاعدة بيانات PostgreSQL التي يستخدمها Dependency-Track للتخزين — تحتوي كل مشروع وSBOM ونتيجة وسياسة أعددتها
  • صدّر إعدادات السياسات وناشري التنبيهات حتى يمكن إعادة إنشائها بسرعة على نسخة جديدة
  • خذ نسخة احتياطية من docker-compose.yml وأي متغيرات بيئة مخصصة لإعادة إنشاء نفس النشرة تماماً بعد الترحيل
  • جدول نسخاً احتياطية آلية دورية لقاعدة البيانات (pg_dump) بدلاً من الاعتماد على نسخ يدوية قبل التحديثات
  • اختبر عملية الاستعادة على نسخة منفصلة دورياً — النسخة الاحتياطية التي لم تُختبَر استعادتها ليست نسخة موثوقة
  • وثّق أي مشاريع تقابل أي مستودعات وخطوط CI حتى لا يحتاج انضمام عضو فريق جديد معرفة ضمنية

الأخطاء الشائعة

  • ترك بيانات اعتماد admin/admin الافتراضية دون تغيير — هذا أكثر حادث أمني شيوعاً في Dependency-Track
  • كشف المنفذ 8246 (API) مباشرة للإنترنت دون مصادقة أو وكيل عكسي أمامه
  • رفع SBOM مرة واحدة فقط دون أتمتة العملية — قيمة Dependency-Track تأتي من المراقبة المستمرة لا الرفع لمرة واحدة
  • تجاهل مزامنة قاعدة بيانات الثغرات التي تستغرق 5-10 دقائق عند أول تشغيل وافتراض أن التثبيت معطوب لأن النتائج تبدو فارغة
  • تصغير حجم السيرفر أكثر من اللازم — يحتاج سيرفر API وحده نحو 5 جيجابايت رام، وتشغيله على VPS بـ2 جيجابايت يسبب إعادة تشغيل مستمرة
  • عدم إنشاء مشاريع منفصلة لكل تطبيق — تفريغ كل SBOM في مشروع واحد يُفقد تتبع المخاطر على مستوى المحفظة معناه
  • نسيان إعداد ناشر تنبيهات — دون ذلك تمر الثغرات الحرجة الجديدة دون ملاحظة حتى يتفقّدها أحد يدوياً
  • التعامل مع فحص نظيف على أنه دائم — مكوّن بلا ثغرات معروفة اليوم قد تُنشر له ثغرة حرجة غداً

استكشاف الأخطاء وإصلاحها

  • الواجهة الأمامية لا تعرض بيانات أو تظهر أخطاء اتصال — تحقق من سلامة حاوية سيرفر API وأن رابط API الأساسي المضبوط في الواجهة يطابق المنفذ 8246
  • فشل تسجيل الدخول ببيانات الاعتماد الافتراضية — تأكد أنك لم تُغيّر كلمة المرور بالفعل في تشغيل سابق، أو أعد ضبطها عبر admin API
  • لا تظهر ثغرات بعد رفع SBOM — انتظر اكتمال المزامنة الأولية مع NVD/OSS Index، والتي قد تستغرق 5-10 دقائق عند أول تشغيل
  • الحاوية تعيد التشغيل بشكل متكرر أو تُقتَل بسبب نفاد الذاكرة — زد الرام المتاح للسيرفر؛ يحتاج سيرفر API وحده قرابة 5 جيجابايت
  • رفع SBOM عبر API يُرجع 401 Unauthorized — تحقق أن مفتاح API يملك صلاحية BOM_UPLOAD المسندة تحت Access Management
  • مخالفات السياسات لا تظهر — تحقق أن السياسة مفعّلة ومحدَّدة النطاق للمشروع أو وسم المشروع الصحيح
  • لوحة المحفظة بطيئة مع عدد كبير من المشاريع — زد حجم مجمّع اتصالات قاعدة البيانات وتأكد أن PostgreSQL يملك موارد كافية
  • التنبيهات لا تُطلَق — اختبر إعداد ناشر التنبيهات مباشرة من Administration → Notifications قبل افتراض أن المشكلة في بيانات SBOM

البدائل

Trivy أداة فحص سريعة وخفيفة تفحص صور الحاويات وأنظمة الملفات والمستودعات ويمكنها توليد SBOM بصيغة CycloneDX — تُكمّل Dependency-Track ولا تحل محله، لأن Trivy يفحص في لحظة زمنية بينما يراقب Dependency-Track باستمرار. Grype وAnchore يقدّمان فحصاً لحظياً مشابهاً مع فرض سياسات، وغالباً ما يُقرنان بـ Syft لتوليد SBOM. Snyk منصة SaaS تجارية تقدّم مراقبة مستمرة مشابهة بواجهة أكثر صقلاً ودعم لغات أوسع، مقابل تكلفة متكررة. JFrog Xray يتكامل بعمق مع Artifactory للمؤسسات المعتمِدة عليه أصلاً. GitHub Dependabot يوفّر تنبيهات ثغرات أصلية ومجانية لمستودعات GitHub لكنه يفتقر لرؤية Dependency-Track المركزية متعددة المصادر على مستوى المحفظة. كمنصة مجانية وذاتية الاستضافة ومحايدة تجاه المزوّد تراقب باستمرار جرداً قائماً على SBOM عبر تطبيقات عديدة، يظل Dependency-Track التطبيق المرجعي الذي يبني حوله مجتمع OWASP.

متى لا تستخدمه

Dependency-Track ليس فاحص كود — فهو لا يحلل كودك المصدري بحثاً عن أخطاء ولا يقوم بتحليل ساكن (SAST)؛ إنه يتتبع فقط المكونات الخارجية المصرَّح عنها في SBOM. إذا كنت تحتاج فحصاً سريعاً لمرة واحدة لصورة أو مستودع واحد، فأداة خفيفة مثل Trivy أو Grype تعمل مباشرة داخل خط الأنابيب أسرع في الإعداد وكافية. إذا كانت مؤسستك تملك تطبيقاً صغيراً واحداً بلا خط CI/CD يؤتمت توليد SBOM، فقد لا يستحق العبء التشغيلي لتشغيل وصيانة خدمة تحتاج نحو 5 جيجابايت رام — فحص بسيط بـ trivy image قبل كل إصدار يغطي نفس الغرض ببنية تحتية أقل بكثير. كذلك لا يحل Dependency-Track محل أداة SIEM أو مراقبة مضيفين مثل Wazuh؛ فهو يعالج مخاطر مكونات سلسلة التوريد لا أحداث الأمان أثناء التشغيل.

هل تحتاج مساعدة احترافية؟

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

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

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

ما هو Dependency-Track؟

Dependency-Track منصة رائدة من OWASP لتحليل تركيب البرمجيات المستمر. يستقبل قائمة مكونات برمجية (SBOM) تصف محتوى تطبيقك، ثم يراقب هذه المكونات باستمرار مقابل عدة مصادر بيانات ثغرات — لذا عندما تؤثر ثغرة CVE جديدة على مكتبة نشرتها منذ أشهر، تعرف فوراً بدلاً من انتظار الفحص التالي.

ما المنافذ المستخدمة وما بيانات الدخول؟

سيرفر API على المنفذ 8246 والواجهة الأمامية التي تسجّل الدخول إليها على 8247 — كلاهما معيَّن من منفذ الحاوية 8080. بيانات الاعتماد الافتراضية هي admin / admin، ويُفرَض تغيير كلمة المرور عند أول تسجيل دخول.

كم يحتاج من الرام؟

يحتاج سيرفر API وحده نحو 5 جيجابايت رام، وهو أكثر بكثير من معظم الخدمات في هذه الأكاديمية. تصغير حجم السيرفر أكثر من اللازم هو السبب الأكثر شيوعاً لإعادة تشغيل الحاوية أو تعطّلها تحت الحمل.

لماذا هو بطيء أو فارغ عند أول تشغيل؟

عند أول تشغيل، يُحمّل Dependency-Track قواعد بيانات الثغرات من مصادره، وهذا يستغرق نحو 5-10 دقائق. خلال هذه الفترة قد تُظهر الواجهة أخطاء أو لا تُظهر نتائج، ما يبدو كتثبيت معطوب لكنه ليس كذلك.

كيف يرتبط بـ Trivy؟

يكمّل كل منهما الآخر بدلاً من التنافس. Trivy أداة فحص سريعة تفحص الصور وأنظمة الملفات والمستودعات ويمكنها توليد SBOM بصيغة CycloneDX. بعدها يستقبل Dependency-Track ملفات SBOM هذه ويراقب الجرد باستمرار مع نشر ثغرات جديدة.