### अतिरिक्त हार्डवेयर

- **ईथरनेट कनेक्शन**: इंटरनेट पासथ्रू के लिए आवश्यक (भौतिक या 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` - पैकेट कैप्चर उपयोगिता

### विशेषाधिकार

- सभी कार्यों के लिए रूट/sudo एक्सेस आवश्यक है

---

## 📦 स्थापना

### त्वरित प्रारंभ```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: निर्भरताएँ स्थापित करें

इंस्टॉलेशन स्क्रिप्ट स्वचालित रूप से आपके Linux वितरण का पता लगाती है और आवश्यक पैकेज स्थापित करती है:```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

### नेटवर्क कॉन्फ़िगरेशन

**डिफ़ॉल्ट सेटिंग्स:**
- **AP 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 फ़िल्टरिंग समर्थन (Berkeley Packet Filter)
- ✅ समयबद्ध कैप्चर या निरंतर संचालन
- ✅ 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 असाइनमेंट

वास्तविक समय में डीएचसीपी लीज़ देखें:```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. "चैनल X उपलब्ध नहीं है"

**समस्या:** वायरलेस नियम कुछ चैनलों को प्रतिबंधित करते हैं।

**समाधान:**```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` | AP सेटिंग्स (SSID, चैनल, पासवर्ड, इंटरफ़ेस) | ✅ हाँ - अपने परीक्षण के अनुसार अनुकूलित करें |
| `dnsmasq.conf` | DHCP/DNS कॉन्फ़िगरेशन (इंटरफ़ेस, IP रेंज) | ✅ हाँ - नेटवर्क सेटिंग्स समायोजित करें |
| `install_dependencies.sh` | आवश्यक पैकेज स्थापित करता है | ❌ नहीं - जैसा है वैसे चलाएँ |
| `detect_interface.sh` | वायरलेस इंटरफ़ेस और AP मोड समर्थन का पता लगाता है | ❌ नहीं - जैसा है वैसे चलाएँ |
| `start_evil_twin.sh` | इविल ट्विन AP प्रारंभ करता है | ⚠️ शायद ही कभी - केवल उन्नत अनुकूलन के लिए |
| `stop_evil_twin.sh` | रोकता है और साफ़ करता है | ❌ नहीं - जैसा है वैसे चलाएँ |
| `capture_traffic.sh` | ट्रैफ़िक को PCAP फ़ाइलों में कैप्चर करता है | ⚠️ इसके बजाय CLI विकल्पों का उपयोग करें |
| `logs/*.log` | रनटाइम लॉग | 📖 केवल पढ़ने योग्य - निगरानी के लिए |
| `output/*.pcap` | कैप्चर किया गया पैकेट डेटा | 📖 केवल पढ़ने योग्य - विश्लेषण के लिए |

---

## 🔒 सुरक्षा संबंधी विचार

### नैतिक उपयोग दिशानिर्देश

1. **प्राधिकरण**: परीक्षण से पहले हमेशा लिखित अनुमति प्राप्त करें
2. **सीमा**: सहमत परीक्षण सीमा के भीतर रहें
3. **दस्तावेज़ीकरण**: सभी गतिविधियों का विस्तृत लॉग रखें
4. **प्रकटीकरण**: नेटवर्क मालिकों को जिम्मेदारी से निष्कर्ष रिपोर्ट करें
5. **डेटा हैंडलिंग**: कैप्चर किए गए डेटा को इंटरसेप्ट, स्टोर या दुरुपयोग न करें

### कानूनी विचार

- बिना प्राधिकरण के रॉग एक्सेस पॉइंट बनाना अधिकांश देशों में **अवैध** है
- दंड में जुर्माना, कारावास और आपराधिक रिकॉर्ड शामिल हो सकते हैं
- यहां तक कि "हानिरहित" परीक्षण भी अनधिकृत होने पर अभियोजन योग्य हो सकता है
- कॉर्पोरेट वातावरण: आईटी विभाग से लिखित स्वीकृति प्राप्त करें
- सार्वजनिक स्थान: सार्वजनिक नेटवर्क पर कभी परीक्षण न करें

### तकनीकी सुरक्षा

**यह टूलकिट डिज़ाइन द्वारा:**
- ✅ एक्सेस पॉइंट निर्माण और निगरानी पर ध्यान केंद्रित करता है
- ✅ केवल अधिकृत विश्लेषण के लिए ट्रैफ़िक कैप्चर शामिल करता है
- ✅ जवाबदेही के लिए व्यापक लॉगिंग प्रदान करता है
- ⚠️ क्रेडेंशियल हार्वेस्टिंग शामिल नहीं करता
- ⚠️ SSL स्ट्रिपिंग या सक्रिय MITM हमले शामिल नहीं करता
- ⚠️ कैप्टिव पोर्टल फ़िशिंग शामिल नहीं करता

**अपने परीक्षण की सुरक्षा बढ़ाने के लिए:**
- पृथक नेटवर्क सेगमेंट का उपयोग करें
- परीक्षण नेटवर्क पहचान (अद्वितीय SSID) लागू करें
- परीक्षण को विशिष्ट समय विंडो तक सीमित रखें
- सभी गतिविधियों की निगरानी और लॉग करें
- सिग्नल लीक को रोकने के लिए केवल फैराडे केज या RF-शील्डेड कमरों में उपयोग करें

### रक्षात्मक उपाय

संगठन निम्नलिखित द्वारा इविल ट्विन हमलों से बचाव कर सकते हैं:

- **802.1X प्रमाणीकरण** (WPA2/WPA3 एंटरप्राइज़) लागू करना
- नेटवर्क प्रमाणीकरण के लिए **प्रमाणपत्र सत्यापन** का उपयोग करना
- **वायरलेस इंट्रूज़न डिटेक्शन सिस्टम (WIDS)** तैनात करना
- **संरक्षित प्रबंधन फ़्रेम (PMF/802.11w)** सक्षम करना
- उपयोगकर्ताओं को नेटवर्क प्रामाणिकता सत्यापित करने के लिए प्रशिक्षित करना
- संवेदनशील संचार के लिए VPN का उपयोग करना
- रॉग एक्सेस पॉइंट की निगरानी करना

---

## 🤝 योगदान

योगदान का स्वागत है! कृपया इन दिशानिर्देशों का पालन करें:

### योगदान कैसे करें

1. **रिपॉजिटरी को फ़ोर्क करें**
2. **एक फीचर ब्रांच बनाएँ**: `git checkout -b feature/your-feature`
3. **स्पष्ट कमिट संदेशों के साथ अपने बदलाव करें**
4. **यदि संभव हो तो कई सिस्टमों पर अच्छी तरह से परीक्षण करें**
5. **यदि आप कार्यक्षमता बदलते हैं तो दस्तावेज़ अपडेट करें**
6. **विस्तृत विवरण के साथ पुल रिक्वेस्ट सबमिट करें**

### योगदान दिशानिर्देश

- मॉड्यूलर संरचना बनाए रखें
- नई सुविधाओं के लिए वर्बोज़ लॉगिंग जोड़ें
- एज केस के लिए एरर हैंडलिंग शामिल करें
- यदि नई सुविधाएँ जोड़ते हैं तो README अपडेट करें
- मौजूदा कोड शैली (बैश सर्वोत्तम अभ्यास) का पालन करें
- जटिल लॉजिक के लिए टिप्पणियाँ जोड़ें
- कम से कम एक डेबियन-आधारित डिस्ट्रो पर परीक्षण करें

### कोड शैली```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/)
- [वाई-फाई पेनिट्रेशन टेस्टिंग पद्धति](https://www.sans.org/white-papers/)
- [काली लिनक्स पर वायरलेस सुरक्षा](https://www.kali.org/docs/wireless/)

### संबंधित उपकरण

- **Aircrack-ng**: वायरलेस ऑडिटिंग सूट
- **Wireshark**: नेटवर्क प्रोटोकॉल विश्लेषक
- **Bettercap**: नेटवर्क हमले और निगरानी
- **Wifiphisher**: वाई-फाई पर स्वचालित फिशिंग हमले

### दस्तावेज़ीकरण

- [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)

---

## 📞 सहायता

- **Issues**: [GitHub Issues](https://github.com/yourusername/evil-twin-ap/issues)
- **Discussions**: [GitHub Discussions](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                       │
│                                                             │
└─────────────────────────────────────────────────────────────┘