أداة تحليل كود ثابتة مدركة للإطار لمراجعة تلقائية للكود المصدري مع قواعد خاصة بالمنصة، وتحليل التلوث، وتقدير الجهد، وخطوط أساس للكبت.
# Daksh SCRA (مساعد مراجعة الشيفرة المصدرية) ``` Author: - Debasis Mohanty ([email protected]) - Twitter / X: @coffeensecurity - www.coffeeandsecurity.com ``` ## حول Daksh SCRA صُمم Daksh SCRA (مساعد مراجعة الشيفرة المصدرية) لتعزيز كفاءة عملية مراجعة الشيفرة المصدرية، من خلال توفير نهج منظم ومهيكل لمراجعي الشيفرة. بدلاً من وضع علامة على كل شيء باعتباره مشكلة محتملة بشكل عشوائي، يعزز Daksh SCRA التحليل المدروس، ويحث على التحقيق في المشكلات المحتملة وتأكيدها. يخفف هذا النهج من الاندفاع لتصنيف كل مخاوف محتملة كخطأ برمجي، مما يقلل من الارتباك والوقت الضائع في التعامل مع النتائج الإيجابية الكاذبة. ### الظهور الأول قُدّم Daksh SCRA في البداية خلال جلسة تدريبية حول مراجعة الشيفرة المصدرية في Black Hat USA 2022 (6-9 أغسطس)، حيث عُرض بشكل خفي على جمهور محدد. وجاء ظهوره العام الرسمي الأول في Black Hat USA 2023 في لاس فيغاس. ## الميزات والوظائف يجمع DakshSCRA قدرات مميزة لمراجعة الشيفرة المصدرية يدوياً، بدءاً من مجالات الاهتمام في مسارات الملفات وتقدير الجهد وصولاً إلى استطلاع البرمجيات والقواعد السياقية والتحليل عبر الملفات. | الميزة | الوسم | لماذا تهم | |---|---|---| | **مجالات الاهتمام في مسارات الملفات** | الأول عالمياً* | يفحص أسماء الملفات والمجلدات نفسها، إلى جانب الشيفرة، لوضع علامة على المسارات المشبوهة مثل ملفات النسخ الاحتياطي ونقاط النهاية الخاصة بالتصحيح ومقالب الإعدادات وملفات بيانات الاعتماد التي غالباً ما يفوّتها المراجعون. | | **تقدير الجهد العلمي** | الأول عالمياً* | ينتج تقديراً كمياً لجهد المراجعة اليدوية بناءً على حجم قاعدة الشيفرة ومؤشرات المشروع. تجعل الافتراضات القابلة للتكوين تخطيط المهام صريحاً وقابلاً للتكرار. | | **استطلاع البرمجيات** | الثاني عالمياً* | يكتشف اللغات وأطر العمل والبنية التحتية من محتويات الملفات وبنية المشروع قبل الفحص. يربط جرد التقنيات بالاختيار التلقائي للقواعد والتحليل الدلالي وتخطيط المراجعة. | | **التحليل الدلالي المتقدم والتحليل عبر الملفات** | الأكثر تقدماً مفتوح المصدر عند الإصدار* | يتتبع البيانات التي يتحكم بها المستخدم من المصدر إلى المخرج عبر حدود الملفات المدعومة باستخدام تحليل مخصص. صدر التحليل المتقدم إلى جانب RDL الأصلي في مارس 2026؛ ويوسّع RDL v2 تقييم القواعد الدلالية عبر الملفات. | * بناءً على عمليات البحث العامة في وقت تقديم كل ميزة. لم يُعثر على ميزة مماثلة في أدوات مراجعة الشيفرة الأمنية مفتوحة المصدر. وبالنسبة لتقدير الجهد، لم يُعثر على نهج مماثل في الأدوات التجارية أيضاً. جاء الاستطلاع في المرتبة الثانية بعد Microsoft Application Inspector. وكان التحليل عبر الملفات الأكثر تقدماً بين أدوات مراجعة الشيفرة مفتوحة المصدر في وقت إصداره. ### تاريخ الميزات والأدلة | الميزة / الإنجاز | التاريخ | الإصدار | الدليل / النطاق | |---|---|---|---| | النسخة التجريبية الأولية وقواعد مسارات الملفات | 22 أكتوبر 2022 | v0.1-beta | [الإصدار الأولي؛ تتضمن الشيفرة المصدرية المحتفظ بها جرد قواعد مسارات الملفات المخصص.](https://github.com/coffeeandsecurity/DakshSCRA/releases/tag/v0.1-beta) | | استطلاع البرمجيات (المقدمة المنشورة) | 9 يوليو 2023 | v0.3-beta | [تقدّم ملاحظات الإصدار الاستطلاع؛ وتُعد شيفرة المستودع الأقدم دليلاً منفصلاً على التنفيذ.](https://github.com/coffeeandsecurity/DakshSCRA/releases/tag/v0.3-beta) | | تقدير جهد المراجعة اليدوية (التنفيذ) | 29 يوليو 2023 | إيداع التنفيذ | [أُضيفت وحدة تقدير مخصصة؛ وليس هذا تاريخ إصدار الإصلاح اللاحق.](https://github.com/coffeeandsecurity/DakshSCRA/commit/65d5c6a) | | RDL الأصلي والتحليل المتقدم بين الملفات | 2 مارس 2026 | v0.31-beta | [صدر منطق القواعد الشرطية والتحليل المستقل عبر الملفات معاً. تاريخ عرض الإصدار هو 2 مارس؛ وطابع وقت النشر هو 1 مارس 2026 الساعة 18:39 UTC.](https://github.com/coffeeandsecurity/DakshSCRA/commit/d90ba51) | ### أدلة مقارنة - **سلف الاستطلاع:** يوثّق [Microsoft Application Inspector](https://www.microsoft.com/en-us/security/blog/2020/01/16/introducing-microsoft-application-inspector/) (16 يناير 2020) أداة أسبق لخصائص الشيفرة المصدرية. ويُصنّف استطلاع Daksh SCRA في المرتبة الثانية بعدها. تحدد التواريخ معالم المستودع أو الإصدار. تم تقديم DakshSCRA خلال تدريب **Black Hat USA 2022** وظهر علنًا لأول مرة في **Black Hat USA 2023**. تصف تلك التواريخ تقديم المشروع، وليس كل ميزة حالية. > التحسينات النشطة مستمرة. هناك العديد من الميزات والتحسينات الجديدة المخطط لها في الإصدارات القادمة. لا تتردد في المساهمة في تحديث أو إضافة قواعد جديدة والتطوير المستقبلي. إذا وجدت أي أخطاء، فأبلغ عنها إلى [[email protected]](mailto:[email protected]). التوثيق المفصل: [https://dakshlabs.com/#docs](https://dakshlabs.com/#docs) --- ## البدء هناك طريقتان لتشغيل Daksh SCRA - اختر ما يناسب سير عملك: | | الأنسب لـ | الانتقال إلى | |---|---|---| | 🌐 **واجهة الويب (Docker)** | أسهل طريقة للبدء - أمر واحد، ولوحة تحكم في المتصفح، وتقدم الفحص المباشر، ومتصفح التقارير/المخرجات. موصى به لمعظم المستخدمين. | [واجهة الويب (Docker)](#web-ui-docker) | | 💻 **واجهة سطر الأوامر (Python)** | البرمجة النصية، أو خطوط أنابيب CI، أو تشغيل الفحوصات دون Docker. | [إعداد واجهة سطر الأوامر](#cli-setup) | كلا المسارين يشغّلان محرك الفحص نفسه تمامًا - واجهة الويب هي واجهة أمامية للمتصفح فوق نفس واجهة سطر الأوامر، لذا تكون النتائج متطابقة في كلتا الحالتين. --- ## واجهة الويب (Docker) أسرع طريقة لتشغيل Daksh SCRA هي عبر واجهة الويب القائمة على المتصفح، التي تُطلق باستخدام مساعد بدء Docker المدرك للمضيف. يمنحك مشغّل فحص، وبثًا مباشرًا لوحدة التحكم، وسجلًا قابلًا للتصفح للتقارير السابقة. يحتاج مساعد البدء إلى Python 3 (المكتبة القياسية فقط)؛ أما التطبيق وتبعياته فتعمل في Docker. يشغّل إعداد Docker واجهة الويب وواجهة سطر الأوامر كخدمتين مستقلتين مبنيتين من الصورة نفسها، لذا يمكنك استخدام أي منهما (أو كليهما) من الحاوية نفسها. ### تشغيل واجهة الويب بعد تنزيل Daksh SCRA من GitHub، **استخرج أرشيف ZIP أولًا**. افتح طرفية (PowerShell أو Command Prompt على Windows) داخل مجلد المشروع المستخرج الذي يحتوي على `docker-compose.yml` و`dakshscra.py`. **شغّل جميع أوامر البدء وDocker Compose أدناه من ذلك المجلد.** إذا فُتحت طرفيتك في مكان آخر، فانتقل أولًا إلى المجلد المستخرج: ```text cd "path/to/extracted/DakshSCRA-folder" ``` استبدل مسار المثال بموقع التنزيل الفعلي واسم المجلد لديك. إذا استنسخت المستودع بدلاً من ذلك، فشغّل `cd DakshSCRA` من المجلد الأصلي. يتعرّف مساعد بدء التشغيل على Windows وWSL وLinux وmacOS، ثم يثبّت جذر المضيف وأقراص Windows المتاحة والمجلدات الشائعة للقراءة فقط قبل بدء الحاويات. شغّله على الحاسوب الذي يشغّل Docker. Linux أو macOS أو WSL (في المقدمة): ```bash python3 tools/start_webui.py ``` Windows PowerShell أو Command Prompt (في المقدمة): ```powershell py tools/start_webui.py ``` للتشغيل في الوضع المنفصل (الخلفي)، أضف `--detach`. تستمر الحاويات في العمل بعد عودة أمر بدء التشغيل، مما يترك طرفيتك متاحة. Linux أو macOS أو WSL (منفصل): ```bash python3 tools/start_webui.py --detach ``` Windows PowerShell أو Command Prompt (منفصل): ```powershell 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](http://localhost:3030). لاستخدام منفذ مختلف: ```bash DAKSH_PORT=9090 python3 tools/start_webui.py ``` أوقف الحزمة باستخدام: ```bash docker compose down ``` ### تحرير مساحة القرص بعد عمليات بناء Docker المتكررة استخدم أدوات التنظيف المساعدة المنفصلة من مجلد المستودع. تقوم بمعاينة افتراضيًا: **سيؤدي هذا إلى حذف حاويات Daksh وصور الخدمات والشبكات والأحجام، بما في ذلك الحسابات المحفوظة وسجل الفحص والمنتجات المخزنة في حجم وقت التشغيل. احتفظ بنسخة احتياطية من أي شيء تريد الاحتفاظ به أولاً.** ```bash python3 tools/clean_project_docker.py python3 tools/purge_all_docker.py ``` أضف `--execute` للحذف، ثم اكتب التأكيد المطلوب. يزيل المساعد الأول حاويات هذا المشروع وشبكاته وصور خدماته وأحجامه، مع الحفاظ على ذاكرة التخزين المؤقت للبناء المشتركة. يزيل الثاني قسراً الحاويات عبر **جميع المشاريع على محرك Docker المحدد** ويُنظّف الصور والشبكات والأحجام المسماة/المجهولة وذاكرة التخزين المؤقت للمُنشئ الافتراضي. يمكن أن يؤثر على محرك بعيد. لا يحذف أيٌّ منهما ملفات المضيف المرتبطة بـ bind-mounted ولا يزيل تثبيت Docker. يمكن لمستخدمي Windows استبدال `python3` بـ `py`. راجع [نطاق التنظيف والأوامر](https://github.com/coffeeandsecurity/dakshscra/blob/main/docs/usage-guide.md#docker-cleanup-and-full-purge) لأسماء المشاريع المخصصة والاستثناءات وتفاصيل الحذف. تحقق من استخدام مساحة قرص Docker المتبقية باستخدام: ```bash docker system df ``` لتحرير ذاكرة التخزين المؤقت للبناء غير المستخدمة فقط مع الاحتفاظ ببيانات Daksh المحفوظة، شغّل فقط `docker builder prune --all --force`. تبقى الملفات الموجودة في مجلدات المضيف المرتبطة (bind-mounted)، بما في ذلك المستودع وأهداف الفحص، على القرص. ابدأ من جديد باستخدام `python3 tools/start_webui.py --detach` عندما تكون جاهزًا. ### تسجيل الدخول تتطلب واجهة الويب حسابًا. **تسجيل الدخول لأول مرة** 1. ابدأ البوابة (`python3 tools/start_webui.py --detach`) وافتح [http://localhost:3030](http://localhost:3030). 2. تكتشف صفحة تسجيل الدخول الإعداد الأولي. فتملأ مسبقًا اسم المستخدم `admin` وكلمة المرور الأولية، وتعرض إشعار الإعداد الأولي. | الإعداد | القيمة | |---|---| | اسم المستخدم | `admin` (أو `DAKSH_ADMIN_USERNAME` من `.env`) | | كلمة المرور الأولية | `Daksh@ChangeMe1` (أو `DAKSH_ADMIN_PASSWORD` من `.env`) | 3. انقر على **تسجيل الدخول**. تظهر خطوة **تغيير كلمة المرور** بملء الشاشة ولا يمكن تخطيها. أدخل كلمة المرور الأولية ككلمة المرور الحالية، واختر كلمة مرور جديدة (8 أحرف على الأقل، مختلفة عن الحالية)، ويمكنك اختياريًا تغيير اسم المستخدم. 4. بعد الحفظ، يتم نقلك إلى لوحة التحكم. من ذلك الحين فصاعدًا، لم تعد صفحة تسجيل الدخول تملأ أي شيء مسبقًا؛ سجّل الدخول ببيانات الاعتماد الخاصة بك. تُستخدم كلمة المرور الأولية فقط عندما لا تحتوي قاعدة البيانات على أي حسابات، وتتوقف عن العمل بمجرد تغييرها. حتى ذلك الحين، يمكن لأي شخص يستطيع الوصول إلى البوابة تسجيل الدخول بها، لذا عيّن `DAKSH_ADMIN_PASSWORD` في `.env` قبل البدء الأول إذا كانت البوابة قابلة للوصول من قبل الآخرين. يمكن لحساب مسؤول إنشاء حسابات إضافية عبر نقطة نهاية واجهة برمجة التطبيقات `POST /api/v1/auth/users` (لا توجد واجهة مستخدم مخصصة لذلك بعد). يتعين على الحسابات الجديدة والمُعاد تعيينها أيضًا تغيير كلمة المرور المخصصة لها عند تسجيل الدخول الأول. راجع `.env.example` للحصول على القائمة الكاملة للإعدادات المتعلقة بالمصادقة (مدة الجلسة، أمان ملفات تعريف الارتباط، CORS). ### ما الذي تحصل عليه - منشئ أوامر متجاوب لأوضاع الفحص، والاستطلاع، والتقدير، والاستطلاع + التقدير، والسرد، وPDF من JSON - بث وحدة التحكم في الوقت الفعلي وتقدم مباشر لكل مرحلة أثناء التنفيذ - لقطات للمخرجات لكل مهمة لمخرجات HTML / PDF / JSON - إرشادات وضع المطور، أو وضع مراجعة الكود، أو كليهما للنتائج والتقارير؛ الوضع الافتراضي هو كليهما - تنقل سريع داخل المتصفح عبر نموذج التشغيل، والبث المباشر، والمخرجات، والمهام الأخيرة - متصفح أدلة مدمج لاختيار المسارات المستهدفة (متوافق مع نظام التشغيل: Windows، macOS، Linux / Docker) تحت الغطاء، تظل واجهة سطر الأوامر (CLI) مصدر الحقيقة - فهي تقوم بكل الفحص وتولّد كل مخرجات HTML / PDF / JSON. تشغّل واجهة الويب مهمة نشطة واحدة في كل مرة وتأخذ لقطات لمخرجات كل مهمة مكتملة في `runtime/webui/jobs/<job-id>/artifacts/` بحيث تظل التقارير السابقة قابلة للوصول. ### تشغيل واجهة سطر الأوامر في Docker لا تحتاج إلى بيئة Python محلية لاستخدام واجهة سطر الأوامر أيضًا - فهي متاحة كخدمة Compose مستقلة، مبنية من الصورة نفسها: ```bash docker compose run --rm cli -h docker compose run --rm cli -r auto -t /scan-targets/path/to/source ``` ### ما الموجود في الصورة - خلفية FastAPI + واجهة أمامية Web UI - واجهة Daksh SCRA CLI الكاملة، كخدمة منفصلة - Playwright Chromium، لتوليد ملفات PDF - وحدات تخزين `reports/` و`runtime/` الدائمة - نقاط تركيب مسارات المضيف حتى تتمكن الفحوصات من الوصول إلى أشجار المصدر من داخل الحاوية **نقاط التركيب الرئيسية:** | التركيب | المسار داخل الحاوية | |---|---| | مصدر المشروع | `/app` | | جذر الفحص الافتراضي (المستودع، أو `DAKSH_SCAN_ROOT`) | `/scan-targets` | | نظام ملفات المضيف (قرص النظام على Windows) | `/host/root` | | أقراص Windows/WSL الإضافية | `/host/drives/<letter>` | | المجلد الرئيسي للمستخدم الحالي | `/host/user` | | مجلدات المضيف الشائعة | `/host/locations/<name>` | | `DAKSH_HOST_SOURCE` الاختياري | `/host/source` | انسخ `.env.example` إلى `.env` لتجاوزات المسارات والمصادقة الاختيارية. `DAKSH_BROWSE_ROOTS` هي قائمة سماح مفصولة بفواصل لمسارات **الحاوية**؛ اتركها غير مضبوطة لاكتشاف المواقع المركّبة. يجب إزالة قوائم السماح القديمة `/host/c` أو `/host/d` أو `/mnt` أو تحديثها عند التبديل إلى المساعد. مجلدات المضيف للقراءة فقط؛ تبقى التقارير وبيانات وقت التشغيل قابلة للكتابة في مواقع التطبيق الحالية. أعد التشغيل باستخدام المساعد بعد تركيب قرص آخر. لا حاجة إلى مقبس Docker أو حاوية ذات امتيازات. --- ## إعداد CLI هل تفضل تشغيل Daksh SCRA مباشرة باستخدام Python؟ إليك كيفية إعداده محليًا. ### المتطلبات الأساسية - Python 3.8+ - جميع المكتبات المدرجة في `requirements.txt` ### 1. تنزيل Daksh SCRA ```bash git clone https://github.com/coffeeandsecurity/DakshSCRA.git ``` أو نزّل أحدث ملف zip من [https://github.com/coffeeandsecurity/DakshSCRA](https://github.com/coffeeandsecurity/DakshSCRA) وقم بفك ضغطه. ### 2. إعداد بيئة افتراضية > 💡 يمكن إنشاء البيئة الافتراضية في أي دليل - لا يلزم أن تكون داخل مجلد DakshSCRA. **الخيار أ: إعداد بخطوة واحدة (موصى به)** ```bash python setup_env.py ``` هذا السكربت ينشئ البيئة الافتراضية، ويثبّت جميع التبعيات، ويثبّت متصفح Chromium الخاص بـ Playwright (المطلوب لتصدير PDF). **الخيار ب: الإعداد اليدوي** Windows: ```bash python -m venv daksh-env .\daksh-env\Scripts\activate ``` macOS / Linux: ```bash python3 -m venv daksh-env source daksh-env/bin/activate ``` ثم ثبّت التبعيات: ```bash cd path/to/DakshSCRA pip install -r requirements.txt playwright install chromium ``` ## استخدام واجهة سطر الأوامر (CLI) استخدم `python` داخل بيئة افتراضية، أو `python3` خارجها. ### خيارات سطر الأوامر ``` usage: dakshscra.py [-h] [-r RULES] [-f FILE_TYPES] [-v] [-t TARGET_DIR] [-l {R,RF}] [--recon] [--rs] [--estimate] [-rpt FORMATS] [--pdf-from-json] [--json-input-dir PATH] [--pdf-output PATH] [--pdf-multi-dir PATH] [--pdf-single-only] [--skip-analysis] [--loc] [--baseline-file PATH] [--baseline-generate] [--no-baseline] [--review-config PATH] [--resume-scan] [--state-file PATH] [--no-state] [--state] ``` | الخيار | الوصف | |---|---| | `-r RULES` | قواعد المنصات (مثل `php`، `java`، `php,java`) أو `auto` للكشف التلقائي | | `-f FILE_TYPES` | تجاوز أنواع الملفات الافتراضية للفحص | | `-v` | مستوى الإسهاب (`-v`، `-vv`، `-vvv`) | | `-t TARGET_DIR` | دليل الشيفرة المصدرية الهدف | | `-l {R,RF}` | عرض قواعد المنصات + الأطر `[R]` أو تضمين أنواع الملفات `[RF]` | | `--recon` | تشغيل الاستطلاع (كشف المنصة / الإطار / اللغة) | | `--rs`، `--recon-strict` | استطلاع صارم: عمليات كشف عالية الثقة فقط (يُستخدم مع `--recon`) | | `--estimate` | تقدير جهد مراجعة الشيفرة بناءً على حجم قاعدة الشيفرة | | `-rpt`، `--report FORMATS` | صيغ التقرير: `html`، `pdf`، `docx`، `json`، أو مزيج مفصول بفواصل (الافتراضي: `html`) | | `--pdf-from-json` | إنشاء تقرير/تقارير PDF من مخرجات JSON الموجودة دون إعادة الفحص | | `--json-input-dir PATH` | دليل تقرير JSON (الافتراضي: `./reports/data`) | | `--pdf-output PATH` | مسار إخراج PDF واحد (الافتراضي: `./reports/scan/pdf/report.pdf`) | | `--pdf-multi-dir PATH` | دليل إخراج PDF متعدد الملفات (الافتراضي: `./reports/scan/pdf/multi-file`) | | `--pdf-single-only` | إنشاء ملف PDF المدمج الواحد فقط؛ تخطي مجموعة الملفات المتعددة لكل منصة | | `--skip-analysis` | تعطيل مرحلة المحلل لهذه الجولة | | `--loc` | حساب الأسطر الفعلية للشيفرة | | `--baseline-file PATH` | ملف أساس الكبت (JSON) | | `--baseline-generate` | إنشاء أساس الكبت من النتائج الحالية | | `--no-baseline` | تعطيل كبت الأساس لهذه الجولة | | `--review-config PATH` | ملف فرز النتائج (JSON)؛ كبت الإيجابيات الكاذبة التي تمت مراجعتها سابقًا من التقارير | | `--resume-scan` | استئناف فحص متوقف سابقًا من ملف الحالة | | `--state-file PATH` | مسار مخصص لملف حالة الفحص / نقطة التحقق | | `--no-state` | تعطيل نقاط تحقق حالة الفحص لهذه الجولة | | `--state` | فرض تفعيل نقاط تحقق حالة الفحص لهذه الجولة | ### مثال على الاستخدام > `-f` (أنواع الملفات) اختياري. إذا لم يُحدد، يستخدم DakshSCRA أنواع الملفات الافتراضية للمنصة/المنصات المحددة. ```bash # Single platform scan python dakshscra.py -r php -t /path/to/source # Multiple platforms python dakshscra.py -r php,java,cpp -t /path/to/source # Auto-detect platform and apply matching rules python dakshscra.py -r auto -t /path/to/source # Override filetypes python dakshscra.py -r php -f dotnet -t /path/to/source # Reconnaissance only (no scanning) python dakshscra.py --recon -t /path/to/source # Reconnaissance + scanning python dakshscra.py --recon -r php -t /path/to/source # Strict recon (high-confidence detections only) python dakshscra.py --recon --rs -t /path/to/source # Effort estimation python dakshscra.py --estimate -t /path/to/source # Scan with HTML + PDF report output python dakshscra.py -r auto -t /path/to/source -rpt html,pdf # Verbosity levels python dakshscra.py -r php -v -t /path/to/source # default python dakshscra.py -r php -vvv -t /path/to/source # show all pattern checks # Generate suppression baseline from current findings python dakshscra.py -r auto -t /path/to/source --baseline-generate # Apply suppression baseline (suppress known FPs) python dakshscra.py -r auto -t /path/to/source --baseline-file config/suppressions.json # Disable baseline for this run python dakshscra.py -r auto -t /path/to/source --no-baseline # Apply findings triage / review config python dakshscra.py -r auto -t /path/to/source --review-config config/review.json # Scan with checkpoint state enabled python dakshscra.py -r auto -t /path/to/source --state # Resume an interrupted scan python dakshscra.py -r auto -t /path/to/source --resume-scan # Resume with a custom state file python dakshscra.py -r auto -t /path/to/source --resume-scan --state-file runtime/scan_state.json # Generate PDF from existing JSON outputs (no re-scan) python dakshscra.py --pdf-from-json # Generate PDF from a custom JSON directory python dakshscra.py --pdf-from-json --json-input-dir ./custom/reports/data # Custom output paths for PDF python dakshscra.py --pdf-from-json --pdf-output ./reports/scan/pdf/custom.pdf --pdf-multi-dir ./reports/scan/pdf/multi-file # Single combined PDF only (skip per-platform set) python dakshscra.py --pdf-from-json --pdf-single-only ``` ### قواعد وأطر المنصات المدعومة ```bash python dakshscra.py -l R # List platform rules and framework mappings python dakshscra.py -l RF # List platform rules, framework mappings, and filetypes ``` المنصات وأطر العمل المدعومة حاليًا وتعييناتها: <!-- supported-platforms:start --> | المنصة | أطر العمل | |---|---| | dotnet | aspnetcore, blazor, entityframework, identity | | php | codeigniter, drupal, laravel, symfony, wordpress, yii | | java | hibernate, mybatis, spring, springboot, struts | | javascript | angular, electron, express, nestjs, nextjs, react, vue | | kotlin | exposed, ktor, springkotlin | | python | django, fastapi, flask, sqlalchemy | | go | echo, fiber, gin, gorilla, gorm | | c | freertos | | cpp | boost, qt | | android | cordova-android, flutter-android, ionic-android, jetpack, nativescript-android, reactnative-android, retrofit, room, xamarin-android | | ios | alamofire, cordova-ios, coredata, flutter-ios, ionic-ios, nativescript-ios, reactnative-ios, swiftui, uikit, xamarin-ios | | reactnative | expo, reactnative | | flutter | flutter, flutter-dio, flutter-hive | | xamarin | xamarin | | maui | - | | kmp | - | | ionic | ionic | | nativescript | nativescript | | cordova | cordova | | bash | - | | powershell | - | | dockerfile | - | | terraform | terraform-aws, terraform-azure, terraform-gcp | | kubernetes | - | | ruby | rails, sinatra | | rust | actix, axum, rocket | | common | - | <!-- supported-platforms:end --> يسرد هذا الجدول حزم القواعد المسجّلة. تعني الشرطة أنه لم يتم تسجيل حزمة إطار عمل منفصلة. تتفاوت تغطية التحليل حسب اللغة والقاعدة. بعد تغيير سجلات المنصات أو أطر العمل، حدّث هذا الجدول وتحقق منه قبل إرسال التغييرات: ```bash python3 tools/supported_platforms.py python3 tools/supported_platforms.py --check ``` للحصول على أحدث المنصات وأطر العمل المدعومة، شغّل دائمًا: ```bash python dakshscra.py -l R ``` ## مرجع الإعدادات ### `config/tool.yaml` يتم التحكم في الإعدادات الافتراضية لوقت تشغيل Daksh SCRA من خلال `config/tool.yaml`. ```yaml state_management: enabled: false resume_mode: manual persist_after_seconds: 300 persist_interval_seconds: 30 default_state_file: runtime/scan_state.json cleanup_on_success: false analysis: run_by_default: true include_frameworks: true report_theme: hacker_mode ``` **خيارات إعداد المحلل:** - `analysis.run_by_default` - `true`: يعمل المحلل تلقائيًا أثناء الفحص - `false`: يُعطَّل المحلل ما لم يُعَد تفعيله في الإعدادات أو عبر CLI - `analysis.include_frameworks` - `true`: تضمين إدخالات المحلل على مستوى الإطار حيث يتوفر اكتشاف الإطار - `false`: مخرجات المحلل على مستوى المنصة فقط - `analysis.report_theme` - `hacker_mode`: سمة محلل حديثة داكنة عالية التباين (افتراضي) - `professional_mode`: سمة محلل حديثة فاتحة - `both`: إنشاء نسختي السمة جنبًا إلى جنب ### قواعد الأنماط والقواعد الدلالية **تحدد قواعد الأنماط (Pattern Rules) مجالات الاهتمام باستخدام الأنماط والشروط السياقية. ويتحقق المراجع مما إذا كانت تمثل مشكلات أمنية فعلية.** **توفر القواعد الدلالية (Semantic Rules) أدلة أقوى من خلال تحليل علاقات الشيفرة وانتشار المدخلات والحمايات النمذجية. ويمكنها دعم اكتشاف أو استبعاده، لكن النمذجة غير المكتملة وإعدادات النشر وسلوك وقت التشغيل قد تؤثر مع ذلك على الاستنتاج.** اختر `--rule-mode pattern|semantic|both` (الافتراضي `both`)، أو اختر الأوضاع نفسها في New Scan. يتخطى وضع semantic-only خطوط الأساس النصية الأصلية مع الاحتفاظ بفحوصات مصدر/إعدادات الجوال المُحسَّنة ونماذج التدفق المدعومة. لا يزال الاكتشاف المدعوم يتطلب تأكيد المراجع؛ والاستبعاد لا يثبت السلامة. --- [Read more](https://github.com/coffeeandsecurity/dakshscra)