### الأجهزة الإضافية

- **اتصال إيثرنت**: مطلوب لتمرير الإنترنت (يمكن أن يكون فعليًا أو محول USB-إيثرنت)
- **طاقة USB كافية**: قد تتطلب بعض المحولات عالية الطاقة لوصل USB مزود بالطاقة
- **الكمبيوتر**: أي جهاز كمبيوتر محمول أو مكتبي يعمل بنظام Linux (يوصى بـ Kali Linux)

---

## 💻 متطلبات البرامج

### نظام التشغيل

- **الموصى به**: Kali Linux (2020.1 أو أحدث)
- **مدعوم أيضًا**:
  - Debian 10+
  - Ubuntu 18.04+
  - Fedora 30+
  - Arch Linux
  - ParrotOS
  - BlackArch

### الحزم المطلوبة

سيتم تثبيتها تلقائيًا بواسطة `install_dependencies.sh`:

- `hostapd` - إنشاء نقطة الوصول
- `dnsmasq` - توفير خدمات DHCP وDNS
- `iptables` - تكوين قواعد NAT وجدار الحماية
- `iproute2` - تكوين واجهات الشبكة
- `wireless-tools` - أدوات إدارة الشبكات اللاسلكية
- `net-tools` - أدوات تشخيص الشبكة
- `iw` - أداة تهيئة الشبكة اللاسلكية
- `tcpdump` - أداة التقاط الحزم

### الصلاحيات

- مطلوب الوصول كجذر/سودو لجميع العمليات

---

## 📦 التثبيت

### البداية السريعة```bash
# Clone the repository
git clone https://github.com/yourusername/evil-twin-ap.git
cd evil-twin-ap

# Install dependencies
sudo ./install_dependencies.sh

# Detect your wireless interfaces
sudo ./detect_interface.sh

# Configure your settings (update interface if needed)
nano hostapd.conf  # Change SSID, channel, interface
nano dnsmasq.conf  # Adjust DHCP settings, interface

# Start the evil twin
sudo ./start_evil_twin.sh

#### الخطوة 2: تثبيت التبعيات

يقوم البرنامج النصي للتثبيت تلقائيًا باكتشاف توزيعة لينكس الخاصة بك وتثبيت الحزم المطلوبة:```bash
sudo ./install_dependencies.sh

هذا السكربت سيحلل جميع الواجهات اللاسلكية ويوصي بأفضلها للاستخدام.

**مثال على الإخراج:**```
==========================================
   Wireless Interface Detection
==========================================

[INFO] Scanning for wireless interfaces...

[✓] Found 2 wireless interface(s)

═══════════════════════════════════════════
Interface: wlan1
═══════════════════════════════════════════
State: DORMANT
MAC Address: 1a:60:c6:85:87:53
Driver: rtl88XXau

[INFO] Checking capabilities for wlan1...
[✓] Supports AP mode (Access Point) ✓
[✓] Supports Monitor mode ✓
Current Mode: managed

═══════════════════════════════════════════
Interface: wlan0
═══════════════════════════════════════════
State: DOWN
MAC Address: b2:72:bf:bc:31:bd
Driver: iwlwifi

[INFO] Checking capabilities for wlan0...
[✓] Supports AP mode (Access Point) ✓
[✓] Supports Monitor mode ✓
Current Mode: managed
[!] Power management is ON (may cause issues)

==========================================
   Summary & Recommendations
==========================================

[✓] Found 2 AP-capable interfaces:
  - wlan1
  - wlan0

[INFO] Recommendation: Use wlan1 (likely external USB adapter)

[!] wlan0 is usually built-in WiFi - use external adapter if available

[INFO] To update configuration files, run:
  sed -i 's/^interface=.*/interface=wlan1/' hostapd.conf
  sed -i 's/^interface=.*/interface=wlan1/' dnsmasq.conf

Current Configuration:
  hostapd.conf: interface=wlan1
  dnsmasq.conf: interface=wlan1

[INFO] After updating, verify with: iw list | grep -A 10 'Supported interface modes'

---

## ⚙️ التهيئة

### hostapd.conf - إعدادات نقطة الوصول

قم بتعديل `hostapd.conf` لتخصيص التوأم الشرير الخاص بك:```bash
nano hostapd.conf

### dnsmasq.conf - إعدادات DHCP/DNS

قم بتعديل `dnsmasq.conf` لتخصيص إعدادات الشبكة:```bash
nano dnsmasq.conf

### تكوين الشبكة

