Skip to content

RiturajSingh2004/CounterAct-Mitigation

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

15 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

CounterAct-Mitigation

CounterAct-Mitigation (ver2.0)

Flak is replaced with FastAPI, phishing detection API is included, hosted on Render

CounterAct-Mitigation (ver1.0)

CounterAct Mitigation is a Browser Extension that check the authenticity and detail of current webpage to ensure safety of you and your system.
A robust web application authentication system that helps verify the legitimacy of web applications by analyzing various security parameters. This system combines a Flask backend API with a Chrome extension frontend to provide real-time authenticity checks for web applications.

🌟 Key Features

Security Analysis

  • Domain age verification with comprehensive error handling
  • SSL certificate validation and detailed certificate information
  • IP address detection and validation
  • Suspicious keyword detection
  • Multi-factor risk assessment

Technical Implementation

  • RESTful API architecture using Flask
  • Cross-Origin Resource Sharing (CORS) support
  • Comprehensive error handling and logging
  • Chrome extension with popup interface
  • Dark/Light theme support with persistent settings

Requirements.txt

Flask==2.1.0
flask-cors==3.0.10
python-whois==0.8.0
urllib3==1.26.8
ipaddress==1.0.23

πŸ› οΈ Technologies Used

Backend

  • Python 3.x
  • Flask framework
  • Libraries:
    • flask-cors: For handling cross-origin requests
    • whois: For domain registration information
    • ssl: For certificate validation
    • socket: For network operations
    • logging: For system monitoring
    • urllib: For URL parsing and validation
    • ipaddress: For IP address validation

Frontend (Chrome Extension)

  • HTML5
  • CSS3
  • JavaScript
  • Chrome Extension APIs

πŸ”§ Installation & Setup

Backend Setup

  1. Install Python dependencies:
pip install flask flask-cors python-whois
  1. Start the Flask server:
python app.py

The server will run on http://localhost:5000

Chrome Extension Setup

  1. Open Chrome and navigate to chrome://extensions/
  2. Enable "Developer mode"
  3. Click "Load unpacked"
  4. Select the extension directory containing the manifest and frontend files

πŸ” Features In Detail

Domain Age Verification

  • Checks domain registration date
  • Multiple fallback strategies for date extraction
  • Age-based risk assessment

SSL Certificate Validation

  • Validates SSL certificate authenticity
  • Extracts certificate details including:
    • Subject information
    • Issuer details
    • Expiration date
  • Connection timeout handling

URL Analysis

  • Comprehensive URL parsing and validation
  • IP address detection
  • Suspicious keyword monitoring
  • Risk factor aggregation

User Interface

  • Clean and intuitive popup interface
  • Real-time loading indicators
  • Error messaging system
  • Dark/Light theme toggle with local storage persistence
  • Detailed results display including:
    • Authentication status
    • Risk detail
    • Domain information
    • Age verification results

πŸ” Security Measures

  • Input validation for all URL submissions
  • Error handling for network timeouts
  • SSL verification error catching
  • Protection against malformed URLs
  • Logging system for security monitoring

πŸ“ API Endpoints

POST /check_app

Analyzes a provided URL for authenticity.

Request Body:

{
    "url": "https://example.com"
}

Response Format:

{
    "is_fake": boolean,
    "message": string,
    "details": string,
    "domain_info": {
        "domain": string,
        "age_info": {
            "age_days": number,
            "creation_date": string,
            "registrar": string
        }
    }
}

πŸš€ Performance Considerations

  • Asynchronous API calls
  • Efficient error handling
  • Minimal DOM manipulation
  • Theme preference caching
  • Optimized certificate validation

πŸ“‹ Requirements

Backend

  • Python 3.x
  • Flask
  • Internet connection for WHOIS and SSL verification
  • Proper SSL configuration
  • Network access for domain queries

Frontend

  • Chrome browser
  • JavaScript enabled
  • Local storage access
  • Network connectivity

🀝 Open for Contributing

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

About

CounterAct Mitigation is a Browser Extension that check the authenticity and detail of current webpage to ensure safety of you and your system.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors