GithubHelp home page GithubHelp logo

oceanofanythingofficial / deviltwin-nodemcu Goto Github PK

View Code? Open in Web Editor NEW
30.0 2.0 0.0 2.66 MB

⚡ Perform Evil Twin Attack Using NodeMCU Board

Home Page: https://oceanofanythingofficial.github.io/DevilTwin-NodeMCU/

License: MIT License

C++ 100.00%
captive-portal esp32 esp8266 evil-twin hacking-tool nodemcu nodemcu-esp8266 nodemcu-project penetration-testing penetration-testing-tools pentesting rogueap wifi wifi-board wifi-hacking deviltwin

deviltwin-nodemcu's Introduction


GitHub code size in bytes GitHub Repo Version GitHub Repo stars OS - Linux OS - macOS OS - Windows Hosted with GH Pages maintained - yes
view - Documentation

DevilTwin NodeMCU

An evil twin attack is a spoofing cyberattack that works by tricking users into connecting to a fake Wi-Fi access point that mimics a legitimate network. Once a user is connected to an “evil twin” network, hackers can access everything from their network traffic to private login credentials.

About This Project

Welcome to the project DevilTwin. This Exactly Works like the Evil Twin Attack. This is a simple project to demonstrate how easy it is to capture data from a Wi-Fi network. This project is based on the ESP8266 and uses the Arduino framework. It is able to de-authentificate clients of a given Wi-Fi network continuously.

This is possible due to a vulnerability in the Wi-Fi protocol (WPA/WPA2). This attack is performed by forcing the client(s) to de-authenticate themselves from the access point, then capturing the 4-way handshake when attempting to reconnect to the access point.

After that, the handshake can be brute forced to reveal the password of the access point. This attack is performed on the access point itself, not the clients. It is highly effective on most modern Wi-Fi networks.

You don't even need to brute force the handshake, the NodeMCU Board will act as the access point that you wanted to attack, and will show a fake firmware update page, and when the user enters the password, it will be shown on the admin page of the NodeMCU Board.

Even if the user enters the wrong password, it will be shown to the user that a wrong password is entered, and the user will be redirected to the same page again. This will make the user think that the password is wrong, and he will enter the correct password, and the password will be shown on the admin page of the NodeMCU Board.

Use this tool only on networks that you have permission for.

Change Log

  • Removed AsyncWebServer due to performance and stability
  • Reworked deauthing - now it changes channel so deauthing can work properly

Note: This Project Is Licensed Under MIT License and Is Only for Educational Purposes. I Am Not Responsible for Any Misuse of This Project.

Installation (ESP8266 Flasher - Easy way)

  1. Download ESP8266 Flasher.

  2. Download the DevilTwin-NodeMCU.ino.bin file.

  3. Open the ESP8266 Flasher and select the Node MCU port

  1. Then, go to the config tab and select the .bin file you've just downloaded.

  1. Finally, go back to the first tab and press "Flash"

  2. Your Node MCU is ready!

Installation (Arduino IDE)

  1. Open your Arduino IDE and go to "File -> Preferences -> Boards Manager URLs" and paste the following links (You Can Use Multiple Links Separated By Commas): https://dl.espressif.com/dl/package_esp32_index.json, http://arduino.esp8266.com/stable/package_esp8266com_index.json

  2. Go to "Tools -> Board -> Boards Manager", search "esp8266" and install esp8266

  3. Then Go To "Tools -> Manage Libraries", search "Senses_wifi" and install Senses_wifi

  4. Go to "Tools -> Board" and select your board

  5. Download and open the sketch "DevilTwin-NodeMCU.ino"

  6. You can optionally change some parameters like the SSID name and texts of the page like title, subtitle, text body etc.

  7. Upload the code into your board.

  8. You are done!

Note: Deauthing might not work on some phones due to the fact that this project uses broadcast as station target (attacks everyone on network and not specific client).

Usage Instructions

  1. Connect to the AP named "DevilTwin" with password "12345678" from your phone/PC.

  1. Select the target you want (list of available APs refreshes every 30secs - page reload is required)

  2. Click the Start Evil-Twin button and reconnect to the newly created AP named same as your target (will be open)

  3. After connecting, make sure you choose "Use this network as is" (may differ on different devices)

  4. Go to your favorite browser and navigate to 192.168.4.1/admin

  1. Once there DO NOT change your target, only start/stop deauthing and wait for someone to try and use the correct password.

  2. If the user enters a password, and the password does't matches the handshake file, an error message will be shown to the user and the user will be asked to enter the correct password.

  1. Once correct password is found, AP will be restarted with default ssid "DevilTwin" with password "12345678" and at the bottom of a table you should be able to see something like "Successfully got password for - SSID - Password

If you have any questions, feel free to post in the issues section

deviltwin-nodemcu's People

Contributors

oceanofanythingofficial avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

deviltwin-nodemcu's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.