**الإعدادات الافتراضية:**
- **IP نقطة الوصول**: 192.168.99.1
- **الشبكة الفرعية**: 192.168.99.0/24
- **نطاق DHCP**: 192.168.99.10 - 192.168.99.250
- **القناة**: 6 (2.4GHz)
- **كلمة المرور**: letitrain2
- **الواجهة**: wlan1 (محول خارجي)

---

## 🚀 الاستخدام

### بدء التوأم الشرير```bash
sudo ./start_evil_twin.sh

### إيقاف التوأم الشرير```bash
sudo ./stop_evil_twin.sh

---

## 📸 التقاط حركة المرور

### التقاط حركة مرور الشبكة

تتضمن مجموعة الأدوات سكريبت شامل لالتقاط حركة المرور يقوم بحفظ بيانات الحزم كملفات PCAP للتحليل:```bash
# Basic capture (continuous until Ctrl+C)
sudo ./capture_traffic.sh

# Capture for specific duration (60 seconds)
sudo ./capture_traffic.sh -d 60

# Capture with verbose output and live statistics
sudo ./capture_traffic.sh -v

# Capture only HTTP/HTTPS traffic
sudo ./capture_traffic.sh -f "tcp port 80 or tcp port 443"

# Capture with custom filename
sudo ./capture_traffic.sh -n my_test_capture

# Capture on specific interface
sudo ./capture_traffic.sh -i wlan1

# Capture with file rotation (50MB files, max 20 files)
sudo ./capture_traffic.sh -s 50 -m 20

### ميزات الالتقاط

- ✅ حفظ الحركة المرورية بصيغة PCAP القياسية
- ✅ التدوير التلقائي للملفات لمنع الملفات الضخمة
- ✅ إحصائيات الحزم الحية في وضع الإسهاب
- ✅ دعم تصفية BPF (مرشح حزم بيركلي)
- ✅ التقاطات مؤقتة أو تشغيل مستمر
- ✅ تنظيف آمن عند الضغط على Ctrl+C
- ✅ حفظ المخرجات في مجلد `output/`

### موقع المخرجات

يتم حفظ جميع عمليات الالتقاط في `output/` بأسماء ملفات تعتمد على الطابع الزمني:
- الصيغة: `capture_YYYYMMDD_HHMMSS.pcap`
- الصيغة المخصصة: `yourname_YYYYMMDD_HHMMSS.pcap`

### تحليل الحركة المرورية الملتقطة```bash
# Open in Wireshark (GUI)
wireshark output/capture_20251018_143215.pcap

# Analyze with tcpdump
tcpdump -r output/capture_20251018_143215.pcap -n

# Filter for specific protocols
tcpdump -r output/capture_20251018_143215.pcap 'tcp port 80'

# Extract HTTP requests
tcpdump -r output/capture_20251018_143215.pcap -A 'tcp port 80'

# Get capture statistics
capinfos output/capture_20251018_143215.pcap

# Use tshark for advanced analysis
tshark -r output/capture_20251018_143215.pcap -Y "http.request"

---

## 📊 المراقبة

### مراقبة الاتصال في الوقت الفعلي

توفر الأدوات عدة طرق لمراقبة العملاء المتصلين:

#### 1. سجل الاتصال

يتم تحديثه تلقائيًا كل 5 ثوانٍ:```bash
tail -f logs/connections.log

#### 2. تعيينات DHCP

عرض تصاريح DHCP في الوقت الفعلي:```bash
tail -f logs/dnsmasq.log

#### 3. حالة نقطة الوصول

مراقبة سجلات hostapd:```bash
tail -f logs/hostapd.log

---

## 🔧 استكشاف الأخطاء وإصلاحها

### المشكلات الشائعة والحلول

#### 1. "لم يتم العثور على واجهات لاسلكية"

**المشكلة:** لم يتم اكتشاف محول الشبكة اللاسلكية.

**الحلول:**```bash
# Check if adapter is connected
lsusb | grep -i wireless

# Check interface name
ip link show

# Try replugging USB adapter

# Check kernel messages
dmesg | tail -20

# Run the detection script
sudo ./detect_interface.sh

#### 3. "فشل hostapd في البدء"

**المشكلة:** hostapd لا يمكنه بدء نقطة الوصول.

