ما الذي يفعله Dependency-Track
Dependency-Track مشروع رائد من مشاريع OWASP، منشور برخصة Apache-2.0. لا يقرأ شيفرتك: بل يقرأ جرد ما يتضمّنه تطبيقك، أي قائمة SBOM (Software Bill of Materials)، بصيغة CycloneDX. يُعرَّف كل مكوّن فيها بعنوان Package URL الخاص به (pkg:npm/[email protected]، pkg:maven/…)، ما يتيح مطابقته دون لبس مع قواعد بيانات الثغرات: NVD وGitHub Advisories وOSV.
الفرق بينه وبين ماسح يُشغَّل في خط CI مسألة زمن. فالماسح يحكم على بناء اليوم؛ أما Dependency-Track فيحتفظ بكل إصدارات كل مشاريعك ويعيد تقييمها كلما تحدّثت قواعد بياناته. الثغرة التي تُنشر بعد ثلاثة أشهر ستُرصد على الإصدار الذي تنشره اليوم.
ما يقدّمه لك Dependency-Track
- محفظة مشاريع — كل تطبيق وكل إصدار، مع قائمة مكوّناته المباشرة والمتعدّية.
- تنبيهات بأثر رجعي — الثغرة المنشورة بعد النشر تظهر على الإصدارات العاملة في الإنتاج.
- سياسات — تراخيص محظورة، وأقصى درجة خطورة مقبولة، ومكوّنات ممنوعة، تُقيَّم مع كل إرسال لقائمة SBOM.
- فرز الثغرات — درجة الخطورة، ومؤشر EPSS لاحتمال الاستغلال، ومتابعة للتحليلات («غير معني»، «مُصحَّح»…).
- إشعارات — Slack أو Microsoft Teams أو webhook أو البريد الإلكتروني، حسب المشروع ودرجة الخطورة.
- واجهة API كاملة — إرسال قوائم SBOM وقراءة النتائج والإدارة، مع مفاتيح API لكل فريق.
ماسح لمرة واحدة أم Dependency-Track على خادمك
مرّر الجدول أفقيًا
| ماسح يُشغَّل في خط CI | مع Dependency-Track على خادمك | |
|---|---|---|
| توقيت التحليل | عند البناء، ثم لا شيء | مع كل بناء، ثم باستمرار |
| ثغرة منشورة بعد النشر | غير مرئية حتى البناء التالي | تُرصد على الإصدارات العاملة في الإنتاج |
| النظرة الشاملة | تقرير لكل مستودع | المحفظة كاملة، مع البحث حسب المكوّن |
| التراخيص | حسب الأداة | سياسات تراخيص صريحة |
| أين يقيم الجرد | في سجلات CI | على خادمك، مع سجلّه التاريخي |
تجهيز الخادم
جهّز خادم VPS بنظام Ubuntu 24.04 بذاكرة 4 غيغابايت ومعالجين افتراضيين على الأقل: خادم API، المكتوب بلغة Java، محدود بـ 2 غيغابايت، ويتقاسم PostgreSQL الباقي مع النظام. وإذا تجاوزت بضع عشرات من المشاريع المحللة يوميًا، فانتقل إلى 8 غيغابايت. واحسب 30 غيغابايت من القرص.
ثبّت Docker وإضافة Compose، ثم وجّه نطاقًا فرعيًا (مثلًا dtrack.example.com) إلى عنوان IP الخاص بالخادم: سترسل خطوطك قوائم SBOM إلى هذا العنوان، وستُفتح واجهة الويب عليه.
curl -fsSL https://get.docker.com | sh
docker compose versionتثبيت Dependency-Track باستخدام Docker Compose
تجهيز المجلد وملف `.env`
يحمل الملف كلمة مرور قاعدة PostgreSQL وكلمة مرور حساب admin.
mkdir -p /opt/dependency-track && cd /opt/dependency-track cat > .env <<EOF DB_PASSWORD=$(openssl rand -hex 16) ADMIN_PASSWORD=$(openssl rand -hex 16) EOF chmod 600 .envكتابة إعدادات الوكيل الداخلي
تستدعي واجهة الويب واجهة API على عنوانها هي. لذلك يوجّه nginx صغير المسار
/apiإلى خادم API وكل ما عداه إلى الواجهة: منفذ واحد للنشر، ونطاق واحد، ودون أي ضبط لـ CORS.server { listen 80; client_max_body_size 64m; location /api/ { proxy_pass http://apiserver:8080; proxy_set_header Host $host; proxy_set_header X-Forwarded-Proto $scheme; proxy_read_timeout 300s; } location / { proxy_pass http://frontend:8080; proxy_set_header Host $host; } }احفظ هذه الكتلة في
/opt/dependency-track/proxy.conf.كتابة ملف docker-compose.yml
أربع خدمات: PostgreSQL وخادم API والواجهة والوكيل. لا يُنشر المنفذ إلا على حلقة الاسترجاع المحلية: وحده nginx الخاص بالخادم سيكون مكشوفًا على الإنترنت.
services: db: image: postgres:18.7-alpine restart: unless-stopped environment: POSTGRES_DB: dtrack POSTGRES_USER: dtrack POSTGRES_PASSWORD: ${DB_PASSWORD} volumes: - db:/var/lib/postgresql healthcheck: test: ["CMD-SHELL", "pg_isready -q -U dtrack -d dtrack"] interval: 10s retries: 30 apiserver: image: ghcr.io/dependencytrack/apiserver:5.2.2 restart: unless-stopped depends_on: db: condition: service_healthy deploy: resources: limits: memory: 2g environment: DT_DATASOURCE_URL: jdbc:postgresql://db:5432/dtrack DT_DATASOURCE_USERNAME: dtrack DT_DATASOURCE_PASSWORD: ${DB_PASSWORD} volumes: - data:/data frontend: image: ghcr.io/dependencytrack/frontend:5.2.2 restart: unless-stopped environment: API_BASE_URL: "" proxy: image: nginx:1.27-alpine restart: unless-stopped depends_on: [apiserver, frontend] ports: - "127.0.0.1:8127:80" volumes: - ./proxy.conf:/etc/nginx/conf.d/default.conf:ro volumes: db: {} data: {}تشغيل الحزمة
ينشئ التشغيل الأول مخطط قاعدة البيانات، ثم ينزّل خادم API قواعد بيانات الثغرات في الخلفية.
docker compose up -d curl -s http://127.0.0.1:8127/api/versionيردّ الأمر الثاني برقم إصدار الخادم فور جاهزية واجهة API.
استبدال كلمة مرور المصنع
يُنشأ الحساب
adminبكلمة المرورadmin. استبدلها قبل أي نشر:. ./.env curl -fsS http://127.0.0.1:8127/api/v1/user/forceChangePassword \ --data-urlencode username=admin --data-urlencode password=admin \ --data-urlencode newPassword="$ADMIN_PASSWORD" \ --data-urlencode confirmPassword="$ADMIN_PASSWORD"
لا تنشر مثيلًا بكلمة المرور admin/admin أبدًا
يفرض Dependency-Track فعلًا تغيير كلمة المرور عند أول تسجيل دخول، لكن بين التشغيل وهذا الدخول يستطيع أيٌّ كان أن يفعل ذلك بدلًا منك ويستولي على جرد تطبيقاتك — أي على قائمة ثغراتها. استبدل كلمة المرور قبل ضبط nginx.
نشر Dependency-Track عبر HTTPS خلف nginx
يستقبل nginx الخاص بالخادم النطاق ويمرّر الطلبات إلى المنفذ المحلي. ارفع الحدّ الأقصى لحجم الإرسال: فقائمة SBOM لتطبيق كبير تتجاوز سريعًا الميغابايت الواحد الذي يقبله nginx افتراضيًا.
server {
server_name dtrack.example.com;
client_max_body_size 64m;
location / {
proxy_pass http://127.0.0.1:8127;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}ثم أصدر الشهادة بالأمر certbot --nginx -d dtrack.example.com. افتح https://dtrack.example.com، وسجّل الدخول بالحساب admin وكلمة مرورك الجديدة، وأنشئ حسابات الفريق من Administration → Access Management.
إرسال قوائم SBOM من خط CI
من Administration → Access Management → Teams، افتح فريق Automation وأنشئ مفتاح API؛ واحفظه في أسرار CI. بعد ذلك ينتج الخط قائمة SBOM ويرسلها مع كل بناء — هنا باستخدام cdxgen، الذي يتعرّف على معظم المنظومات البرمجية (npm وMaven وPyPI وComposer وGo…):
# .github/workflows/sbom.yml
name: sbom
on: [push]
jobs:
sbom:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npx --yes @cyclonedx/cdxgen -o bom.json
- run: |
curl -fsS -X POST https://dtrack.example.com/api/v1/bom \
-H "X-Api-Key: ${{ secrets.DT_API_KEY }}" \
-F autoCreate=true -F projectName=${{ github.event.repository.name }} \
-F projectVersion=${{ github.ref_name }} -F [email protected]يظهر المشروع في المحفظة مع الإصدار المُرسَل. ولصورة حاوية، ينتج الأمر syft <image> -o cyclonedx-json > bom.json ما يعادل ذلك، بما فيه حزم النظام.
السياسات والإشعارات
تحوّل السياسةُ الملاحظةَ إلى قاعدة. من Policy Management، أنشئ مثلًا سياسة أمان ترصد كل ثغرة بدرجة خطورة *High* فما فوق، وسياسة تراخيص ترفض التراخيص التي يحظرها عقدك. يُقيَّم كل إرسال لقائمة SBOM، وتظهر المخالفات على المشروع.
ومن Administration → Notifications، اربط بعد ذلك قناةً — Slack أو Microsoft Teams أو webhook أو البريد الإلكتروني — بالحدثين *New Vulnerability* و*Policy Violation*، مقصورين على المشاريع المهمة. هذا التنبيه هو ما يصنع قيمة الأداة: يصل يوم نشر الثغرة، لا يوم البناء التالي.
النسخ الاحتياطي والتحديث
كل الحالة المفيدة مخزنة في PostgreSQL: المشاريع وقوائم SBOM والتحليلات والإعدادات. انسخ قاعدة البيانات احتياطيًا، أما المجلد /data فيُعاد بناؤه (وهو يحمل أساسًا قواعد بيانات الثغرات المنزّلة).
cd /opt/dependency-track
docker compose exec -T db pg_dump -U dtrack dtrack | gzip > dtrack-$(date +%F).sql.gzللتحديث، اقرأ ملاحظات الإصدار، وغيّر وسمَي الصورتين (apiserver وfrontend، دائمًا على الإصدار نفسه)، ثم شغّل docker compose pull && docker compose up -d. يرحّل خادم API المخطط عند التشغيل. واحتفظ بنسخة احتياطية حديثة قبل كل ترقية.
Dependency-Track بنقرة واحدة على ServOrbit
على خادم ServOrbit، يُثبَّت Dependency-Track من المتجر: الصور الرسمية وPostgreSQL والوكيل الداخلي جاهزة، وكلمة مرور المصنع لحساب admin مستبدلة بكلمة مرور مولّدة تُعرض في مساحة العميل، والوكيل العكسي nginx عبر HTTPS على نطاقك أو على النطاق الفرعي المجاني للخادم. لا يبقى عليك سوى إنشاء مفتاح API لخط CI وإرسال أول قائمة SBOM.
servorbit.com/ma-ar/المدونة/استضافة-dependency-track-على-vps