How itsbk13/cybershield_ext works
CyberShield v2.0 is a browser-extension threat checker. The main flow is user input in the popup, backend analysis and ML classification, optional CVE/KEV enrichment for detected threats, and a returned assessment rendered in the popup; the README also documents conversational Gemini responses and translation. The backend records scans and provides a Gemini-key endpoint. CVE lookup includes direct exploit mappings or NVD search, followed by CISA KEV cross-reference and caching. Relationships for the enrichment engine are supported by the sampled utils excerpt; extension, translation, and Gemini behavior is documented in the README, not verified from popup.js excerpts.
Main entry points: views.py Analysis endpoints · utils.py CVE/KEV enrichment · popup.js Popup chat UI · urls.py API routes
Components 14
Browser extension
- Popup chat UI
v2.0_ext/extension/popup.js - Language translation
v2.0_ext/extension/popup.js - Gemini chat
v2.0_ext/extension/popup.js
Backend API
- API routes
v2.0_ext/backend/cb/urls.py - Analysis endpoints
v2.0_ext/backend/cb/views.py
Threat analysis
- ML classification
v2.0_ext/backend/cb/utils.py - Scanned messages
v2.0_ext/backend/cb/models.py - Scan serializer
v2.0_ext/backend/cb/serializers.py
Vulnerability intelligence
- CVE/KEV enrichment
v2.0_ext/backend/cb/utils.py - Vendor and exploit map
v2.0_ext/backend/cb/utils.py - 24-hour CVE cache
v2.0_ext/backend/cb/utils.py - NVD API
- CISA KEV feed
Other components
- User
Connections 17
- User → Popup chat UI: submits input
README.md - Popup chat UI → Language translation: translates input
README.md - Language translation → API routes: POSTs analysis
README.md - API routes → Analysis endpoints: routes request
v2.0_ext/backend/cb/urls.py - Analysis endpoints → ML classification: classifies text
v2.0_ext/backend/cb/views.py - Analysis endpoints → Scanned messages: records scan
v2.0_ext/backend/cb/views.py - Analysis endpoints → Scan serializer: instantiates serializer
v2.0_ext/backend/cb/views.py - Analysis endpoints → CVE/KEV enrichment: enriches threats
v2.0_ext/backend/cb/views.py - CVE/KEV enrichment → Vendor and exploit map: matches keywords
v2.0_ext/backend/cb/utils.py - CVE/KEV enrichment → 24-hour CVE cache: checks cache
v2.0_ext/backend/cb/utils.py - CVE/KEV enrichment → NVD API: searches CVEs
v2.0_ext/backend/cb/utils.py - CVE/KEV enrichment → CISA KEV feed: cross-checks CVEs
v2.0_ext/backend/cb/utils.py - Analysis endpoints → API routes: serves Gemini key
README.md - API routes → Popup chat UI: returns assessment
README.md - Popup chat UI → Gemini chat: requests chat response
README.md - Gemini chat → Language translation: translates response
README.md - Popup chat UI → User: renders results
README.md