**الحلول:**```bash
# Check if interface is busy
sudo airmon-ng check kill

# Verify interface is up
sudo ip link set wlan1 up

# Check hostapd config syntax
sudo hostapd -d hostapd.conf

# View detailed logs
cat logs/hostapd.log

# Make sure you're using the right interface
grep "^interface=" hostapd.conf

#### 5. "يتصل العملاء ولكن لا يوجد إنترنت"

**المشكلة:** تكوين NAT/التوجيه غير صحيح.

**الحلول:**```bash
# Verify IP forwarding
cat /proc/sys/net/ipv4/ip_forward
# Should output: 1

# Check NAT rules
sudo iptables -t nat -L -v

# Verify internet interface
ip route show default

# Test internet on host
ping -c 3 8.8.8.8

# Check if eth0 has internet
ping -I eth0 -c 3 8.8.8.8

#### 7. "Channel X is not available"

**المشكلة:** اللوائح اللاسلكية تقيد بعض القنوات.

**الحلول:**```bash
# Check available channels for your country
iw list | grep -A 20 "Frequencies:"

# Edit hostapd.conf and change to available channel
nano hostapd.conf
# Common safe channels: 1, 6, 11 (2.4GHz)

#### 9. "الواجهة الخاطئة قيد الاستخدام"

**المشكلة:** تستخدم النصوص wlan0 بدلاً من wlan1 (أو العكس).

**الحلول:**```bash
# Run interface detection
sudo ./detect_interface.sh

# Update config files to use correct interface
sed -i 's/^interface=.*/interface=wlan1/' hostapd.conf
sed -i 's/^interface=.*/interface=wlan1/' dnsmasq.conf

# Verify changes
grep "^interface=" hostapd.conf dnsmasq.conf

### وصف الملفات

| الملف | الغرض | تعديل؟ |
|------|---------|---------|
| `hostapd.conf` | إعدادات نقطة الوصول (SSID، القناة، كلمة المرور، الواجهة) | ✅ نعم - خصص لاختبارك |
| `dnsmasq.conf` | إعدادات DHCP/DNS (الواجهة، نطاق IP) | ✅ نعم - ضبط إعدادات الشبكة |
| `install_dependencies.sh` | تثبيت الحزم المطلوبة | ❌ لا - شغّل كما هو |
| `detect_interface.sh` | الكشف عن الواجهات اللاسلكية ودعم وضع نقطة الوصول | ❌ لا - شغّل كما هو |
| `start_evil_twin.sh` | تشغيل نقطة الوصول التوأم الشريرة | ⚠️ نادرًا - فقط للتخصيص المتقدم |
| `stop_evil_twin.sh` | إيقاف وتنظيف | ❌ لا - شغّل كما هو |
| `capture_traffic.sh` | التقاط حركة المرور إلى ملفات PCAP | ⚠️ استخدم خيارات سطر الأوامر بدلاً من ذلك |
| `logs/*.log` | سجلات وقت التشغيل | 📖 للقراءة فقط - للمراقبة |
| `output/*.pcap` | بيانات الحزم الملتقطة | 📖 للقراءة فقط - للتحليل |

---

## 🔒 اعتبارات الأمان

### إرشادات الاستخدام الأخلاقي

1. **التفويض**: احصل دائمًا على إذن كتابي قبل الاختبار
2. **النطاق**: ابق ضمن النطاق المتفق عليه للاختبار
3. **التوثيق**: احتفظ بسجلات مفصلة لجميع الأنشطة
4. **الإفصاح**: أبلغ عن النتائج بمسؤولية لأصحاب الشبكة
5. **التعامل مع البيانات**: لا تعترض أو تخزن أو تسيء استخدام البيانات الملتقطة

### اعتبارات قانونية

- إنشاء نقاط وصول غير مصرح بها بدون إذن **غير قانوني** في معظم البلدان
- يمكن أن تشمل العقوبات غرامات وسجن وسجلات جنائية
- حتى الاختبار "غير الضار" يمكن مقاضاته إذا كان غير مصرح به
- البيئات المؤسسية: احصل على موافقة قسم تكنولوجيا المعلومات كتابيًا
- الأماكن العامة: لا تختبر أبدًا على الشبكات العامة

### الأمان التقني

**هذه المجموعة حسب التصميم:**
- ✅ تركز على إنشاء نقطة الوصول والمراقبة
- ✅ تتضمن التقاط حركة المرور للتحليل المصرح به فقط
- ✅ توفر تسجيلاً شاملاً للمساءلة
- ⚠️ لا تشمل جمع بيانات الاعتماد
- ⚠️ لا تشمل نزع SSL أو هجمات MITM النشطة
- ⚠️ لا تشمل التصيد عبر بوابة الأسيرة

