Skip to content

A simulated Facebook phishing page to demonstrate credential harvesting risks. **Use ethically and responsibly.**

License

Notifications You must be signed in to change notification settings

fatonyahmadfauzi/PhisingFacebook

Repository files navigation

📘 PhishingFacebook - Educational Phishing Demonstration

MIT License

A simulated Facebook phishing page to demonstrate credential harvesting risks. Use ethically and responsibly.


⚠️ Critical Disclaimer

WARNING
This project is STRICTLY FOR EDUCATIONAL PURPOSES ONLY. Unauthorized use for malicious activities is illegal. Always obtain explicit permission before testing any system. The developers assume no liability for misuse.


🚀 Features

  • 🎭 Realistic Facebook login page clone
  • 📧 Automated credential forwarding via PHPMailer + Gmail API
  • 🔐 OAuth 2.0 secure email transmission
  • 🛠️ Easy deployment with XAMPP/WAMP
  • 📦 Lightweight PHP-based solution

🛠️ Prerequisites

  • Web server (XAMPP/WAMP/MAMP)
  • Composer (PHP dependency manager)
  • Gmail API credentials:
    • Client ID
    • Client Secret
    • Refresh Token
  • Basic PHP/CLI knowledge

� Installation Guide

1. Clone Repository

git clone https://github.com/fatonyahmadfauzi/PhishingFacebook.git
cd PhishingFacebook

2. Install Dependencies

composer install

3. Gmail API Setup

4. Configure Script

Edit index.php:

// OAuth Configuration
$clientId = 'YOUR_CLIENT_ID';          // ← Replace
$clientSecret = 'YOUR_CLIENT_SECRET';  // ← Replace
$refreshToken = 'YOUR_REFRESH_TOKEN';  // ← Replace
$email = '[email protected]';       // ← Your email

5. Deploy

🌐 File Structure

PhishingFacebook/
├── index.php               # Main logic
├── login_desktop.php       # Desktop webview
├── login_mobile.php        # Mobile webview
├── login/                  # Redirect pages wrong credentials
│   └── login_attempt.php
├── handleForm.php          # Form handler
├── assets/                 # assets
│   └── favicon.png
│   └── meta.svg
├── vendor/                 # PHPMailer dependencies
└── README.md               # This documentation

⚖️ Ethical Use Cases

  • ✅ Security awareness training
  • ✅ Penetration testing (with written consent)
  • ✅ Phishing detection workshops
  • ✅ Academic research on social engineering

    Prohibited:

  • ❌ Unauthorized credential harvesting
  • ❌ Malicious attacks
  • ❌ Privacy violations

🔍 Troubleshooting

Issue Solution
Emails not sending Verify Gmail API credentials & OAuth config
PHPMailer errors Check Composer installation & dependencies
Page styling broken Ensure CSS file path & image locations
OAuth redirect error Validate authorized redirect URIs in GCP

📜 License

Distributed under MIT License. See LICENSE for full text. Remember: With great power comes great responsibility. 🕷️

Key improvements made:
1. Added visual elements with emojis and badges
2. Created clear warning sections with highlight
3. Formatted code blocks with syntax highlighting
4. Added organized tables for troubleshooting
5. Improved file structure visualization
6. Created clear ethical/prohibited use sections
7. Added responsive Markdown formatting
8. Included license badge
9. Made prerequisites/installation steps more scannable
10. Added proper hyperlinks to external resources

About

A simulated Facebook phishing page to demonstrate credential harvesting risks. **Use ethically and responsibly.**

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published