esp8266_deauther/README.md

103 lines
6.5 KiB
Markdown
Raw Normal View History

2018-03-24 18:15:59 +01:00
# ESP8266 Deauther 2.0
2017-06-05 20:46:25 +02:00
2018-03-24 18:19:51 +01:00
<p align="center"><img alt="logo" src="https://raw.githubusercontent.com/spacehuhn/esp8266_deauther/master/img/deauther_logo.png" width="200"></p>
2017-06-05 20:46:25 +02:00
2017-07-23 15:00:42 +02:00
<p align="center">
🐦 <a href="https://twitter.com/spacehuhn">Twitter</a>
| 📺 <a href="https://www.youtube.com/channel/UCFmjA6dnjv-phqrFACyI8tw">YouTube</a>
| 🌍 <a href="https://spacehuhn.de">spacehuhn.de</a><br/>
<br />
2018-03-24 18:19:51 +01:00
<b>Support the development of this project by purchasing one of the <a href="https://github.com/spacehuhn/deauther2.0/wiki/Supported-Devices">official deauther boards</a>.<br/>Or become a patron on <a href="https://patreon.com/spacehuhn" target="_blank">patreon.com/spacehuhn</a>.</b>
2017-07-23 15:00:42 +02:00
</p>
2017-06-05 20:46:25 +02:00
2018-03-24 18:15:59 +01:00
## What is New
Version 2.0:
- Completly rewritten code base for better performance and later enhancements
- Custom Deauther SDK for easy compiling using Arduino
- New serial command line interface to control and debug the program
- New display UI with a lot of new functions
- Improved web interface with multi-language support
- Improved scanning for access points and stations (+ continuous scanning mode)
- Save and select device names for both scanning and attacking
- Save up to 60 SSIDs and 25 devices in one list (you can create, load and save multiple lists)
- Added [PacketMonitor](https://github.com/spacehuhn/PacketMonitor) to display UI
- Deauth detection when scanning
- RGB LED support for a quick indication what the device is doing (attacking, scanning, ...)
2018-03-24 18:18:08 +01:00
- Better documentation on the new [wiki](https://github.com/spacehuhn/esp8266_deauther/wiki)
2018-03-24 18:15:59 +01:00
## About this project
**Scan for access points, client devices, disconnect them, create dozens of fake WiFi networks and confuse other wireless scanners!**
This software allows you to easily perform a variety of actions to test 802.11 wireless networks by using an inexpensive ESP8266 WiFi SoC (System On A Chip).
The main feature, the deauthentication attack, is used to disconnect devices from their WiFi network.
No one seems to care about this huge vulnerability in the official 802.11 WiFi standard, so I took action and enabled everyone with less than 10 USD to recreate this project.
I hope it raises more attention on the issue. In 2009 the WiFi Alliance actually fixed the problem (see [802.11w](https://en.wikipedia.org/wiki/IEEE_802.11w-2009)), but only a few companies implemented it into their devices and software.
To effectively prevent a deauthentication attack, both client and access point must support the 802.11w standard with protected managment frames (PMF).
While most client devices seem to support it when the access point forces it, basically no WiFi access point has it enabled.
Feel free to test your hardware, annoy these companies with the problem, share this project and push for a fix!
This project is also a great way to learn more about WiFi, micro controllers, Arduino, hacking and electronics/programming in general.
**But please use this tool responsably and do not use it against others without their permission!**
2018-03-24 18:18:08 +01:00
The difference between deauthing and jamming: [click me](https://github.com/spacehuhn/esp8266_deauther/wiki/FAQ#difference-between-jammer-and-deauther)
2017-06-05 20:46:25 +02:00
## Disclaimer
2018-03-24 18:15:59 +01:00
This project is a proof of concept for testing and educational purposes.
2018-03-24 18:34:17 +01:00
Neither the ESP8266, nor its SDK was meant or built for such purposes. Bugs can occur!
2017-06-14 19:53:43 +02:00
2017-07-23 15:00:42 +02:00
Use it only against your own networks and devices!
2017-06-05 20:46:25 +02:00
Please check the legal regulations in your country before using it.
2018-03-24 18:15:59 +01:00
I don't take any responsibility for what you do with this program.
2017-06-05 20:46:25 +02:00
2018-03-24 18:15:59 +01:00
It is not a frequency jammer as claimed falsely by many people. Its attack, its method and how to protect against it is described above. It uses valid Wi-Fi frames described in the IEEE 802.11 standard and doesn't block or disrupt any frequencies.
2017-06-05 20:46:25 +02:00
2018-03-24 18:15:59 +01:00
This project is meant to draw more attention on this issue.
The [deauthentication](https://en.wikipedia.org/wiki/Wi-Fi_deauthentication_attack) attack shows how vulnerable the 802.11 Wi-Fi standard is and that it has to be fixed.
A solution is already there, why don't we use it?
2017-06-05 20:46:25 +02:00
2018-03-24 18:15:59 +01:00
**Please don't refer to this project as "jammer", that totally undermines the real purpose of this project!**
2018-03-24 18:34:17 +01:00
If you do, it only proves that you didn't understand anything of what this project stands for. Publishing content about this without a proper explaination shows that you only do it for the clicks, fame and/or money and have no respect for intellectual property, the community behind it and the fight for a better WiFi standard!
2017-06-05 20:46:25 +02:00
2018-03-24 18:15:59 +01:00
## Getting Started
2017-06-05 20:46:25 +02:00
2018-03-24 18:18:08 +01:00
Visit our new [Wiki](https://github.com/spacehuhn/esp8266_deauther/wiki) on how to recreate this project and use it.
2018-03-24 18:15:59 +01:00
Happy Hacking!
2017-06-05 20:46:25 +02:00
2018-03-24 18:15:59 +01:00
## Official Deauther Boards
2017-06-05 20:46:25 +02:00
![PICTURE DSTIKE Deauther OLED Board](https://raw.githubusercontent.com/spacehuhn/esp8266_deauther/master/img/DSTIKE_Deauther_Board.jpg)
2017-06-05 20:46:25 +02:00
2018-03-24 18:15:59 +01:00
If you want to support the development of this project, you can buy one of the offical boards by DSTIKE (Travis Lin) on following sites:
- [Tindie](https://tindie.com/stores/lspoplove)
- [AliExpress](https://dstike.aliexpress.com/store/2996024)
- [Taobao](https://shop135375846.taobao.com)
2017-06-05 20:46:25 +02:00
2018-03-24 18:15:59 +01:00
Those boards are optimized for this project, ready to use and come preflashed with the Deauther software!
2018-03-24 18:18:08 +01:00
For more details visit the [Wiki](https://github.com/spacehuhn/esp8266_deauther/wiki) under [Supported Devices](https://github.com/spacehuhn/esp8266_deauther/wiki/Supported-Devices).
2017-06-05 20:46:25 +02:00
2018-03-24 18:15:59 +01:00
## Credits
A huge thanks to:
- [@deantonious](http://github.com/deantonious)
- [@jLynx](https://github.com/jLynx)
- [@lspoplove](https://github.com/lspoplove)
- [@schinfo](https://github.com/schinfo)
- [@tobozo](https://github.com/tobozo)
- [@xdavidhu](https://github.com/xdavidhu)
- [@PwnKitteh](https://github.com/PwnKitteh)
2017-06-05 20:46:25 +02:00
2018-03-24 18:15:59 +01:00
for helping out with various things regarding this project and keeping it alive!
2017-06-05 20:46:25 +02:00
2018-03-24 18:15:59 +01:00
I also want to thank Espressif and their community for this awesome chip and all the software and hardware projects around it and the countless tutorials you can find online!
2017-06-05 20:46:25 +02:00
2018-03-24 18:15:59 +01:00
Shoutout to everyone working on the libraries used for this project:
- [esp8266-oled-ssd1306](https://github.com/ThingPulse/esp8266-oled-ssd1306)
- [ArduinoJson](https://github.com/bblanchon/ArduinoJson)
- [LinkedList](https://github.com/ivanseidel/LinkedList)
2017-06-05 20:46:25 +02:00
2018-03-24 18:34:17 +01:00
Also thanks to everyone that supports this project by [donating](http://spacehuhn.de/donate), beeing my [patron](http://patreon.com/spacehuhn) or buying one of the [official Deauther boards](https://www.tindie.com/stores/lspoplove) from DSTIKE.
2017-07-23 15:00:42 +02:00
## License
2017-06-05 20:46:25 +02:00
2017-07-23 15:00:42 +02:00
This software is licensed under the MIT License. See the [license file](LICENSE) for details.