أداة تحليل كود ثابتة مدركة للإطار لمراجعة تلقائية للكود المصدري مع قواعد خاصة بالمنصة، وتحليل التلوث، وتقدير الجهد، وخطوط أساس للكبت.
Author:
- Debasis Mohanty ([email protected])
- Twitter / X: @coffeensecurity
- www.coffeeandsecurity.com
صُمم Daksh SCRA (مساعد مراجعة الشيفرة المصدرية) لتعزيز كفاءة عملية مراجعة الشيفرة المصدرية، من خلال توفير نهج منظم ومهيكل لمراجعي الشيفرة.
بدلاً من وضع علامة على كل شيء باعتباره مشكلة محتملة بشكل عشوائي، يعزز Daksh SCRA التحليل المدروس، ويحث على التحقيق في المشكلات المحتملة وتأكيدها. يخفف هذا النهج من الاندفاع لتصنيف كل مخاوف محتملة كخطأ برمجي، مما يقلل من الارتباك والوقت الضائع في التعامل مع النتائج الإيجابية الكاذبة.
قُدّم Daksh SCRA في البداية خلال جلسة تدريبية حول مراجعة الشيفرة المصدرية في Black Hat USA 2022 (6-9 أغسطس)، حيث عُرض بشكل خفي على جمهور محدد. وجاء ظهوره العام الرسمي الأول في Black Hat USA 2023 في لاس فيغاس.
يجمع DakshSCRA قدرات مميزة لمراجعة الشيفرة المصدرية يدوياً، بدءاً من مجالات الاهتمام في مسارات الملفات وتقدير الجهد وصولاً إلى استطلاع البرمجيات والقواعد السياقية والتحليل عبر الملفات.
| الميزة | الوسم | لماذا تهم |
|---|---|---|
| مجالات الاهتمام في مسارات الملفات | الأول عالمياً* | يفحص أسماء الملفات والمجلدات نفسها، إلى جانب الشيفرة، لوضع علامة على المسارات المشبوهة مثل ملفات النسخ الاحتياطي ونقاط النهاية الخاصة بالتصحيح ومقالب الإعدادات وملفات بيانات الاعتماد التي غالباً ما يفوّتها المراجعون. |
| تقدير الجهد العلمي | الأول عالمياً* | ينتج تقديراً كمياً لجهد المراجعة اليدوية بناءً على حجم قاعدة الشيفرة ومؤشرات المشروع. تجعل الافتراضات القابلة للتكوين تخطيط المهام صريحاً وقابلاً للتكرار. |
| استطلاع البرمجيات | الثاني عالمياً* | يكتشف اللغات وأطر العمل والبنية التحتية من محتويات الملفات وبنية المشروع قبل الفحص. يربط جرد التقنيات بالاختيار التلقائي للقواعد والتحليل الدلالي وتخطيط المراجعة. |
| التحليل الدلالي المتقدم والتحليل عبر الملفات | الأكثر تقدماً مفتوح المصدر عند الإصدار* | يتتبع البيانات التي يتحكم بها المستخدم من المصدر إلى المخرج عبر حدود الملفات المدعومة باستخدام تحليل مخصص. صدر التحليل المتقدم إلى جانب RDL الأصلي في مارس 2026؛ ويوسّع RDL v2 تقييم القواعد الدلالية عبر الملفات. |
| الميزة / الإنجاز | التاريخ | الإصدار | الدليل / النطاق |
|---|---|---|---|
| النسخة التجريبية الأولية وقواعد مسارات الملفات | 22 أكتوبر 2022 | v0.1-beta | الإصدار الأولي؛ تتضمن الشيفرة المصدرية المحتفظ بها جرد قواعد مسارات الملفات المخصص. |
| استطلاع البرمجيات (المقدمة المنشورة) | 9 يوليو 2023 | v0.3-beta | تقدّم ملاحظات الإصدار الاستطلاع؛ وتُعد شيفرة المستودع الأقدم دليلاً منفصلاً على التنفيذ. |
| تقدير جهد المراجعة اليدوية (التنفيذ) | 29 يوليو 2023 | إيداع التنفيذ | أُضيفت وحدة تقدير مخصصة؛ وليس هذا تاريخ إصدار الإصلاح اللاحق. |
| RDL الأصلي والتحليل المتقدم بين الملفات | 2 مارس 2026 | v0.31-beta | صدر منطق القواعد الشرطية والتحليل المستقل عبر الملفات معاً. تاريخ عرض الإصدار هو 2 مارس؛ وطابع وقت النشر هو 1 مارس 2026 الساعة 18:39 UTC. |
تحدد التواريخ معالم المستودع أو الإصدار.
تم تقديم DakshSCRA خلال تدريب Black Hat USA 2022 وظهر علنًا لأول مرة في Black Hat USA 2023. تصف تلك التواريخ تقديم المشروع، وليس كل ميزة حالية.
التحسينات النشطة مستمرة. هناك العديد من الميزات والتحسينات الجديدة المخطط لها في الإصدارات القادمة.
لا تتردد في المساهمة في تحديث أو إضافة قواعد جديدة والتطوير المستقبلي.
إذا وجدت أي أخطاء، فأبلغ عنها إلى [email protected].
التوثيق المفصل: https://dakshlabs.com/#docs
هناك طريقتان لتشغيل Daksh SCRA - اختر ما يناسب سير عملك:
| الأنسب لـ | الانتقال إلى | |
|---|---|---|
| 🌐 واجهة الويب (Docker) | أسهل طريقة للبدء - أمر واحد، ولوحة تحكم في المتصفح، وتقدم الفحص المباشر، ومتصفح التقارير/المخرجات. موصى به لمعظم المستخدمين. | واجهة الويب (Docker) |
| 💻 واجهة سطر الأوامر (Python) | البرمجة النصية، أو خطوط أنابيب CI، أو تشغيل الفحوصات دون Docker. | إعداد واجهة سطر الأوامر |
كلا المسارين يشغّلان محرك الفحص نفسه تمامًا - واجهة الويب هي واجهة أمامية للمتصفح فوق نفس واجهة سطر الأوامر، لذا تكون النتائج متطابقة في كلتا الحالتين.
أسرع طريقة لتشغيل Daksh SCRA هي عبر واجهة الويب القائمة على المتصفح، التي تُطلق باستخدام مساعد بدء Docker المدرك للمضيف. يمنحك مشغّل فحص، وبثًا مباشرًا لوحدة التحكم، وسجلًا قابلًا للتصفح للتقارير السابقة. يحتاج مساعد البدء إلى Python 3 (المكتبة القياسية فقط)؛ أما التطبيق وتبعياته فتعمل في Docker.
يشغّل إعداد Docker واجهة الويب وواجهة سطر الأوامر كخدمتين مستقلتين مبنيتين من الصورة نفسها، لذا يمكنك استخدام أي منهما (أو كليهما) من الحاوية نفسها.
بعد تنزيل Daksh SCRA من GitHub، استخرج أرشيف ZIP أولًا.
افتح طرفية (PowerShell أو Command Prompt على Windows) داخل مجلد
المشروع المستخرج الذي يحتوي على docker-compose.yml وdakshscra.py.
شغّل جميع أوامر البدء وDocker Compose أدناه من ذلك المجلد.
إذا فُتحت طرفيتك في مكان آخر، فانتقل أولًا إلى المجلد المستخرج:
cd "path/to/extracted/DakshSCRA-folder"
استبدل مسار المثال بموقع التنزيل الفعلي واسم المجلد لديك.
إذا استنسخت المستودع بدلاً من ذلك، فشغّل cd DakshSCRA من المجلد الأصلي.
يتعرّف مساعد بدء التشغيل على Windows وWSL وLinux وmacOS، ثم يثبّت جذر المضيف وأقراص Windows المتاحة والمجلدات الشائعة للقراءة فقط قبل بدء الحاويات. شغّله على الحاسوب الذي يشغّل Docker.
Linux أو macOS أو WSL (في المقدمة):
python3 tools/start_webui.py
Windows PowerShell أو Command Prompt (في المقدمة):
py tools/start_webui.py
للتشغيل في الوضع المنفصل (الخلفي)، أضف --detach. تستمر الحاويات في العمل
بعد عودة أمر بدء التشغيل، مما يترك طرفيتك متاحة.
Linux أو macOS أو WSL (منفصل):
python3 tools/start_webui.py --detach
Windows PowerShell أو Command Prompt (منفصل):
py tools/start_webui.py --detach
استخدم --dry-run لفحص المسارات المكتشفة دون بدء الحاويات.
يتم احترام تجاوزات مسار .env الموجودة. يتم الحفاظ على الحسابات والفحوصات
وحجم وقت التشغيل عند إعادة إنشاء الحاويات.
قد يتطلب Docker Desktop إذنًا لمشاركة مسارات المضيف المحددة. إذا رفض نقطة تركيب، فاسمح بذلك الموقع في Docker Desktop وأعد تشغيل المساعد. يرى المتصفح البعيد مجلدات مضيف Docker، وليس محركات أقراص حاسوبه الخاص. يتطلب الاكتشاف التلقائي محرك Docker محليًا؛ شغّل المساعد على مضيف المحرك عند استخدام سياق Docker بعيد.
بالنسبة لنقاط التركيب المُهيأة يدويًا، يظل docker compose up --build -d api web
متاحًا. يقوم إعداده الأساسي بتركيب المستودع على /scan-targets و
${DAKSH_HOST_MOUNT:-/} على /host/root. استخدم المساعد لاكتشاف محركات أقراص Windows
واختصارات المجلدات الشائعة؛ لا يمكن لـ Compose العادي اكتشاف نظام تشغيل العميل.
ثم افتح http://localhost:3030.
لاستخدام منفذ مختلف:
DAKSH_PORT=9090 python3 tools/start_webui.py
أوقف الحزمة باستخدام:
docker compose down
استخدم أدوات التنظيف المساعدة المنفصلة من مجلد المستودع. تقوم بمعاينة افتراضيًا:
سيؤدي هذا إلى حذف حاويات Daksh وصور الخدمات والشبكات والأحجام، بما في ذلك الحسابات المحفوظة وسجل الفحص والمنتجات المخزنة في حجم وقت التشغيل. احتفظ بنسخة احتياطية من أي شيء تريد الاحتفاظ به أولاً.