How navyaxdev/safora works
SAFORA is a Chrome extension backed by a Flask phishing-analysis API. The main workflow scans visited pages or user-submitted links, scores URL features with an ML model, independently generates plain-language rule explanations, and presents risk results and warnings. The extension also documents context-menu scans, tab-isolated persistent results, and a second warning on sensitive input. A separate website explains the product and includes a live scanner demo. Backend and extension calls are visible in excerpts; some browser event wiring and the website demo’s API connection are documented or unsampled, so those links are marked unverified.
Main entry points: src/App.jsx Popup Controller · app.py Prediction API · background.js Scan Coordinator · src/App.jsx Product Site
Components 20
Chrome Extension
- Page Monitoring
frontend/public/content.js - Scan Coordinator
frontend/public/background.js - Popup Controller
frontend/src/App.jsx - Dashboard
frontend/src/components/SaforaDashboard.jsx - Manual URL Scan
frontend/src/components/ShowUrlCard.jsx - Threat Warning
frontend/src/components/SpottedAThreadCard.jsx - Extension About
frontend/src/components/AboutPageCard.jsx - Chrome Storage
URL Analysis
- Prediction API
backend/app.py - Feature Extraction
backend/app.py - ML Risk Scoring
backend/app.py - Rule Explanations
backend/phishing_rules.py - Risk Result
Product Website
- Product Site
website/src/App.jsx - Product Sections
website/src/components/safora/Features.jsx - Risk Levels
website/src/components/safora/RiskLevels.jsx
Website Scanner
- Live Scanner Demo
website/src/components/LiveScannerDemo.jsx - Website API Client
website/src/lib/api.js
Other components
- Browsing User
- Chrome Browser
Connections 24
- Browsing User → Chrome Browser: browses
README.md - Chrome Browser → Page Monitoring: loads pages
README.md - Page Monitoring → Scan Coordinator: requests scans
- Scan Coordinator → Prediction API: submits URL
README.md - Prediction API → Feature Extraction: extracts features
backend/app.py - Prediction API → ML Risk Scoring: scores features
backend/app.py - Prediction API → Rule Explanations: gets reasons
backend/app.py - ML Risk Scoring → Risk Result: supplies score
backend/app.py - Rule Explanations → Risk Result: supplies reasons
- Prediction API → Risk Result: returns JSON
backend/app.py - Scan Coordinator → Chrome Storage: persists scans
README.md - Popup Controller → Chrome Storage: reads scan state
frontend/src/App.jsx - Popup Controller → Chrome Storage: reads theme
frontend/src/App.jsx - Popup Controller → Dashboard: renders
frontend/src/App.jsx - Popup Controller → Manual URL Scan: renders
frontend/src/App.jsx - Popup Controller → Threat Warning: renders
frontend/src/App.jsx - Popup Controller → Extension About: renders
frontend/src/App.jsx - Manual URL Scan → Prediction API: posts URL
frontend/src/components/ShowUrlCard.jsx - Threat Warning → Chrome Browser: closes tab
frontend/src/components/SpottedAThreadCard.jsx - Chrome Browser → Scan Coordinator: routes scan actions
README.md - Product Site → Product Sections: renders sections
website/src/App.jsx - Product Site → Risk Levels: renders
website/src/App.jsx - Product Site → Live Scanner Demo: opens demo
website/src/App.jsx - Live Scanner Demo → Website API Client: uses API client