ماذا يفعل DefectDojo
DefectDojo مشروع رئيسي من مشاريع OWASP، منشور بترخيص BSD-3-Clause ومكتوب بلغة Python مع Django. إنه ليس أداة فحص: لا يبحث عن الثغرات بنفسه. بل يستقبل تقارير أدوات الفحص لديك — أكثر من 200 صيغة معروفة — ويحوّلها إلى نتائج مرتبة في تسلسل بسيط: نوع المنتج، المنتج، الحملة (*engagement*)، الاختبار.
تكمن قيمته فيما يفعله بهذه النتائج: يتعرف على الثغرة نفسها حين تظهر مرتين، ويغلق ما اختفى في الفحص التالي، ويُرفق بكل نتيجة خطورة ومسؤولًا ومهلة، ويحتفظ بأثر كل قرار — بما في ذلك قبول المخاطر.
ما يقدمه لك DefectDojo
- قائمة واحدة — نتائج Trivy وSemgrep وGitleaks وZAP وBurp وNessus في مكان واحد وبصيغة واحدة.
- إزالة التكرار — الثغرة التي تكتشفها أداتان، أو تظهر في كل بناء، تظهر مرة واحدة فقط.
- إعادة الاستيراد — يغلق التقرير الجديد النتائج المصلَحة ويضيف الجديدة من دون فقدان التاريخ.
- مهل الإصلاح (SLA) — مهلة لكل درجة خطورة، مع إبراز النتائج المتأخرة.
- قرارات موثقة — إيجابي كاذب أو خارج النطاق أو مخاطرة مقبولة حتى تاريخ محدد، مع التبرير.
- API كاملة وتكامل Jira — استيراد من CI، وتذاكر تُنشأ وتُزامَن، وتقارير للعملاء والمدققين.
تقارير متفرقة أم DefectDojo على خادمك
مرّر الجدول أفقيًا
| تقارير متروكة في CI | مع DefectDojo على خادمك | |
|---|---|---|
| أين تُقرأ النتائج | سجل لكل أداة ولكل بناء | قائمة واحدة لكل منتج |
| التكرار | كل بناء يكرر الثغرات نفسها | إزالة تلقائية للتكرار |
| الثغرة المصلَحة | تحقق يدوي | تُغلق عند إعادة الاستيراد |
| مهلة الإصلاح | لا متابعة | SLA لكل خطورة والتأخير ظاهر |
| الدليل للتدقيق | يجب إعادة بنائه | تاريخ مؤرَّخ لكل نتيجة |
تجهيز الخادم
خصّص خادم VPS بنظام Ubuntu 24.04 بذاكرة 2 غيغابايت ومعالجين افتراضيين على الأقل: تستهلك الحاويات مجتمعة نحو 700 ميغابايت في وضع الخمول. انتقل إلى 4 غيغابايت إذا كنت تستورد تقارير مع كل بناء لعدة منتجات، لأن عامل Celery هو من يعالج الاستيراد وإزالة التكرار. احسب 20 غيغابايت من القرص.
تحتاج أيضًا إلى Docker مع إضافة Compose، واسم نطاق (أو نطاق فرعي) يشير إلى الخادم: سترسل خطوط CI تقاريرها إلى هذا العنوان عبر HTTPS.
تثبيت DefectDojo باستخدام Docker Compose
تجهيز المجلد وملف .env
يحمل الملف النطاق وكلمة مرور قاعدة البيانات وكلمة مرور حساب admin ومفتاحي التطبيق.
mkdir -p /opt/defectdojo && cd /opt/defectdojo cat > .env <<EOF DOMAIN=defectdojo.example.com DB_PASSWORD=$(openssl rand -hex 16) ADMIN_PASSWORD=$(openssl rand -hex 12) SECRET_KEY=$(openssl rand -hex 24) AES_KEY=$(openssl rand -hex 16) EOF chmod 600 .envكتابة ملف docker-compose.yml
سبع خدمات: PostgreSQL وValkey (طابور المهام والتخزين المؤقت) والمهيّئ والتطبيق (uWSGI) وعامل Celery ومُجدوِله وخادم nginx الرسمي لـ DefectDojo. تأتي الصور من Docker Hub. يُنشر المنفذ على الواجهة المحلية فقط: وحده nginx الخاص بالخادم سيواجه الإنترنت.
x-dd-env: &dd-env DD_DATABASE_URL: postgresql://defectdojo:${DB_PASSWORD}@postgres:5432/defectdojo DD_CELERY_BROKER_URL: redis://valkey:6379/0 DD_CACHE_URL: redis://valkey:6379/1 DD_SECRET_KEY: ${SECRET_KEY} DD_CREDENTIAL_AES_256_KEY: ${AES_KEY} DD_ALLOWED_HOSTS: "*" DD_SITE_URL: https://${DOMAIN} DD_CSRF_TRUSTED_ORIGINS: https://${DOMAIN} DD_SECURE_PROXY_SSL_HEADER: "True" services: postgres: image: postgres:18.6-alpine restart: unless-stopped environment: POSTGRES_DB: defectdojo POSTGRES_USER: defectdojo POSTGRES_PASSWORD: ${DB_PASSWORD} volumes: - postgres:/var/lib/postgresql/data healthcheck: test: ["CMD-SHELL", "pg_isready -q -U defectdojo"] interval: 10s retries: 30 valkey: image: valkey/valkey:9.1.2-alpine restart: unless-stopped volumes: - valkey:/data initializer: image: defectdojo/defectdojo-django:3.5.202 restart: "no" depends_on: postgres: condition: service_healthy entrypoint: ["/wait-for-it.sh", "postgres:5432", "--", "/entrypoint-initializer.sh"] environment: <<: *dd-env DD_INITIALIZE: "true" DD_ADMIN_USER: admin DD_ADMIN_MAIL: [email protected] DD_ADMIN_PASSWORD: ${ADMIN_PASSWORD} uwsgi: image: defectdojo/defectdojo-django:3.5.202 restart: unless-stopped depends_on: initializer: condition: service_completed_successfully entrypoint: ["/wait-for-it.sh", "postgres:5432", "--", "/entrypoint-uwsgi.sh"] environment: *dd-env volumes: - media:/app/media celerybeat: image: defectdojo/defectdojo-django:3.5.202 restart: unless-stopped depends_on: initializer: condition: service_completed_successfully entrypoint: ["/wait-for-it.sh", "postgres:5432", "--", "/entrypoint-celery-beat.sh"] environment: *dd-env celeryworker: image: defectdojo/defectdojo-django:3.5.202 restart: unless-stopped depends_on: initializer: condition: service_completed_successfully entrypoint: ["/wait-for-it.sh", "postgres:5432", "--", "/entrypoint-celery-worker.sh"] environment: *dd-env volumes: - media:/app/media nginx: image: defectdojo/defectdojo-nginx:3.5.202 restart: unless-stopped depends_on: [uwsgi] ports: - "127.0.0.1:8080:8080" volumes: - media:/usr/share/nginx/html/media volumes: postgres: {} valkey: {} media: {}تشغيل الحزمة
يطبّق المهيّئ عمليات الترحيل ويحمّل البيانات المرجعية وينشئ حساب
adminبكلمةADMIN_PASSWORDثم يتوقف. تنتظر الخدمات الأخرى انتهاءه: احسب بضع دقائق في التشغيل الأول.docker compose up -d docker compose logs -f initializer curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8080/loginيجيب الأمر الأخير بـ
200عندما تصبح الواجهة جاهزة.
حدّد كلمة مرور admin بنفسك
من دون DD_ADMIN_PASSWORD، يولّد DefectDojo كلمة مرور عشوائية ولا يكتبها إلا في سجل المهيّئ، الذي يستطيع أي مستخدم في مجموعة docker قراءته. ضعها في ملف .env وغيّرها عند أول دخول إذا كان لأشخاص آخرين وصول إلى الخادم. ولا تنسَ DD_CSRF_TRUSTED_ORIGINS: خلف وكيل HTTPS، يرفض Django نموذج الدخول من دونه (خطأ CSRF 403).
نشر DefectDojo عبر HTTPS خلف nginx
يستقبل nginx الخاص بالخادم النطاق ويمرّر الطلبات إلى المنفذ المحلي. ارفع قيمة client_max_body_size: يتجاوز تقرير Nessus أو ZAP بسرعة الحد الافتراضي البالغ 1 ميغابايت، وسيفشل الاستيراد بخطأ 413.
server {
listen 443 ssl;
server_name defectdojo.example.com;
# Let's Encrypt (certbot --nginx)
client_max_body_size 100m;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto https;
proxy_read_timeout 300s;
}
}احصل على الشهادة بالأمر certbot --nginx -d defectdojo.example.com، ثم افتح https://defectdojo.example.com وسجّل الدخول بـ admin.
استيراد التقارير من CI
من قائمة ملفك الشخصي، افتح API v2 Key وانسخ الرمز؛ ويُفضَّل إنشاء حساب خدمة مخصص، لأن الرمز يعمل بصلاحيات صاحبه. احفظه في أسرار CI.
استخدم بعد ذلك نقطة reimport-scan بدل import-scan: فهي تحدّث الاختبار نفسه في كل بناء بدل إنشاء اختبار جديد، ويغلق الخيار close_old_findings ما اختفى. مثال لـ GitHub Actions:
- name: Send Trivy report to DefectDojo
run: |
trivy image --format json -o trivy.json "$IMAGE"
curl -fsS -X POST "https://$DD_HOST/api/v2/reimport-scan/" \
-H "Authorization: Token $DD_API_KEY" \
-F scan_type="Trivy Scan" -F [email protected] \
-F product_type_name="Applications" -F product_name="my-app" \
-F engagement_name="ci-main" -F auto_create_context=true \
-F close_old_findings=true -F minimum_severity=Lowيعمل الاستدعاء نفسه من GitLab CI أو Jenkins؛ وحده scan_type يتغير من أداة إلى أخرى (Semgrep JSON Report وGitleaks Scan وZAP Scan…).
الفرز وتحديد المهل وقبول المخاطر
في Configuration → SLA Configuration، حدّد مهلة لكل درجة خطورة، مثل 7 أيام للثغرة الحرجة و30 يومًا للعالية: تبرز النتائج المتأخرة في لوحة التحكم. يمكن بعد ذلك وسم كل نتيجة بأنها إيجابي كاذب أو خارج النطاق أو مشمولة بقبول مخاطرة مؤرَّخ مع تبريره. اربط Jira من Configuration → JIRA لإنشاء تذكرة لكل نتيجة أو لكل مجموعة نتائج ومزامنة الحالات.
النسخ الاحتياطي والتحديث
كل الحالة المفيدة موجودة في PostgreSQL، إضافة إلى المرفقات في وحدة التخزين media. انسخ قاعدة البيانات احتياطيًا كل ليلة:
cd /opt/defectdojo
docker compose exec -T postgres pg_dump -U defectdojo defectdojo | gzip > /root/defectdojo-$(date +%F).sql.gzللتحديث، غيّر رقم إصدار صور defectdojo الثلاث في ملف Compose ثم نفّذ docker compose pull && docker compose up -d: يعيد المهيّئ تطبيق عمليات الترحيل قبل إعادة تشغيل التطبيق. اقرأ ملاحظات الإصدار قبل تخطي عدة إصدارات دفعة واحدة.
DefectDojo بنقرة واحدة على ServOrbit
على خادم ServOrbit، يُثبَّت DefectDojo من المتجر: صور رسمية، وPostgreSQL وValkey، وحساب admin يُنشأ بكلمة مرور مولَّدة تظهر في مساحة العميل، ووكيل عكسي nginx عبر HTTPS على نطاقك أو على النطاق الفرعي المجاني للخادم. اجمعه مع Dependency-Track لتبعياتك ومع SonarQube لجودة الشيفرة: يستطيع DefectDojo استيراد نتائجهما.
servorbit.com/ma-ar/المدونة/استضافة-defectdojo-على-vps