**لتعزيز أمان اختباراتك:**
- استخدم قطاعات شبكة معزولة
- قم بتنفيذ تعريف شبكة اختبار (SSIDs فريدة)
- حدد الاختبار بنوافذ زمنية محددة
- راقب وسجل جميع الأنشطة
- استخدم فقط في أقفاص فاراداي أو غرف محمية من الترددات الراديوية لمنع تسرب الإشارة

### إجراءات دفاعية

يمكن للمنظمات الحماية من هجمات التوأم الشرير عن طريق:

- تطبيق **مصادقة 802.1X** (WPA2/WPA3 Enterprise)
- استخدام **التحقق من الشهادة** لمصادقة الشبكة
- نشر **أنظمة كشف التسلل اللاسلكي (WIDS)**
- تمكين **إطارات الإدارة المحمية (PMF/802.11w)**
- تدريب المستخدمين على التحقق من صحة الشبكة
- استخدام شبكات VPN للاتصالات الحساسة
- مراقبة نقاط الوصول المارقة

---

## 🤝 المساهمة

المساهمات مرحب بها! يرجى اتباع هذه الإرشادات:

### كيفية المساهمة

1. **قم بعمل fork للمستودع**
2. **أنشئ فرع ميزة**: `git checkout -b feature/your-feature`
3. **قم بإجراء تغييراتك** مع رسائل commit واضحة
4. **اختبر بدقة** على أنظمة متعددة إن أمكن
5. **حدّث التوثيق** إذا غيرت الوظائف
6. **قدم طلب سحب (pull request)** مع وصف مفصل

### إرشادات المساهمة

- حافظ على الهيكل المعياري
- أضف تسجيلًا تفصيليًا للميزات الجديدة
- تضمين معالجة الأخطاء للحالات النادرة
- حدّث README إذا أضفت ميزات جديدة
- اتبع نمط الكود الحالي (أفضل ممارسات bash)
- أضف تعليقات للمنطق المعقد
- اختبر على الأقل على توزيعة واحدة من دبيان

### نمط الكود```bash
# Use descriptive function names
configure_network_interface() {
    # Clear comments
    # Error handling
    # Verbose output
}

# Consistent formatting
print_info "Starting process..."
command || print_error "Failed to execute command"

---

## 🙏 شكر وتقدير

- فريق كالي لينكس لتوفير أدوات أمن لاسلكية ممتازة
- مشاريع hostapd و dnsmasq
- مجتمع أبحاث الأمن اللاسلكي
- المساهمون والمختبرون

---

## 📚 موارد إضافية

### موارد تعليمية

- [دليل اختبار الأمن اللاسلكي من OWASP](https://owasp.org/www-project-web-security-testing-guide/)
- [منهجية اختبار اختراق WiFi](https://www.sans.org/white-papers/)
- [الأمن اللاسلكي على Kali Linux](https://www.kali.org/docs/wireless/)

### أدوات ذات صلة

- **Aircrack-ng**: مجموعة تدقيق لاسلكي
- **Wireshark**: محلل بروتوكولات الشبكة
- **Bettercap**: هجمات الشبكة ومراقبتها
- **Wifiphisher**: هجمات التصيد الآلي على WiFi

### توثيق

- [توثيق hostapd](https://w1.fi/hostapd/)
- [دليل dnsmasq](http://www.thekelleys.org.uk/dnsmasq/doc.html)
- [ويكي لينكس اللاسلكي](https://wireless.wiki.kernel.org/)
- [دليل tcpdump](https://www.tcpdump.org/manpages/tcpdump.1.html)

---

## 📞 دعم

- **المشكلات**: [مشكلات GitHub](https://github.com/yourusername/evil-twin-ap/issues)
- **المناقشات**: [مناقشات GitHub](https://github.com/yourusername/evil-twin-ap/discussions)
- **الأمان**: أبلغ عن الثغرات عبر البريد الإلكتروني (وليس عبر المشكلات العامة)

---

## ⚖️ تحذير نهائي```
┌─────────────────────────────────────────────────────────────┐
│                                                             │
│  This tool is provided for EDUCATIONAL PURPOSES ONLY        │
│                                                             │
│  Unauthorized access to computer networks is ILLEGAL        │
│                                                             │
│  Always obtain written permission before testing            │
│                                                             │
│  You are responsible for your actions                       │
│                                                             │
└─────────────────────────────────────────────────────────────┘