Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aress31/wirespy
Framework designed to automate various wireless networks attacks (the project was presented on Pentester Academy TV's toolbox in 2017).
https://github.com/aress31/wirespy
aircrack-ng evil-twin eviltwin honeypot hotspot man-in-the-middle man-in-the-middle-attack mitm monitoring pentesting wifi wifi-hacking wifi-security wireless wireless-security
Last synced: about 1 month ago
JSON representation
Framework designed to automate various wireless networks attacks (the project was presented on Pentester Academy TV's toolbox in 2017).
- Host: GitHub
- URL: https://github.com/aress31/wirespy
- Owner: aress31
- License: apache-2.0
- Created: 2016-01-16T16:16:38.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2022-10-15T22:58:54.000Z (almost 2 years ago)
- Last Synced: 2024-07-17T23:59:53.213Z (about 2 months ago)
- Topics: aircrack-ng, evil-twin, eviltwin, honeypot, hotspot, man-in-the-middle, man-in-the-middle-attack, mitm, monitoring, pentesting, wifi, wifi-hacking, wifi-security, wireless, wireless-security
- Language: Shell
- Homepage:
- Size: 301 KB
- Stars: 585
- Watchers: 38
- Forks: 89
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-termux-hacking - wirespy - Framework designed to automate various wireless networks attacks (the project was presented on Pentester Academy TV's toolbox in 2017)..[](https://github.com/aress31/wirespy/stargazers/) (Uncategorized / Uncategorized)
README
# wirespy
## WireSpy enables the automation of various WiFi attacks to conduct Man-In-The-Middle-Attacks (MITMAs).
**WireSpy** allows attackers to set up quick honeypots to carry out **MITMAs**. Monitoring and logging functionality is implemented in order to keep records of the victims' traffic/activities. Other tools can be used together with Wirespy to conduct more advanced attacks.
Two type of attacks are supported at the moment:
- **Evil twin**: Force victims to auto-connect to the honeypot by spoofing a _"trusted"_ hotspot (clone an existing access point and de-authenticate its users to force them to transparently connect to the spoofed honeypot).
- **Honeypot**: Set up a simple rogue hotspot and wait for clients to connect.
## Features
- Capture victims' traffic.
- MAC address spoofing.
- Set-up honeypot and evil twin attacks.
- Show the list of in range access points.
- Wireless adapter|card|dongle power amplification.
## Usage
1. Set as `executable`:
```bash
chmod +x wirespy.sh
```
2. Execute as `root`:
```bash
sudo ./wirespy.sh
```
3. Type `help` to get started.
```bash
Attacks:
eviltwin > launch an evil twin attack
honeypot > launch a rogue access point attack
Commands:
clear > clear the terminal
help > list available commands
quit|exit > exit the program
apscan > show all wireless access points nearby
leases > display DHCP leases
powerup > power wireless interface up (may cause issues)
start capture > start packet capture (tcpdump)
stop capture > stop packet capture (tcpdump)
status > show modules status
```
## Roadmap
- [ ] Add WPA/WPA2 support for honeypot.
- [ ] Bash autocompletion.
- [x] Optimise the source code.
- [x] Improve the stability.
- [x] Improve the UI (e.g. uniformise the style and colors).
- [x] Show the status of processes running in the background.
- [ ] Validate all user inputs against regexes.
## Project Information
This script was developed in the context of my [master thesis work](https://www.slideshare.net/AlexandreTeyar/security-in-mobile-banking-apps-154409860) in June 2015.
The project was presented on Pentester Academy TV's toolbox in 2017:
[](https://www.youtube.com/watch?v=ALSChHZdf5o)
Work on a new improved version has commenced in 2018.
## Sponsor 💖
If you want to support this project and appreciate the time invested in developping, maintening and extending it; consider donating toward my next cup of coffee. ☕
It is easy, all you got to do is press the `Sponsor` button at the top of this page or alternatively [click this link](https://github.com/sponsors/aress31). 💸
## Reporting Issues
Found a bug? I would love to squash it! 🐛
Please report all issues on the GitHub [issues tracker](https://github.com/aress31/wirespy/issues).
## Contributing
You would like to contribute to better this project? 🤩
Please submit all `PRs` on the GitHub [pull requests tracker](https://github.com/aress31/wirespy/pulls).
## License
See [LICENSE](LICENSE).