Skip to content

README.md

Latest commit

 

History

History
78 lines (63 loc) · 2.13 KB

README.md

File metadata and controls

78 lines (63 loc) · 2.13 KB

UE25CS151A

PhishShield – Phishing Email Detection System

PhishShield is a lightweight phishing-email detection tool that connects a Python backend with a Chrome extension to scan Gmail emails in real time. It analyzes email content using heuristic rules and shows a safety banner directly inside Gmail.

Project Structure

PhishShield/
│
├── Backend/
│   └── server.py
│
└── Extension/
    ├── content.js
    ├── manifest.json
    └── styles.css

How It Works

  1. The Chrome extension observes Gmail when an email is opened.
  2. It extracts the email subject and body.
  3. It sends the data to the Python backend at /scan.
  4. The backend analyzes the text and returns SAFE, SUSPICIOUS, or DANGEROUS.
  5. A colored banner is shown at the top of the email.

Run the Backend

Install dependencies:

pip install -r requirements.txt

Start the server:

python server.py

Backend runs on:

http://127.0.0.1:5000

Load the Chrome Extension

  1. Open Chrome and go to chrome://extensions/
  2. Enable Developer Mode
  3. Click Load Unpacked
  4. Select the Extension/ folder

Features

  • Real-time Gmail scanning
  • Heuristic phishing detection
  • Score-based risk evaluation
  • Clean UI banners (safe, suspicious, dangerous)
  • Lightweight and fast

Requirements

  • Python 3.x
  • Flask
  • flask-cors
  • TextBlob

📸 Screenshots

1. Backend Server Running

2. Hosting / Local Website

3. Browser Extension Active on Gmail - Phishing Detection Result Shown on Screen

Authors

Name GitHub ID
Sameer Manvi sameermanvi PES2UG25CS725
Samruddhi samruddhi49 PES2UG25CS477
Pratheek G N LUCIFER27086 PES2UG25EC097
Rohith B rohithbalasubramanya-dev PES2UG25EC104