# cameronww7/worm-replicator-extorter-password-file-thief- architecture

> Architecture diagram of the GitHub repository cameronww7/worm-replicator-extorter-password-file-thief-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-03-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cameronww7/worm-replicator-extorter-password-file-thief-
- Repository: https://github.com/cameronww7/worm-replicator-extorter-password-file-thief-

## Overview

##### Project Overview
- This project is an intentionally malicious worm tool (for academic purposes) that contains three main Python scripts:
– Replicator.py: Propagates a worm across virtual machines (VMs) and creates an "InfectedRR.txt" in each home directory.
– Extorter.py: (Not fully working) Intended to spread the worm and encrypt document files while placing an "InfectedEE.txt" file.
– PassThief.py: Launches from a VM with a specified host IP, gathering password documents and sending them to that IP, leaving an "InfectedPT.txt" on each VM.
- The project is not a traditional multi-tier web application but rather a distributed tool targeting multiple endpoints (VMs) via network propagation and local file operations.

##### Main Components
a. Core Worm Modules:
– Replicator Module (Replicator.py)
– Extorter Module (Extorter.py)
– Password Thief Module (PassThief.py)
b. VM Environment:
– Represent each VM (or “node”) in the network environment where the worm propagates.
– Each VM is a host that can receive the worm, perform file I/O (creating InfectedXX.txt files), and run local scripts.
c. File System Interactions:
– Indicators for each VM’s “homes” directory where infected markers (e.g., InfectedRR.txt, InfectedEE.txt, InfectedPT.txt) are created.
– For the Extorter – a file system component where the document file encryption takes place.
d. Network Communication:
e. External Trigger/Launcher:
– For each script, especially the PassThief module, denote external initiation (command-line arguments, starting point from any VM).

##### Relationships and Interactions
– How the worm (Replicator and Extorter) spreads between VMs.
– The initiation flow from the launching VM to the external target in the password theft case (PassThief).
– Connectivity between the module action and the resulting file operations on the local file system of each VM.
- That while all modules share a similar propagation mechanism, the specific behaviors differ (e.g., encryption action in Extorter, network sending in PassThief).

##### Architectural Patterns and Design Principles
- Although the application is delivered as standalone scripts, indicate a loosely coupled design where each component (worm functionality) can be considered a service that executes its task when triggered.
- Modularity – each Python script is responsible for a specific aspect of the worm’s operation.
- Network-oriented design: Show ingress (external connection through command-line arguments for PassThief) and inter-VM communications for replication and file manipulation.
- Potential areas for fault or incomplete functionality (especially the Extorter component) as described in the README.

##### Technologies and Frameworks
- Language: Python (scripts are Python files).
- Operating system file manipulation (local homes directory, document encryption) and basic networking (for remote IP interactions in PassThief).

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Worm Modules"
        Replicator["Replicator"]:::module
        Extorter["Extorter"]:::module
        PassThief["PassThief"]:::module
    end

    subgraph "VM Network"
        VM1["VM1: Home Dir (Infected Files)"]:::vm
        VM2["VM2: Home Dir (Infected Files)"]:::vm
        VM3["VM3: Home Dir (Infected Files)"]:::vm
    end

    External["Remote Server (Target IP)"]:::network

    Replicator -->|"infects(InfectedRR.txt)"| VM1
    Extorter -->|"encrypts(InfectedEE.txt)"| VM1
    PassThief -->|"harvests(InfectedPT.txt)"| VM1
    VM1 -->|"propagatesWorm"| VM2
    VM2 -->|"propagatesWorm"| VM3
    PassThief -->|"sendsPasswords"| External

    click Replicator "https://github.com/cameronww7/worm-replicator-extorter-password-file-thief-/blob/master//Replicator.py"
    click Extorter "https://github.com/cameronww7/worm-replicator-extorter-password-file-thief-/blob/master//Extorter.py"
    click PassThief "https://github.com/cameronww7/worm-replicator-extorter-password-file-thief-/blob/master//PassThief.py"

    classDef module fill:#FFDD57,stroke:#333,stroke-width:2px;
    classDef vm fill:#C3E88D,stroke:#333,stroke-width:2px;
    classDef network fill:#82AAFF,stroke:#333,stroke-width:2px;
```
