Git Product home page Git Product logo

heinzguenter / esp8266-captive-portal Goto Github PK

View Code? Open in Web Editor NEW
12.0 1.0 1.0 1.62 MB

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

License: GNU General Public License v3.0

C++ 91.27% C 8.73%
captive-portal captive-portals captiveportal esp8266 esp8266-arduino esp8266-webserver wifi-captive-portal deauth deauthentication-attack deauther password-validation password-validator

esp8266-captive-portal's Introduction

ESP8266 Captive Portal

Introduction

This Captive Portal Provides Multiple Languages, a Dashboard to view and change all settings in one place, 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.

Versions

The Captive Portal comes in two versions, one for a single ESP8266 and one for dual ESP8266's. The main difference is that the singe version doesnt have a deauther(because while deauthing the Captive Portal goes unressponsive and is there for useles) and the password validation feature is a bit worse. To use the dual ESP8266 version wire them according to the schematics(The led and the button are optional) and upload the master script to your master ESP8266 and the slave script to your slave ESP8266.

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

Logs of every action are printed on the serial connection

Usage

  1. Download and add Spacehuhn's custom board to your IDE(you can follow this guide)
  2. Change or add things if you want
  3. Connect your ESP8266 to your PC and chose the right port and Board for you
  4. Press the upload button and wait for it to complete
  5. Open a web browser, and type in "192.168.1.1/dashboard" to get to the dashboard or "192.168.1.1" for the page that a normal user would see.

esp8266-captive-portal's People

Contributors

heinzguenter avatar

Stargazers

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

Watchers

 avatar

Forkers

kuglatec

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.