Stefan Kremser d66fd37774 Update README.md
2017-01-07 15:22:13 +01:00
2017-01-07 14:40:44 +01:00
2017-01-07 14:39:23 +01:00
2017-01-07 14:39:23 +01:00
2017-01-07 15:22:13 +01:00

esp8266_deauther

WiFi deauther Build your own WiFi jammer for under $10 with an ESP8266.

Introduction

What it is:

Basically its a device which performs a deauth attack. You select the clients you want to disconnect from their network and start the attack. As long as the attack is running, the selected clients are not able to connect to the network.

How it works:

The 802.11 WiFi protocol contains a so called deauthentication frame. It is used to disconnect clients safely from a wireless network.

For example your smartphone will send such a frame to its connected network when you turn the WiFi off. The router then knows that you are no longer a part of the network and stops sending you packets.

When you just get out of the range of your WiFi network, the router wouldnt notice it and would send you data and wait for your answer. After some time you get a timeout and the router kicks you off the network anyway. But for the sake of resources and to prevent errors, these packets were invented.

Because they are unencrypted, you just need the mac address of the WiFi router and of the client device which you want to disconnect from the network. You dont even have to be in the network or know the password, its enough to be in its range.

What an ESP8266 is:

The ESP8266 a very cheap micro controller with build in WiFi. It contains a powerfull 160 MHz processor and you can program it with the Arduino IDE. This makes it perfect for this project.

You can buy these chips for under $2 from China. But I recommend you to buy one of the USB breakout/developer boards. It doesnt matter which board you use, as long as it has an ESP8266 on it.

How to protect yourself:

With 802.11w-2009 WiFi got an update to encrypt management frames. So make sure your router is up to date and has management frame protection enabled. But be sure that your client device supports it too, both ends need to have it enabled!

The only problem is that most devices dont use it. I tested it with different WiFi networks and client devices now and it worked every time. It seems that even newer devices which support frame protection, dont use it by default. Disclaimer

Use it only for testing purposes on your own devices!

Please check the legal regulations in your country before using it. Jamming transmitters are illegal in most countries and this device can fall into the same category (even if its technically not the same).

My intention with this project is to draw attention to this issue. This attack shows how vulnerable the 802.11 WiFi standard is and that we need to fix it. A solution is already there, why dont we use it?

Tutorial

coming soon :)

Sources and additional links

deauth attack: https://en.wikipedia.org/wiki/Wi-Fi_deauthentication_attack

deauth frame: https://mrncciew.com/2014/10/11/802-11-mgmt-deauth-disassociation-frames/

ESP8266: https://de.wikipedia.org/wiki/ESP8266

https://espressif.com/en/products/hardware/esp8266ex/overview

packet injection with ESP8266: http://hackaday.com/2016/01/14/inject-packets-with-an-esp8266/

http://bbs.espressif.com/viewtopic.php?f=7&t=1357&p=10205&hilit=wifi_pkt_freedom#p10205

https://github.com/pulkin/esp8266-injection-example

802.11w-2009: https://en.wikipedia.org/wiki/IEEE_802.11w-2009

Description
Affordable WiFi hacking platform for testing and learning
Readme MIT 25 MiB
Languages
C++ 47.5%
C 44.4%
Python 4.3%
HTML 1.5%
JavaScript 1.3%
Other 1%