CoWitness

CoWitness هي أداة مصممة لتعمل كخادم HTTP وHTTPS وDNS. تتيح لك تقديم صفحات ويب، وتسجيل طلبات HTTP، وتخصيص استجابات DNS. يقدم هذا الملف README نظرة عامة على الميزات وتعليمات حول كيفية تجميع الأداة واستخدامها.

الميزات

• خادم HTTP: يتضمن CoWitness خادم HTTP يستمع على المنفذ 80. يمكنه تقديم ملفات ثابتة من مجلد العمل الحالي. يتم تسجيل كل طلب HTTP، بما في ذلك عنوان IP الخاص بالعميل والمورد المطلوب ووكيل المستخدم.

• خادم HTTPS: بالإضافة إلى خادم HTTP، يوفر CoWitness أيضًا خادم HTTPS يستمع على المنفذ 443. على غرار خادم HTTP، يقدم ملفات ثابتة ويسجل كل طلب.

• خادم DNS: يعمل CoWitness كخادم DNS، يستمع على المنفذ 53. يسمح لك بتخصيص استجابات DNS، بما في ذلك سجلات NS و A. يتم تسجيل طلبات DNS، بما في ذلك عنوان IP الخاص بالعميل والنطاق المطلوب.

• التسجيل: يقوم CoWitness بإنشاء ملفات سجل لطلبات HTTP وDNS. يتم إلحاق السجلات بالملفات الموجودة، مما يسمح لك بتتبع وتحليل نشاط الخادم.

• الوضع الصامت: يمكن تشغيل CoWitness في الوضع الصامت عن طريق تمرير الوسيطة -q في سطر الأوامر. في هذا الوضع، لن يتم عرض شعار ASCII.

المتطلبات الأساسية 📝

قبل استخدام CoWitness، تأكد من توفر المتطلبات التالية:

• لغة البرمجة Go مثبتة على نظامك، احصل عليها من هنا يجب أن يكون الإصدار go 1.21 إذا كنت تبني من المصدر.
• اتصال بالإنترنت لتنزيل تبعيات Go.
• خادم بعيد بعنوان IP عام.

البناء 👨🏼‍🔧

اتبع هذه الخطوات لتثبيت وبناء CoWitness:

1. استنسخ مستودع CoWitness من GitHub:

git clone https://github.com/your-username/CoWitness.git

2. انتقل إلى مجلد CoWitness:

cd CoWitness

3. قم ببناء الملف التنفيذي لـ CoWitness:

make -f Makefile build

يقوم هذا الأمر بتجميع الكود المصدري لـ CoWitness وإنشاء ملف تنفيذي لـ amd64 و arm64.

التثبيت 👨🏻‍💻

لاستخدام CoWitness على خادم بعيد، اتبع هذه الخطوات:

1. اختر اسم نطاق لبيئة الاختبار الخاصة بك.
2. قم بإعداد خادم بعيد واحصل على عنوان IP عام له.
3. قم بتسجيل خوادم الأسماء الخاصة بك للإشارة إلى عنوان IP العام. (راجع وثائق مسجل النطاق الخاص بك لمعرفة كيفية إعداد خوادم الأسماء.)
4. قم بإنشاء سجلات لصق (glue records) لربط عنوان IP بالخادم البعيد الخاص بك. قد تختلف هذه الخطوة حسب مزود DNS الخاص بك. استشر وثائقهم للحصول على إرشادات حول إنشاء سجلات اللصق.
5. تأكد من أن المنفذين 80 و 53 متاحان على الخادم البعيد. قم بتكوين أي جدار ناري أو إعدادات شبكة للسماح بالاتصالات الواردة على هذه المنافذ.
6. انقل الملف التنفيذي لـ CoWitness إلى الخادم البعيد باستخدام طريقة آمنة مثل SCP أو SFTP.

اتصل بالخادم البعيد عبر SSH:

ssh username@your-server-ip

طريقة سهلة لتثبيت cowitness هي الحصول على حزمة البناء الآلي من هنا والتي يمكنك بعد ذلك استخدام curl أو wget لتحميلها إلى نظامك أو نقل الملف عبر scp من نظامك.

cowitness

التخصيص ⚒️

يمكنك تخصيص CoWitness ليتناسب مع احتياجاتك الخاصة. فيما يلي بعض التعديلات الممكنة:

• تغيير المنافذ الافتراضية: راجع تعليمات الاستخدام لمعرفة وسائط سطر الأوامر لتغيير المنافذ الافتراضية.

• تعديل مسارات ملفات السجل: يمكنك تغيير مسارات ملفات سجل HTTP و DNS (http.log و dns.log) عن طريق تحديث استدعاءات os.OpenFile في الكود المصدري.

المجتمع والمساهمات

نرحب بالمساهمات والملاحظات من المجتمع. إذا واجهت أي مشكلات أو كانت لديك اقتراحات للتحسين، فيرجى فتح مشكلة أو إرسال طلب سحب على مستودع GitHub الخاص بنا!

الترخيص

تم إصدار CoWitness بموجب ترخيص MIT.