Faraday Agents Dispatcher helps user develop integrations with Faraday written in any language.

التثبيت

ما عليك سوى تشغيل pip3 install faraday_agent_dispatcher وسترى أمر faraday-dispatcher في نظامك.

لإعداد بيئة تطوير (أي لتغيير كود المُوزِّع نفسه، وليس لكتابة عمليات التكامل الخاصة بك)، يجب استنساخ هذا المستودع وتشغيل pip install -e ..

تشغيل Faraday Agent Dispatcher لأول مرة

1. أنشئ ملف تكوين بتشغيل faraday-dispatcher config-wizard.

2. شغّل الوكيل بأمر faraday-dispatcher run. سيكون ملف التكوين الذي ينشئه موجودًا في ~/.faraday/config/dispatcher.ini إذا لم تمرر مسارًا مخصصًا.

يجب إكمال تكوين الوكيل باستخدام رمز التسجيل الخاص بك، الموجود على http://localhost:5985/#/admin/agents. تأكد من أن قسم الخادم يحتوي على المعلومات الصحيحة حول مثيل خادم Faraday الخاص بك. ثم أكمل قسم الوكيل بالاسم المطلوب لوكيلك. أخيرًا، أضف المُنفِّذات

المُنفِّذات

إنشاء المُنفِّذات الخاصة بك

المُنفِّذ هو برنامج نصي يطبع بيانات JSON في سطر واحد إلى stdout. تذكر أنه إذا طبعت أي بيانات أخرى إلى stdout، فسيُطلق الموزِّع خطأً. إذا أردت طباعة معلومات تصحيح الأخطاء أو التسجيل، فيجب استخدام stderr لذلك.

كل سطر يكتبه المُنفِّذ إلى stdout سيتم فك ترميزه بواسطة الموزِّع وإرساله إلى Faraday باستخدام نقطة نهاية Bulk Create. لذلك، يجب أن يكون JSON الذي تطبعه مطابقًا للمخطط الذي تتطلبه نقطة النهاية (هذا المخطط مُفصَّل أدناه). وإلا، فسيشتكي الموزِّع لأنك زوّدته ببيانات غير صالحة.

إذا أردت تصحيح أخطاء المُنفِّذ، فإن أبسط طريقة للقيام بذلك هي تشغيله مباشرة بدلاً من تشغيله مع الموزِّع. نظرًا لأن المُنفِّذ يطبع بيانات JSON فقط إلى stdout، فستتمكن من رؤية جميع المعلومات التي يريد إرسالها إلى Faraday، دون إرسالها فعليًا.

تكوين مُنفِّذ

بعد كتابة المُنفِّذ، يجب إضافته باستخدام faraday-dispatcher config-wizard في قسم المُنفِّذات، مع إضافة اسمه، والأمر المطلوب تنفيذه، والحد الأقصى لحجم JSON الذي سيُرسل إلى خادم Faraday. بالإضافة إلى ذلك، يمكنك تكوين متغيرات البيئة والوسائط في القسم المناسب لها.

تشغيل مُنفِّذ

لتشغيل مُنفِّذ، استخدم أمر faraday-dispatcher config-wizard، وقم بتشغيله من خادم Faraday. سيستخدم المُنفِّذ متغيرات البيئة المُعيَّنة ويطلب الوسائط.

تنسيق Bulk Create JSON

يجب أن تتوافق البيانات المنشورة إلى faraday مع نقطة نهاية bulk_create الخاصة بـ واجهة برمجة تطبيقات Faraday REST

تشغيل عدة موزِّعين

إذا كنت تريد تشغيل أكثر من مُوزِّع واحد، يعمل كلٌّ منها بمُنفِّذاته الخاصة، فالطريقة المفضلة للقيام بذلك هي إنشاء ملفات تكوين مختلفة لكلٍّ منها (على سبيل المثال، ~/.faraday/config/dispatcher-1.ini و ~/.faraday/config/dispatcher-2.ini). بعد ذلك، يمكنك تشغيل مثيلين مختلفين من Dispatcher باستخدام faraday-dispatcher --config-file PATH_TO_A_CONFIG_FILE.

المُنفِّذات

داخل دليل executors يمكنك العثور على المُنفِّذات المنشأة بالفعل.

الرسمية

المُنفِّذات الرسمية هي مجموعة من المُنفِّذات الجاهزة للاستخدام (مع الحد الأدنى من التكوين باستخدام المعالج). لديها ملف JSON بيان، يقدم تفاصيل حول استخدامات المُنفِّذ ويساعد في تكوينها.

المُنفِّذات الرسمية الحالية هي:

• Arachni
• Burp
• CrackMapExec
• Nessus
• Nikto
• Nmap
• Nuclei
• Openvas
• معالج التقارير: يستهلك تقريرًا محليًا في مكان وجود المُوزِّع باستخدام إضافات Faraday
• [QualysGuard] qualys
• Sonar Qube API
• Sublist3r
• W3af
• Wpscan
• Zap

التطوير

المُنفِّذات التطويرية هي مجموعة المُنفِّذات التي لا نحافظ عليها بالكامل، لدينا أمثلة للاستخدام، ومفاهيمية، ومُنفِّذات قيد التطوير. أهمها:

• basic_example.py: مثال Hello World لمُنفِّذات Faraday. سيقوم بإنشاء مضيف مع ثغرة مرتبطة به
• heroku_discovery_agent.py: تحميل معلومات المضيف والخدمة من حساب Heroku الخاص بك
• prowlerSample.py: تشغيل أمر prowler وإرسال مخرجاته إلى Faraday
• brainfuck.sh: إثبات مفهوم لتوضيح أنه يمكنك إنشاء مُنفِّذ بأي لغة برمجة، بما في ذلك Brainfuck!

خارطة الطريق

نعمل حاليًا على مُنفِّذات جديدة، بالإضافة إلى تحسين تجربة استخدام الوكلاء.

نود منح بعض الوكلاء حق الوصول للقراءة إلى مساحة العمل الخاصة بهم، حتى يتمكنوا من الاستفادة من البيانات الموجودة للعثور على معلومات أكثر قيمة.

التوثيق

لمزيد من المعلومات، يمكنك الاطلاع على وثائقنا