esp8266_deauther/README.md

111 lines
7.2 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
<p align="center"><img alt="PICTURE logo" src="https://raw.githubusercontent.com/wiki/spacehuhn/esp8266_deauther/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>
2018-03-27 12:02:15 +02:00
| 🌍 <a href="https://spacehuhn.de">spacehuhn.de</a><br>
<br>
<b>Scan for WiFi devices, block selected connections, create dozens of networks and confuse WiFi scanners!<br><br>
2018-04-28 19:47:16 +02:00
Click <a href="https://github.com/spacehuhn/esp8266_deauther/wiki/Installation">here</a> for the installation tutorial.<br>
Click <a href="https://github.com/spacehuhn/esp8266_deauther/releases">here</a> for the .bin files.<br><br>
2018-04-22 12:07:24 +02:00
Support the development of this project by purchasing one of the <a href="https://github.com/spacehuhn/esp8266_deauther/wiki/Supported-Devices">official deauther boards</a>.<br/>
2018-03-27 12:02:15 +02:00
Or become a patron on <a href="https://patreon.com/spacehuhn" target="_blank">patreon.com/spacehuhn</a>.<br>
Also available: <a href="https://www.tindie.com/products/Spacehuhn/spacehuhn-stickers/">Stickers</a></b>!
2017-07-23 15:00:42 +02:00
</p>
2017-06-05 20:46:25 +02:00
2020-05-07 23:47:59 +02:00
# [👉 Wiki](https://github.com/SpacehuhnTech/esp8266_deauther/wiki)
# [👉 Binaries](https://github.com/SpacehuhnTech/esp8266_deauther/releases)
# [👉 Development Boards](https://github.com/SpacehuhnTech/esp8266_deauther/wiki/Supported-Devices)
2018-03-24 18:15:59 +01:00
## What is New
2018-03-26 21:03:19 +02:00
[Here is a quick video about what is new](https://youtu.be/6oRmm3xfp6U)
2018-03-24 18:15:59 +01:00
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
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.
2018-03-25 18:46:11 +02:00
No one seems to care about this huge vulnerability in the official 802.11 WiFi standard, so I took action and enabled everyone who has less than 10 USD to spare to recreate this project.
2018-03-24 18:15:59 +01:00
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.
2018-10-03 23:07:09 +02:00
To effectively prevent a deauthentication attack, both client and access point must support the 802.11w standard with protected management frames (PMF).
2018-03-24 18:15:59 +01:00
While most client devices seem to support it when the access point forces it, basically no WiFi access point has it enabled.
2018-03-26 19:10:59 +02:00
Feel free to test your hardware out, annoy these companies with the problem, share this project and push for a fix!
2018-03-24 18:15:59 +01:00
This project is also a great way to learn more about WiFi, micro controllers, Arduino, hacking and electronics/programming in general.
2018-03-25 18:46:11 +02:00
**But please use this tool responsibly and do not use it against others without their permission!**
2018-03-24 18:15:59 +01:00
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
## Official Deauther Boards
2018-04-05 13:21:25 +02:00
![PICTURE DSTIKE Deauther OLED Board](https://raw.githubusercontent.com/wiki/spacehuhn/esp8266_deauther/img/DSTIKE_Deauther_Board.jpg)
2018-10-03 23:07:09 +02:00
If you want to support the development of this project, you can buy one of the official 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)
Those boards are optimized for this project, ready to use and come preflashed with the Deauther software!
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
## 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-25 18:46:11 +02: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-10-03 23:07:09 +02: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 explanation 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
## 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-31 02:19:25 +02:00
Also thanks to everyone that supports this project by [donating](http://spacehuhn.de/donate), being 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.