mirrors
/
esp8266_deauther
mirror of https://github.com/SpacehuhnTech/esp8266_deauther.git
2
0
Fork 0
Code Issues Projects Releases Wiki Activity

Update README.md

This commit is contained in:
Stefan Kremser 2017-01-13 21:14:41 +01:00 committed by GitHub
parent 063f38a012
commit ece4df868c
1 changed files with 49 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

63
README.md
View File

@ -1,15 +1,29 @@
# esp8266_deauther
Build your own WiFi jammer for under $10 with an ESP8266.
# ESP8266 Deauther
Build your own WiFi jammer with an ESP8266.
# Introduction
![esp8266 deauther with a smartphone](https://raw.githubusercontent.com/spacehuhn/esp8266_deauther/master/screenshots/smartphone_esp_1.jpg?token=ADphfABZE5u9AIYeyizA0936U90pZUFtks5Ygm63wA%3D%3D)
## What it is:
## Contents
- [Introduction](#introduction)
- [What it is](#what-it-is)
- [How it works](#how-it-works)
- [What an ESP8266 is](#what-an-esp8266-is)
- [How to protect against it](#how-to-protect-against-it)
- [Disclaimer](#disclaimer)
- [Installation](#installation)
- [How to use it](#how-to-use-it)
- [Sources and additional links](#sources-and-additional-links)
- [License](#license)
## Introduction ##
### What it is
Basically it’s a device which performs a [deauth attack](https://en.wikipedia.org/wiki/Wi-Fi_deauthentication_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 devices are not able to connect to the network.
## How it works:
### How it works
The 802.11 WiFi protocol contains a so called [deauthentication frame](https://mrncciew.com/2014/10/11/802-11-mgmt-deauth-disassociation-frames/). It is used to disconnect clients safely from a wireless
network.
@ -24,14 +38,14 @@ 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 don’t even have to be in the network or know the password, it’s enough to be in its range.
## What an ESP8266 is:
### What an ESP8266 is
The [ESP8266](https://de.wikipedia.org/wiki/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](https://www.arduino.cc/en/Main/Software). This makes it perfect for this project.
You can buy these chips for under $2 from China!
## How to protect yourself:
### How to protect against it
With [802.11w-2009](https://en.wikipedia.org/wiki/IEEE_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
@ -40,7 +54,7 @@ supports it too, both ends need to have it enabled!
The only problem is that most devices don’t 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, don’t use it by default.
# Disclaimer
## Disclaimer
Use it only for testing purposes on your own devices!
@ -51,12 +65,13 @@ 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 it has to be fixed.
**A solution is already there, why don’t we use it?**
# Tutorial
## Installation
The only thing you will need is a computer and an ESP8266.
I recommend you to buy one of the USB breakout/developer boards.
It doesn’t matter which board you use, as long as it has an ESP8266 on it.
I recommend you to buy one of the USB breakout/developer boards with 4mb flash size.
It doesn’t matter which board you use, as long as it has an ESP8266 on it.
If you using an ESP-01 or other chips with just 1mb, you can comment out the mac vendor list in data.h.
**1** Install [Arduino](https://www.arduino.cc/en/Main/Software) and open it.
@ -72,7 +87,7 @@ It doesn’t matter which board you use, as long as it has an ESP8266 on it.
![screenshot of arduino, selecting the right version](https://raw.githubusercontent.com/spacehuhn/esp8266_deauther/master/screenshots/arduino_screenshot_1.JPG)
**7** Go to `File` > `Preferences`again
**7** Go to `File` > `Preferences`
**8** Open the folder path under `More preferences can be edited directly in the file`
@ -102,16 +117,32 @@ If no port shows up you may have to reinstall the drivers.
**Your ESP8266 Deauther is now ready!**
## How to use it
First start your ESP8266 by giving it power.
You can use your smartphone if you have a OTG USB cable.
![esp8266 deauther with a smartphone](https://raw.githubusercontent.com/spacehuhn/esp8266_deauther/master/screenshots/smartphone_esp_2.jpg?token=ADphfAcPwuqXZ3iZnLa5l2TZM4e4FO05ks5Ygm65wA%3D%3D)
Scan for WiFi networks and connect to `pwned`. The password is `deauther`.
Once connected, you can open up your browser and go to `192.168.4.1`.
![webinterface of the deauther device](https://raw.githubusercontent.com/spacehuhn/esp8266_deauther/master/screenshots/web_screenshot_1.JPG)
You can now scan for networks, client devices and start different attacks.
You can now scan for networks...
![webinterface AP scanner](https://raw.githubusercontent.com/spacehuhn/esp8266_deauther/master/screenshots/web_screenshot_1.JPG?token=ADphfCKndMnVl6dv8a_IX2ZO4t2Vs4GCks5Ygm3JwA%3D%3D)
scan for client devices...
![webinterface client scanner](https://raw.githubusercontent.com/spacehuhn/esp8266_deauther/master/screenshots/web_screenshot_2.JPG?token=ADphfGv3ziQy3LmQvqB1yIAECuQmhAlOks5Ygm3KwA%3D%3D)
Note: While scanning the ESP8266 will shut down its access point, so you may have to go to your settings and reconnect to the WiFi network manually.
...and start different attacks.
![webinterface attack menu](https://raw.githubusercontent.com/spacehuhn/esp8266_deauther/master/screenshots/web_screenshot_3.JPG?token=ADphfA6PIeuMzISlWw5BJM-qzY7KbTtDks5Ygm3MwA%3D%3D)
Happy hacking :)
# Sources and additional links
## Sources and additional links
deauth attack: https://en.wikipedia.org/wiki/Wi-Fi_deauthentication_attack
@ -131,3 +162,7 @@ packet injection with ESP8266:
wifi_send_pkt_freedom function limitations: http://esp32.com/viewtopic.php?f=13&t=586&p=2648&hilit=wifi_send_pkt_freedom#p2648
esp32 esp_wifi_internal function limitations: http://esp32.com/viewtopic.php?f=13&t=586&p=2648&hilit=wifi_send_pkt_freedom#p2648
## License
This project is licensed under the MIT License - see the [license file](LICENSE) file for details