Skip to content

A captive portal for the NodeMCU ESP8266 with a dashboard, multy language support, password validation and a deauthing function.

License

Notifications You must be signed in to change notification settings

heinzguenter/ESP8266-Captive-Portal

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

81 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ESP8266 Captive Portal(v3.0)

Introduction

This captive portal provides multiple languages, a dashboard to view and change all settings, password validation, a function to send validatet credentials to a webhook(for example: discord webhook or webhook.site) and a deauthing function(only in the Dual ESP version). This project is a proof of concept for testing and educational purposes. Use it only against networks and devices that you have permission to! If you have any questions or suggestions just create an issue or DM me on Discord under the username: heinzguenter.

Currently Supportet languages: English and German.

Credits: Spacehuhn for inspiration on the Design of the dashboard, adamff-dev for the idea and inspiration for the design of the captive portal pages, sankethj for inspiration for parts of the code and justcallmekoko without theire projects this would probably not exist.

Ho to use

  1. To use the captive portal, wire the two ESPs together on a breadboard according to the schematics(The led and the button are optional)
  2. Clone or Download the repository and open the master and slave .ino files in the arduino ide
  3. Plug in your master ESP and upload the master script
  4. Then upload the slave script to your slave ESP8266(make sure you use spacehuhns custom boards package)
  5. Open the dashboard(192.168.178.1/dashboard) and configure the SSID
  6. To use the serial output plug the master into your pc and use the serial monitor of the arduino ide

Screenshots

192.168.1.1/ Here the User gets informed that there is an "error" and puts in there Password.

192.168.1.1/restarting This page is displayed after a Password is submitted

192.168.1.1/incorrectPass This page is displayed after you enter a wrong password

192.168.1.1/dashboard Here you can change the Language, SSID and view your captured Passwords

192.168.1.1/settings here you can change your settings

Logs of every action are printed on the serial connection