Skip to content
/ Wegis Public

<개인 프로젝트> a browser extension catching all URLs, hyper-link, social card, QR codes and determines whether its links to phishing sites

Notifications You must be signed in to change notification settings

bnbong/Wegis

Repository files navigation

Wegis

Wegis Browser Extension

Guarding Every Link, Every Time

Release License: MIT JavaScript HTML5 CSS3 Manifest V3


Project Overview

Key Features

  • Automatic collection and analysis of all links on web pages
  • Real-time phishing site verification through Wegis Server API
  • Blocking dangerous link access with warning notifications
  • Special protection for file download links (PDF, etc.)
  • Real-time link monitoring and pre-loading prevention

Technology Stack

  • Manifest Version: 3
  • Languages: JavaScript (ES2022), HTML5, CSS3
  • API: Wegis Server API
  • Permissions: activeTab, declarativeNetRequest, storage, host permissions
  • External Libraries: jsQR (QR code decoding)

API Specification

Wegis Server API

Base URL:

https://api.bnbong.xyz/api/v1/wegis-server/

Endpoints:

  • POST /analyze/check — Single URL phishing analysis
  • POST /analyze/batch — Multiple URL batch analysis (for browser extensions)
  • GET /analyze/recent — Recent analysis results
  • GET /health — Server status check
  • POST /feedback/* — User feedback management

Project Structure

Wegis/
├── manifest.json
├── background/
│   └── service-worker.js
├── content/
│   ├── content-script.js
│   └── link-collector.js
├── popup/
│   ├── popup.html
│   ├── popup.js
│   └── popup.css
├── options/
│   ├── options.html
│   ├── options.js
│   └── options.css
├── lib/
│   └── jsqr.min.js
├── icons/
│   ├── icon16.png
│   ├── icon48.png
│   └── icon128.png
└── README.md

Security Considerations

  • CSP (Content Security Policy) compliance
  • Principle of least privilege application
  • User data protection
  • API key security management
  • HTTPS communication enforcement

Development Setup

Prerequisites

  • Node.js (v18.0.0 or higher)
  • npm or yarn
  • Git

Setting up the development environment

  1. Clone the repository

    git clone https://github.com/bnbong/Wegis.git
    cd Wegis
  2. Install dependencies

    npm install
  3. Install pre-commit hooks

    # Install pre-commit (if not already installed)
    pip install pre-commit
    
    # Install the hooks
    pre-commit install

Code Quality Tools

Linting and Formatting

  • ESLint: JavaScript linting
  • Stylelint: CSS linting
  • Prettier: Code formatting
  • Pre-commit hooks: Automated checks before commits

Installation Guide

Please refer to INSTALL.md for detailed installation instructions.

About

<개인 프로젝트> a browser extension catching all URLs, hyper-link, social card, QR codes and determines whether its links to phishing sites

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published