# toborrm9/malicious_extension_sentry architecture

> Architecture diagram of the GitHub repository toborrm9/malicious_extension_sentry, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/toborrm9/malicious_extension_sentry
- Repository: https://github.com/toborrm9/malicious_extension_sentry

## Overview

This repository combines a malicious-extension database with a local scanner. The documented scan workflow downloads the CSV, discovers installed browser extensions, compares them with known threat IDs, and reports results. The README also describes an online dashboard and aggregated threat-intelligence sources. Scanner internals are only partially excerpted, so the graph omits unsupported details of its comparison and reporting calls.

Main entry points: [`malext.py`](https://github.com/toborrm9/malicious_extension_sentry/blob/main/malext.py) (MalExt scanner), [`Malicious-Extensions.csv`](https://github.com/toborrm9/malicious_extension_sentry/blob/main/Malicious-Extensions.csv) (Malicious ID list), [`Malicious-Extensions.md`](https://github.com/toborrm9/malicious_extension_sentry/blob/main/Malicious-Extensions.md) (Extension records), [`threat-intel-feeds`](https://github.com/toborrm9/malicious_extension_sentry/tree/main/threat-intel-feeds) (Threat intel feeds)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_scanner["Local scanner"]
  node_scanner_cli["MalExt scanner<br/>[malext.py]"]
  node_browser_profiles[("Browser profiles")]
  node_extension_scan["Extension discovery<br/>[malext.py]"]
  node_database_fetch["Database download<br/>[malext.py]"]
  node_scan_report["Scan results<br/>[malext.py]"]
end

subgraph group_database["Threat database"]
  node_malicious_csv[("Malicious ID list")]
  node_extension_catalog["Extension records"]
  node_detailed_records["Detailed records"]
  node_intel_feeds["Threat intel feeds"]
end

subgraph group_services["Consumer services"]
  node_dashboard["Live dashboard"]
end

node_user(("Scanner user"))
node_source_community(("Research sources"))

node_user -->|"runs scan"| node_scanner_cli
node_scanner_cli -->|"downloads IDs"| node_database_fetch
node_database_fetch -->|"fetches CSV"| node_malicious_csv
node_scanner_cli -->|"scans extensions"| node_extension_scan
node_extension_scan -.->|"reads profiles"| node_browser_profiles
node_scanner_cli -.->|"reports findings"| node_scan_report
node_source_community -->|"contributes reports"| node_extension_catalog
node_source_community -->|"informs aggregation"| node_intel_feeds
node_extension_catalog -->|"powers search"| node_dashboard
node_malicious_csv -.->|"feeds dashboard"| node_dashboard

click node_scanner_cli "https://github.com/toborrm9/malicious_extension_sentry/blob/main/malext.py"
click node_extension_scan "https://github.com/toborrm9/malicious_extension_sentry/blob/main/malext.py"
click node_database_fetch "https://github.com/toborrm9/malicious_extension_sentry/blob/main/malext.py"
click node_malicious_csv "https://github.com/toborrm9/malicious_extension_sentry/blob/main/Malicious-Extensions.csv"
click node_extension_catalog "https://github.com/toborrm9/malicious_extension_sentry/blob/main/Malicious-Extensions.md"
click node_detailed_records "https://github.com/toborrm9/malicious_extension_sentry/blob/main/malicious_extensions_detailed.csv"
click node_intel_feeds "https://github.com/toborrm9/malicious_extension_sentry/tree/main/threat-intel-feeds"
click node_scan_report "https://github.com/toborrm9/malicious_extension_sentry/blob/main/malext.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_scanner_cli,node_browser_profiles,node_extension_scan,node_database_fetch,node_scan_report,node_user toneBlue
class node_malicious_csv,node_extension_catalog,node_detailed_records,node_intel_feeds toneAmber
class node_dashboard toneMint
class node_source_community toneIndigo
```

## Components

### Local scanner

- [MalExt scanner](https://github.com/toborrm9/malicious_extension_sentry/blob/main/malext.py): `malext.py`
- **Browser profiles**
- [Extension discovery](https://github.com/toborrm9/malicious_extension_sentry/blob/main/malext.py): `malext.py`
- [Database download](https://github.com/toborrm9/malicious_extension_sentry/blob/main/malext.py): `malext.py`
- [Scan results](https://github.com/toborrm9/malicious_extension_sentry/blob/main/malext.py): `malext.py`

### Threat database

- [Malicious ID list](https://github.com/toborrm9/malicious_extension_sentry/blob/main/Malicious-Extensions.csv): `Malicious-Extensions.csv`
- [Extension records](https://github.com/toborrm9/malicious_extension_sentry/blob/main/Malicious-Extensions.md): `Malicious-Extensions.md`
- [Detailed records](https://github.com/toborrm9/malicious_extension_sentry/blob/main/malicious_extensions_detailed.csv): `malicious_extensions_detailed.csv`
- [Threat intel feeds](https://github.com/toborrm9/malicious_extension_sentry/tree/main/threat-intel-feeds): `threat-intel-feeds`

### Consumer services

- **Live dashboard**

### Other components

- **Scanner user**
- **Research sources**

## Connections

- Scanner user → MalExt scanner: runs scan (evidence: `README.md`)
- MalExt scanner → Database download: downloads IDs (evidence: `malext.py`)
- Database download → Malicious ID list: fetches CSV (evidence: `malext.py`)
- MalExt scanner → Extension discovery: scans extensions (evidence: `malext.py`)
- Extension discovery → Browser profiles: reads profiles
- MalExt scanner → Scan results: reports findings (evidence: `malext.py`)
- Research sources → Extension records: contributes reports (evidence: `README.md`)
- Research sources → Threat intel feeds: informs aggregation (evidence: `README.md`)
- Extension records → Live dashboard: powers search (evidence: `README.md`)
- Malicious ID list → Live dashboard: feeds dashboard
