gh0st911/Bert_URL_Detection_Browser_extesnion

SafeNet - URL Analysis & Security Extension

A comprehensive browser security solution combining AI-powered URL analysis, phishing detection, and cookie management features.

🌟 Features

• 🔍 Real-time URL analysis and threat detection
• 🛡️ AI-powered phishing detection
• 🍪 Advanced cookie management
• 🔄 Integration with VirusTotal API
• 🎨 Modern, responsive UI with Tailwind CSS
• 🔐 Secure authentication system

🏗️ Project Structure

.
├── Flask-API/                  # Backend services
│   ├── app.py                 # Main Flask application
│   ├── models/                # AI models and configurations
│   │   ├── model.py          # URL analysis model
│   │   └── config.json       # Model configuration
│   └── instance/             # Database storage
│       └── users.db          # User authentication database
│
└── SafeNet/                   # Browser Extension (Frontend)
    └── safe-net/             # Chrome extension source
        ├── src/              # Extension source code
        │   ├── popup.tsx     # Main extension popup
        │   ├── content.tsx   # Content scripts
        │   └── components/   # React components
        └── assets/           # Static assets

🚀 Getting Started

Backend Setup (Flask API)

1. Environment Setup

python -m venv .venv
.venv\Scripts\Activate
pip install -r requirements.txt

2. Configure Environment Create .env file in Flask-API directory:

JWT_SECRET_KEY=your_secret_key
DATABASE_URL=sqlite:///users.db
FLASK_DEBUG=False

3. Run the API

cd Flask-API
python app.py

Frontend Setup (Browser Extension)

1. Install Dependencies

cd SafeNet/safe-net
pnpm install

2. Development Mode

pnpm dev

3. Build for Production

pnpm build

🔧 Configuration

Backend Configuration

• Database: SQLite database (users.db) for user management
• AI Model: Pre-trained model in models/ directory
• API Endpoints:
  • /analyze - URL analysis
  • /login - User authentication
  • /register - User registration
  • /scan - Batch URL scanning

Extension Configuration

• manifest.json: Chrome extension permissions and settings
• tailwind.config.js: UI styling configuration
• API Connection: Set backend API URL in components

🛠️ Development

Backend Development

• Written in Python with Flask framework
• Uses SQLAlchemy for database operations
• JWT authentication for API security
• CORS enabled for extension communication

Extension Development

• Built with Plasmo framework
• React + TypeScript for components
• Tailwind CSS for styling
• Modular component architecture

📚 API Documentation

Authentication Endpoints

• POST /register

  {
    "email": "user@example.com",
    "password": "secure_password"
  }
  

• POST /login

  {
    "email": "user@example.com",
    "password": "secure_password"
  }
  

Analysis Endpoints

• POST /analyze

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

• GET /status

  • Check API and model status

🔒 Security Features

1. JWT Authentication
2. Password Hashing (bcrypt)
3. CORS Protection
4. SQL Injection Prevention
5. Input Sanitization
6. Rate Limiting
7. Secure Cookie Handling

⚡ Performance Considerations

1. AI Model Optimization
2. Response Caching
3. Efficient Database Queries
4. Lazy Loading Components
5. Asset Optimization

🧪 Testing

Backend Testing

cd Flask-API
python testapi.py

Extension Testing

cd SafeNet/safe-net
pnpm test

📦 Deployment

Backend Deployment

1. Set secure environment variables
2. Configure production database
3. Set up WSGI server (e.g., Gunicorn)
4. Enable proper logging
5. Configure SSL/TLS

Extension Deployment

1. Build production version
2. Package extension
3. Submit to Chrome Web Store
4. Configure production API endpoints

🤝 Contributing

1. Fork the repository
2. Create feature branch (git checkout -b feature/AmazingFeature)
3. Commit changes (git commit -m 'Add AmazingFeature')
4. Push to branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

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

🙏 Acknowledgments

• Flask team for the amazing framework
• Plasmo team for extension development framework
• TailwindCSS for the styling utilities
• All contributors who have helped with the project

---

For more information, bug reports or feature requests, please visit the project repository.