alpha-1729 / esp_wifi_captive_portal

ESP8266 WiFi captive portal for phishing WiFi passwords.

ESP8266 Wifi Captive Portal

WiFi captive portal for the NodeMCU (ESP8266 Module) with DNS spoofing.

Original Author

Disclaimer

This project is for testing and educational purposes. Use it only against your own networks and devices. I don't take any responsibility for what you do with this program.

Features

• 💪 The LED will blink 5 times when a password is posted.

• 💪 All captured password will be stored in the ESP8266 itself.

• 💪Your saved passwords will not disappear when you:

  • ▶️ Restart/power off the ESP8266.
  • ▶️ Change the SSID.

• 💪 You can clear saved password when necessary.

• 💪 You can change the SSID name from the portal itself.

Working

• Passwords and SSID will be stored in the EEPROM of the ESP8266.
• EEPROM Memory location:
  • 0-19 ▶️ For storing SSID.
  • 20-24 ▶️ To check the first boot of ESP8266.
  • 30-END ▶️ For storing password.
• When ESP8266 boots for the first time, it checks the data in memory location (20-24) in EEPROM.
• After the first boot, it only loads the SSID and all passwords in the EEPROM.
• If there is no SSID in the EEPROM, default SSID will be set.

Usage

• ✏️ Changing the SSID: ▶️ 172.0.0.1/ssid◀️
• 💥Clearing the passwords: ▶️ 172.0.0.1/clear◀️
• 🙈 To see saved passwords: ▶️ 172.0.0.1/pass◀️
• 📜 Testing victim page: ▶️ 172.0.0.1/index◀️

Demo Video

Screenshot

172.0.0.1/index	172.0.0.1/post	172.0.0.1/pass	172.0.0.1/ssid
This is the main page. Here the user will write his password and send it.	This is the post page. The user will be redirected here after posting the password.	This is where the attacker can retrieve all the passwords that has been posted and saved passwords can be cleared.	Here the attacker can change the SSID name of the Access Point on the go.

Installation

1. ESP8266 Flasher - Easy way

1. Download ESP8266 Flasher.

2. Download the esp-wifi-captive-portal-v1.0.bin file.

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

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

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

6. Your Node MCU is ready!

2. Arduino IDE

1. Open your Arduino IDE and go to File 🔎 Preferences 🔎 Boards Manager URLs and paste the following link: https://arduino.esp8266.com/stable/package_esp8266com_index.json
2. Go to Tools 🔎Board 🔎 Boards Manager, search "esp8266" and install esp8266.
3. Go to Tools 🔎 Board and select you board.
4. Download and open the sketch "esp-wifi-captive-portal.ino".
5. You can optionally change some parameters like the SSID name and texts of the page like title, subtitle, text body...
6. Upload the code into your board.
7. You are done!

Note

• After uploading the code, first clear the passwords already in the EEPROM.
• If any error happens, kindly report the issue.

esp_wifi_captive_portal's Issues

There is a compilation error in funtion String postedSSID()

This error occurred while compiling in Arduino IDE

C:\Users\HP\AppData\Local\Temp\.arduinoIDE-unsaved202341-25240-19sjolq.b2lc\sketch_may1a\sketch_may1a.ino: In function 'String postedSSID()':
C:\Users\HP\AppData\Local\Temp\.arduinoIDE-unsaved202341-25240-19sjolq.b2lc\sketch_may1a\sketch_may1a.ino:124:1: error: no return statement in function returning non-void [-Werror=return-type]
  124 | }
      | ^
cc1plus.exe: some warnings being treated as errors

exit status 1

Compilation error: no return statement in function returning non-void [-Werror=return-type]

Add Deauth Button

Please Added Deauth Button

I Have A Big Request

Sir, I Appreciate and love your project
As you have fixed many of the captive portal problems from the "125K" project
I believe about 80% people use TP Link Router as their own Wi-Fi Device
And this time i just want to say please make a wifi captive portal of TP Link Router
I have searched a lot for the TP Link Captive Portal
But i have just founded an website that provides me such information of TP Link Captive Portal
And also founded a github project repository of the source code
But in that website they mentioned about Micro Python and i really a beginner about that thing
So please sir, make a TP Link Captive Portal by modifying the source Code
Please translate the website if you're unable to understand
Project Website
Github Source Code

Credentials cleans after reboot

Sir, it gets cleaned all passwords after reboot or power off and in the passwords list, it show a long (????) question mark
I have tried to flash the bin file in many ways but same here.

Request add a deauth button

Plz add add a deauth button so you can deauth the real network and change the esp network name to to one ur trying to get there password if you add deauthing option this would be the perfect project I'll be waiting for you to add that feature hopefully soon
-thanks