Commit 3bbbf8e
Changed files (3)
assets/Demo.mp4
Binary file
.gitignore
@@ -0,0 +1,25 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+build
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
Readme.md
@@ -1,26 +1,28 @@
<div id="top"></div>
-[![MIT License][license-shield]][license-url]
-[![YouTube][youtube-shield]][youtube-url]
-
<!-- PROJECT LOGO -->
-<br />
-<div align="center">
+<div align="center" style="display: flex; align-items: center; justify-content: center;">
<a href="https://github.com/The-Robin-Hood/deauth_portal">
- <img src="/images/logo.png" alt="Logo" width="490px" height="230px">
+ <img src="/captive_portal/data/png/router.png" alt="Logo">
</a>
+ <h1 style="color: #7777AB;"
+ > Portal Xtend </h1>
</div>
+<p align="center" style="font-weight: bold; font-size: 20px;color:#7777AB;">Version 2.0.0</p>
-Version 1.0.0
<!-- ABOUT THE PROJECT -->
## About The Project
-This project implements a captive portal for WiFi networks that allows users to upload handshakes and expose the password of the victim. When victim connects with the WiFi network created by the ESP8266 board, they will be redirected to the captive portal page. This page shows that the WiFi needs to be upgraded with a prompt to the user to enter the password.
-This password is checked against the password of the handshakes uploaded by the user. If the password matches, the victim is redirected to the final page which shows fake wifi upgrading process. If the password does not match, the victim is alerted that the password is incorrect.
+- This project implements a captive portal for WiFi networks.
+- Users can upload handshakes to expose the password of the victim.
+- When the victim connects to the WiFi network created by the ESP8266 board, they are redirected to a captive portal page.
+- The captive portal page prompts the user to enter their password, claiming that a WiFi upgrade is required.
+- The entered password is checked against the uploaded handshakes.
+- If the password matches, the victim is shown a fake WiFi upgrading process.
+- If the password is incorrect, the victim is alerted that the password is wrong.
<!-- GETTING STARTED -->
## Getting Started
-
### Prerequisites
To run this project, you will need:
@@ -50,12 +52,15 @@ ssid: The name of the WiFi network you want to create.
### Running
1. Connect to the WiFi network created by the ESP8266 board (the default SSID is "Free Wifi").
-2. Open a web browser and navigate to http://172.0.0.1/handshake.
-3. Upload a handshake file if you have one else this step can be skipped.
-4. Navigate to http://172.0.0.1/ssid and change the SSID of the WiFi network.
+2. Open a web browser and navigate to http://172.0.0.1/attack.
+3. Change the SSID of the WiFi network to the name of the WiFi network you want to attack.
+4. Go to Setup section and upload the handshakes file if you have one else this step can be skipped.
+5. Go to Networks Section and start deauth attack on the target WiFi network.
(Note: When there is no handshake uploaded by the user then when a victim enters the password and submits it, for the first time they will be alerted that the password is incorrect. This is because to make the victim the site is upgrading, the password is checked against the real password of the WiFi network. After that, the second time the victim will be redirected to the final page which shows fake wifi upgrading process.)
+### Interface Demo
+<video src="./assets/Demo.mp4" controls></video>
## Usage
### Commands
The following commands can be entered via the serial monitor (at a baud rate of 115200) to interact with the ESP8266 board:
@@ -66,14 +71,17 @@ The following commands can be entered via the serial monitor (at a baud rate of
- show datas: Show the contents of the datas.json file.
- reset ssid: Reset the config.json file to use the default SSID ("Free Wifi").
- storage info: Show the available space on the file system.
+- scan : Scan for WiFi networks.
+- list networks: List the WiFi networks found by the scan command.
+- deauth [ap num]: Deauthenticate an access point.
+- stop deauth: Stop all deauthentication attacks.
### APIs
The following HTTP APIs are provided by the ESP8266 board:
**These APIs are for serving pages.**
- `GET /` : Serve the captive portal page.
-- `GET /handshake` : Serve the page to capture handshakes.
-- `GET /ssid` : Serve the page to change the SSID of the WiFi network.
+- `GET /attack` : Serve the attack page.
**These APIs are for actions can be performed by the user.**
- `GET /get_datas` : Get the captured handshakes and cracked passwords in JSON format.
@@ -81,8 +89,7 @@ The following HTTP APIs are provided by the ESP8266 board:
- `GET /clear_passwords` : Clear the cracked passwords.
## Educational Purpose
-This project is for educational purposes only. So Kindly use it at your own risk.
-I am not responsible for any misuse of this project.
+This project is intended for educational purposes only. Please be aware that any use of this project is at your own risk. I cannot be held responsible for any misuse or unauthorized actions taken with this project.
## Contributing
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**. If you want to contribute to this project, you can create a pull request with your changes. Before submitting a pull request, make sure that your changes pass all tests and conform to the project's coding standards.
@@ -93,25 +100,19 @@ Contributions are what make the open source community such an amazing place to b
Distributed under the MIT License. See `LICENSE` for more information.
<!-- CONTACT -->
-## Contact
+### Contact
-[![Twitter][twitter-shield]][twitter-url]
-[![YouTube][youtube-shield]][youtube-url]
-[![Mail][yahoo-shield]][yahoo-url]
-[![LinkedIn][linkedin-shield]][linkedin-url]
+[![Twitter][twitter-shield]][twitter-url] [![Instagram][instagram-shield]][instagram-url] [![YouTube][youtube-shield]][youtube-url]
-Project Link: https://github.com/The-Robin-Hood/Portal-Xtend
<p align="right">(<a href="#top">back to top</a>)</p>
<!-- MARKDOWN LINKS & IMAGES -->
[license-url]: https://github.com/The-Robin-Hood/portal-xtend/blob/master/LICENSE
[license-shield]: https://img.shields.io/github/license/The-Robin-Hood/dropit.svg
-[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?logo=linkedin&colorB=blue
-[linkedin-url]: https://linkedin.com/in/ansari-s
[youtube-shield]: https://img.shields.io/badge/-YouTube-red.svg?logo=youtube&colorB=red
[youtube-url]: https://www.youtube.com/@amsorry
[twitter-shield]: https://img.shields.io/badge/-Twitter-blue.svg?logo=twitter&colorB=blue
-[twitter-url]: https://twitter.com/amsorry_offl
-[yahoo-shield]: https://img.shields.io/badge/-Email-red.svg?logo=yahoo&colorB=red
-[yahoo-url]: mailto:ansari_official@yahoo.com
\ No newline at end of file
+[twitter-url]: https://twitter.com/am5orry
+[instagram-shield]: https://img.shields.io/badge/-Instagram-blue.svg?logo=instagram&colorB=purple
+[instagram-url]: https://instagram.com/amsorry_offl
\ No newline at end of file