Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/caronero/instagram_portal
A captive portal project for ESP8266 that simulates Instagram login page.
https://github.com/caronero/instagram_portal
arduino esp32 esp8266 pentesting social-engineering-attacks wifi-hacking wifi-security
Last synced: 4 days ago
JSON representation
A captive portal project for ESP8266 that simulates Instagram login page.
- Host: GitHub
- URL: https://github.com/caronero/instagram_portal
- Owner: caronero
- License: gpl-3.0
- Created: 2025-01-14T19:11:06.000Z (15 days ago)
- Default Branch: main
- Last Pushed: 2025-01-14T19:22:59.000Z (15 days ago)
- Last Synced: 2025-01-14T20:36:00.844Z (15 days ago)
- Topics: arduino, esp32, esp8266, pentesting, social-engineering-attacks, wifi-hacking, wifi-security
- Language: C++
- Homepage:
- Size: 39.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📱 Instagram Portal WiFi Captive
## 👨💻 Author
- **Caro Nero** - *Initial work* - [caronero](https://github.com/caronero)
### Connect with me:
[](https://github.com/caronero)
[](https://www.youtube.com/@caronero)
[](https://instagram.com/cn_zd46)
[](https://t.me/cn_zd)
```
┌──────────────┐
│ ESP8266 │
│ WiFi Portal │
└──────────────┘
│
▼
┌──────────────┐
│ Captive │
│ Portal │
└──────────────┘
│
▼
┌──────────────────────┐
│ Instagram Interface │
└──────────────────────┘
```
## 🌟 System Overview
```
┌─────────────────┐ ┌──────────────┐ ┌──────────────┐
│ User Device │ ──── │ ESP8266 │ ──── │ Admin Panel │
│ (Phone/PC) │ │ WiFi Portal │ │ /admin │
└─────────────────┘ └──────────────┘ └──────────────┘
│
▼
┌──────────────┐
│ Credential │
│ Storage │
└──────────────┘
```
## 📱 Interface Preview
```
┌────────────────────────────┐
│ Instagram Login │
├────────────────────────────┤
│ ┌──────────────────┐ │
│ │ Instagram │ │
│ └──────────────────┘ │
│ │
│ ┌──────────────────┐ │
│ │ Username │ │
│ └──────────────────┘ │
│ │
│ ┌──────────────────┐ │
│ │ Password │ │
│ └──────────────────┘ │
│ │
│ ┌──────────────────┐ │
│ │ Log In │ │
│ └──────────────────┘ │
└────────────────────────────┘
```
## 📝 Project Description
An advanced ESP8266-based system that creates a WiFi access point with a captive portal simulating the Instagram login interface. Perfect for educational purposes and understanding how wireless network portals work.
## ✨ Key Features
- 🎯 Pixel-perfect Instagram login interface clone
- 🌐 Automatic captive portal redirection
- 💾 Secure credential storage system
- 🔐 Password-protected admin dashboard
- 📱 Responsive design for all devices
- ⚡ Fast and reliable connection
- 🔄 Automatic WiFi network broadcast
- 📊 Real-time connection monitoring
## 🛠️ Hardware Requirements
- ESP8266 Development Board (Recommended models):
- NodeMCU ESP8266
- Wemos D1 Mini
- ESP-12E Module
- Micro USB cable for programming
- Power source (USB/Battery)
## 💻 Software Requirements
### Required Tools
- Arduino IDE (2.0+ recommended)
- ESP8266 Board Package
- Web Browser
### Required Libraries
```cpp
#include // WiFi functionality
#include // DNS Server for captive portal
#include // Web Server functionality
```
## 📥 Installation Guide
1. **Arduino IDE Setup**
```bash
# Install ESP8266 Board Package
http://arduino.esp8266.com/stable/package_esp8266com_index.json
```
2. **Required Libraries**
- Go to Tools > Manage Libraries
- Install all required libraries listed above
3. **ESP8266 Configuration**
- Board: "NodeMCU 1.0 (ESP-12E Module)"
- Upload Speed: "115200"
- CPU Frequency: "80 MHz"
- Flash Size: "4MB (FS:2MB OTA:~1019KB)"
## 🚀 Quick Start
1. Clone this repository
```bash
git clone https://github.com/caronero/instagram_portal.git
```
2. Open `instagram_portal.ino` in Arduino IDE
3. Configure your settings in the code:
```cpp
const char* ssid = "Free WiFi"; // Change network name
const char* admin_password = "your_pass"; // Change admin password
```
4. Upload to your ESP8266
5. Power on your device
## 📱 Usage Instructions
1. **Initial Setup**
- Power on the ESP8266
- Look for "Free WiFi" network
- Connect to the network
2. **Access Points**
- Main Portal: `http://192.168.4.1`
- Admin Panel: `http://192.168.4.1/admin`
- Default Password: `zaid46`
3. **Admin Dashboard Features**
- View captured data
- Monitor active connections
- System statistics
- Real-time logs
## ⚙️ Configuration Options
```cpp
// Network Configuration
const char* ssid = "Free WiFi"; // WiFi Network Name
const char* admin_password = "zaid46"; // Admin Panel Password
const IPAddress apIP(192, 168, 4, 1); // Portal IP Address
const byte DNS_PORT = 53; // DNS Port
// Storage Configuration
#define MAX_CREDENTIALS 50 // Maximum stored entries
```
## 🔍 Troubleshooting
Common issues and solutions:
| Issue | Solution |
|-------|----------|
| Device not broadcasting | Check power supply |
| Can't access admin panel | Verify IP address |
| Portal not redirecting | Clear browser cache |
| Connection drops | Check ESP8266 power |
## 🛡️ Security Notice
This tool is designed for **EDUCATIONAL PURPOSES ONLY**. Usage of this tool for attacking targets without prior mutual consent is illegal. Developers assume no liability and are not responsible for any misuse or damage caused by this program.
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## 📄 License
This project is licensed for educational purposes only. Not for commercial or malicious use.
## ⚠️ Disclaimer
This project is for educational purposes only. The developers do not endorse or encourage any malicious use of this code.
## 📧 Contact
For educational and development inquiries only:
- Create an issue in this repository
- Submit a pull request
---
Made with ❤️ for educational purposes only