الاستضافة الذاتية

DefectDojo على VPS: إدارة الثغرات في مكان واحد

Trivy في خط CI، وSemgrep على طلبات الدمج، وفحص ZAP كل أسبوع، واختبار اختراق كل سنة: كل أداة تُصدر تقريرها بصيغتها الخاصة، ولم يعد أحد يعرف أي ثغرة أُصلحت. يجمع OWASP DefectDojo كل هذه النتائج في قائمة واحدة، ويزيل التكرار، ويغلق ما اختفى، ويحدد لكل نتيجة مهلة للإصلاح. يشرح هذا الدليل تثبيته على VPS باستخدام Docker Compose ونشره عبر HTTPS خلف nginx وربطه بخط الإنتاج لديك.

انشر على VPS Cloud ←
7 دقائق للقراءةعدد الخطوات: 3
المحتويات· ماذا يفعل DefectDojo1/11
  1. 01ماذا يفعل DefectDojo
  2. 02ما يقدمه لك DefectDojo
  3. 03تقارير متفرقة أم DefectDojo على خادمك
  4. 04تجهيز الخادم
  5. 05تثبيت DefectDojo باستخدام Docker Compose
  6. 06حدّد كلمة مرور admin بنفسك
  7. 07نشر DefectDojo عبر HTTPS خلف nginx
  8. 08استيراد التقارير من CI
  9. 09الفرز وتحديد المهل وقبول المخاطر
  10. 10النسخ الاحتياطي والتحديث
  11. 11DefectDojo بنقرة واحدة على ServOrbit

ماذا يفعل 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

  1. تجهيز المجلد وملف ‎.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
  2. كتابة ملف 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: {}
  3. تشغيل الحزمة

    يطبّق المهيّئ عمليات الترحيل ويحمّل البيانات المرجعية وينشئ حساب 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

ثغراتك تحت المتابعة، على خادمك

الأسعار المعروضة قبل الضريبة، مع سعر التجديد.