# pillalamaruthiprasad/firewall-maruthi architecture

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

- Interactive diagram: https://gitdiagram.com/pillalamaruthiprasad/firewall-maruthi
- Repository: https://github.com/pillalamaruthiprasad/firewall-maruthi

## Overview

SecureTea is a multi-mode device and server security suite. Users configure integrations and launch CLI modes; server mode starts selected monitoring and protection services, which inspect system, network, files, and logs. The README also advertises malware analysis, IoT checks, OSINT reporting, header checks, and notification channels. An Angular GUI provides configuration and security dashboards, with some views making API requests. Several feature links are documented, but unsampled implementation details and the full GUI-to-backend wiring are not established by the excerpts.

Main entry points: [`securetea/modes/server_mode.py`](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/modes/server_mode.py) (Server mode), [`gui/src/app/dashboard/dashboard.component.ts`](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/gui/src/app/dashboard/dashboard.component.ts) (Web dashboard), [`gui/src/app/storage/storage.component.ts`](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/gui/src/app/storage/storage.component.ts) (Storage view), [`securetea/args/args_helper.py`](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/args/args_helper.py) (CLI options)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Configuration and modes"]
  node_args["CLI options<br/>[args_helper.py]"]
  node_servermode["Server mode<br/>[server_mode.py]"]
  node_core["Core runtime<br/>[core.py]"]
end

subgraph group_protect["Network protection"]
  node_ids["Intrusion detection<br/>[secureTeaIDS.py]"]
  node_firewall["Firewall"]
  node_waf["Web application firewall<br/>[SecureTeaWaf.py]"]
end

subgraph group_monitor["System monitoring"]
  node_syslogs["System log monitor<br/>[engine.py]"]
  node_serverlogs["Server log monitor"]
end

subgraph group_analysis["Analysis and response"]
  node_antivirus["Antivirus"]
  node_webdeface["Web deface protection"]
  node_patcher["Server patcher"]
  node_malware["Malware analysis"]
  node_iot["IoT checker<br/>[iot_checker.py]"]
  node_osint["OSINT reporting<br/>[osint.py]"]
  node_headers["Header checks"]
  node_notifs["Notification channels"]
end

subgraph group_ui["User interface"]
  node_gui["Web dashboard"]
  node_configui["GUI configuration"]
  node_storageui["Storage view"]
end

node_operator(("Operator"))
node_api(("Configured API"))
node_emailrep(("EmailRep service"))

node_operator -->|"selects options"| node_args
node_operator -->|"starts mode"| node_servermode
node_servermode -->|"initializes"| node_ids
node_servermode -->|"initializes"| node_firewall
node_servermode -->|"initializes"| node_waf
node_servermode -->|"starts monitoring"| node_syslogs
node_servermode -->|"starts monitoring"| node_serverlogs
node_servermode -->|"initializes"| node_antivirus
node_servermode -->|"initializes"| node_webdeface
node_servermode -->|"initializes"| node_patcher
node_operator -->|"uses dashboard"| node_gui
node_gui -->|"routes to"| node_configui
node_gui -->|"routes to"| node_storageui
node_storageui -->|"requests storage"| node_api
node_operator -->|"runs analysis"| node_malware
node_operator -->|"checks IoT"| node_iot
node_operator -->|"generates reports"| node_osint
node_operator -->|"checks headers"| node_headers
node_operator -->|"configures alerts"| node_notifs
node_emailrep -.-> node_emailrep

click node_args "https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/args/args_helper.py"
click node_servermode "https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/modes/server_mode.py"
click node_core "https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/core.py"
click node_ids "https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/ids/secureTeaIDS.py"
click node_firewall "https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/firewall/secureTeaFirewall.py"
click node_waf "https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/waf/Server/SecureTeaWaf.py"
click node_syslogs "https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/log_monitor/system_log/engine.py"
click node_serverlogs "https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/log_monitor/server_log/secureTeaServerLog.py"
click node_antivirus "https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/antivirus/secureTeaAntiVirus.py"
click node_webdeface "https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/web_deface/secureTeaWebDeface.py"
click node_patcher "https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/auto_server_patcher/secureTeaServerPatcher.py"
click node_malware "https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/malware_analysis/malware_analysis_runner.py"
click node_iot "https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/iot/iot_checker.py"
click node_osint "https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/osint/osint.py"
click node_headers "https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/security_header/secureTeaHeaders.py"
click node_notifs "https://github.com/pillalamaruthiprasad/firewall-maruthi/tree/main/securetea/lib/notifs"
click node_gui "https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/gui/src/app/dashboard/dashboard.component.ts"
click node_configui "https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/gui/src/app/configuration/configuration.component.ts"
click node_storageui "https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/gui/src/app/storage/storage.component.ts"

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_args,node_servermode,node_core toneBlue
class node_ids,node_firewall,node_waf toneAmber
class node_syslogs,node_serverlogs,node_api toneMint
class node_antivirus,node_webdeface,node_patcher,node_malware,node_iot,node_osint,node_headers,node_notifs toneRose
class node_gui,node_configui,node_storageui,node_operator,node_emailrep toneIndigo
```

## Components

### Configuration and modes

- [CLI options](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/args/args_helper.py): `securetea/args/args_helper.py`
- [Server mode](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/modes/server_mode.py): `securetea/modes/server_mode.py`
- [Core runtime](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/core.py): `securetea/core.py`

### Network protection

- [Intrusion detection](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/ids/secureTeaIDS.py): `securetea/lib/ids/secureTeaIDS.py`
- [Firewall](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/firewall/secureTeaFirewall.py): `securetea/lib/firewall/secureTeaFirewall.py`
- [Web application firewall](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/waf/Server/SecureTeaWaf.py): `securetea/lib/waf/Server/SecureTeaWaf.py`

### System monitoring

- [System log monitor](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/log_monitor/system_log/engine.py): `securetea/lib/log_monitor/system_log/engine.py`
- [Server log monitor](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/log_monitor/server_log/secureTeaServerLog.py): `securetea/lib/log_monitor/server_log/secureTeaServerLog.py`

### Analysis and response

- [Antivirus](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/antivirus/secureTeaAntiVirus.py): `securetea/lib/antivirus/secureTeaAntiVirus.py`
- [Web deface protection](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/web_deface/secureTeaWebDeface.py): `securetea/lib/web_deface/secureTeaWebDeface.py`
- [Server patcher](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/auto_server_patcher/secureTeaServerPatcher.py): `securetea/lib/auto_server_patcher/secureTeaServerPatcher.py`
- [Malware analysis](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/malware_analysis/malware_analysis_runner.py): `securetea/lib/malware_analysis/malware_analysis_runner.py`
- [IoT checker](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/iot/iot_checker.py): `securetea/lib/iot/iot_checker.py`
- [OSINT reporting](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/osint/osint.py): `securetea/lib/osint/osint.py`
- [Header checks](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/securetea/lib/security_header/secureTeaHeaders.py): `securetea/lib/security_header/secureTeaHeaders.py`
- [Notification channels](https://github.com/pillalamaruthiprasad/firewall-maruthi/tree/main/securetea/lib/notifs): `securetea/lib/notifs`

### User interface

- [Web dashboard](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/gui/src/app/dashboard/dashboard.component.ts): `gui/src/app/dashboard/dashboard.component.ts`
- [GUI configuration](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/gui/src/app/configuration/configuration.component.ts): `gui/src/app/configuration/configuration.component.ts`
- [Storage view](https://github.com/pillalamaruthiprasad/firewall-maruthi/blob/main/gui/src/app/storage/storage.component.ts): `gui/src/app/storage/storage.component.ts`

### Other components

- **Operator**
- **Configured API**
- **EmailRep service**

## Connections

- Operator → CLI options: selects options (evidence: `README.md`)
- Operator → Server mode: starts mode (evidence: `README.md`)
- Server mode → Intrusion detection: initializes (evidence: `securetea/modes/server_mode.py`)
- Server mode → Firewall: initializes (evidence: `securetea/modes/server_mode.py`)
- Server mode → Web application firewall: initializes (evidence: `securetea/modes/server_mode.py`)
- Server mode → System log monitor: starts monitoring (evidence: `securetea/modes/server_mode.py`)
- Server mode → Server log monitor: starts monitoring (evidence: `securetea/modes/server_mode.py`)
- Server mode → Antivirus: initializes (evidence: `securetea/modes/server_mode.py`)
- Server mode → Web deface protection: initializes (evidence: `securetea/modes/server_mode.py`)
- Server mode → Server patcher: initializes (evidence: `securetea/modes/server_mode.py`)
- Operator → Web dashboard: uses dashboard (evidence: `README.md`)
- Web dashboard → GUI configuration: routes to (evidence: `gui/src/app/app-routing.module.ts`)
- Web dashboard → Storage view: routes to (evidence: `gui/src/app/app-routing.module.ts`)
- Storage view → Configured API: requests storage (evidence: `gui/src/app/storage/storage.component.ts`)
- Operator → Malware analysis: runs analysis (evidence: `README.md`)
- Operator → IoT checker: checks IoT (evidence: `README.md`)
- Operator → OSINT reporting: generates reports (evidence: `README.md`)
- Operator → Header checks: checks headers (evidence: `README.md`)
- Operator → Notification channels: configures alerts (evidence: `README.md`)
- EmailRep service → EmailRep service
