Skip to content

vishaljati/Cyber-Shield

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

83 Commits
 
 
 
 
 
 

Repository files navigation

πŸ›‘οΈ CyberShield

AI-powered detection and blocking of hidden web trackers

CyberShield is a privacy-first Chrome extension that detects hidden trackers and surveillance cookies, explains who is tracking you and why, and lets users block or allow trackers in real time.

Unlike traditional blockers, CyberShield focuses on clarity and control β€” not just blocking, but explaining.


🚨 Problem Statement

Modern websites silently track users using:

  • Third-party scripts
  • Tracking pixels
  • Persistent surveillance cookies

Most users:

  • Don’t know who is tracking them
  • Don’t know why they are being tracked
  • Have no clear way to control it

Existing tools block trackers blindly, often breaking websites and confusing users.


πŸ’‘ Our Solution

CyberShield makes invisible tracking visible and understandable.

It:

  • Detects hidden third-party trackers on websites
  • Analyzes tracker behavior using clear signals
  • Uses AI to explain tracker intent in simple language
  • Allows users to Block, Allow once, or Always allow
  • Provides a dashboard to manage blocked trackers and view analytics

Not just blocking. Explaining and empowering.


πŸ” Key Feature

Tracker Explainability

β€œDetects hidden trackers and explains how they silently monitor user behavior.”

This builds trust and helps users make informed decisions.


πŸ”„ How It Works

  1. User opens a website
  2. Browser extension scans scripts, images, and cookies
  3. Tracking behavior is converted into signals
  4. Signals are sent to the backend API
  5. Backend classifies the tracker (rule-based)
  6. AI generates a human-readable explanation
  7. User chooses to block or allow the tracker
  8. Browser enforces blocking at the network level

🧩 Extension Architecture

  • Content Script
    • Detects external scripts and tracking pixels
  • Background Script
    • Observes cookies and network behavior
    • Communicates with backend
    • Applies blocking rules
  • Popup UI
    • Displays tracker details and actions
  • Dashboard Page
    • Manage blocked trackers
    • View basic analytics

🧠 Signals (Behavior Evidence)

Signals are privacy-safe indicators generated by the extension:

  • third-party
  • persistent-cookie
  • cross-site
  • pixel
  • analytics
  • unknown-domain

They describe what a tracker does, not who the user is.


πŸ› οΈ Tech Stack

Browser Extension

  • Chrome Extension (Manifest V3)
  • JavaScript
  • Declarative Net Request API

Backend

  • Node.js
  • Express.js

AI (Explainability Only)

  • Google Gemini API

Storage

  • chrome.storage.local
  • Static tracker lists (JSON)

Security & Privacy

  • No personal data collected
  • No browsing history stored
  • No request payload inspection
  • Privacy-by-design architecture

πŸ—οΈ Backend API (Fixed Contract)

Endpoint /api/v1/analyze/analyze-tracker

πŸ— System Architecture (High Level)

Website ↓ Browser Extension ↓ Backend API ↓ AI Explanation Engine ↓ User Warning & Control


πŸ” Privacy First

  • No passwords collected
  • No personal identifiers stored
  • No browsing history saved
  • Only tracker metadata is analyzed
  • User stays in full control

CyberShield is built with privacy by design.


🌍 Impact

  • Makes invisible tracking visible
  • Educates users instead of confusing them
  • Reduces silent data surveillance
  • Builds trust and transparency online

πŸ‘₯ Team

Team Name: Coders’ Heaven

  • Anushka Sinha
  • Neelabhra De
  • Saheb Sen
  • Vishal Jati

πŸ“„ License

MIT License

About

AI-powered detection of hidden trackers

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors