# hackerhouse-opensource/backdoors architecture

> Architecture diagram of the GitHub repository hackerhouse-opensource/backdoors, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-03-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hackerhouse-opensource/backdoors
- Repository: https://github.com/hackerhouse-opensource/backdoors

## Overview

##### Project’s Type and Purpose
- The project is a suite of “Backdoors” – a collection of PoC tools that simulate persistence techniques (e.g., kernel mode hooking, command & control implementations) and various methods to maintain access on target systems.
- The tools cover different platforms including Windows, Linux, and OS-X, and they are written in different languages (e.g., GoLang, Python, and even kernel modules packaged as .tgz or .tar.gz).
- The purpose is demonstrative rather than a “live” system – each tool shows off a particular technique (bind shells, hidden files, rootkits, etc.) that might be deployed in real-world situations.

##### File Structure
- The directory listing shows a flat file structure with multiple archives and source files.
- Files are grouped by type such as compressed archives (.tgz, .tar.gz, .zip) containing more complex modules (e.g., Linux kernel modules like filehider.tgz and magicroot.tgz, OS-X rootkit rubilyn-0.0.1.tar.gz, and Windows-specific tools like SYSTEMservice.tgz and Peony.zip).
- Standalone scripts and source files (e.g., bindshell.go, bindshell.py, cmdbot.py, halloween.py, icmp.py) indicate separate implementations of remote access or command execution.

a. Out Different Functional Areas:
– Remote Shells: Include both the Go and Python bind shell examples. These demonstrate how a remote shell connection is implemented.
– Command & Control (C2) Implementations: Represented by tools like cmdbot.py (IRC C2), TrojanSource.zip (web-based C2 implant), and luna.tgz (AX.25 APRS via satellite). Also, icmp.py shows raw socket command execution.
– Kernel and System-Level Backdoors: Package tools like filehider.tgz (kernel module for hiding files), magicroot.tgz (kernel module for “magic” root backdoor), rubilyn-0.0.1.tar.gz (OS-X rootkit), and SYSTEMservice.tgz (Windows service-based persistent backdoor).
– Auxiliary and Supporting Tools: Include utilities such as StringCrypt.tgz (string encryptor for OS-X tools) and yolo-openssl.tgz (an OpenSSL backdoor extension).

b. Relationships and Interactions:
– Highlight any supporting or dependency relationships (e.g., StringCrypt might be used with rubilyn) even though these relationships are conceptual in a PoC tool repository.

##### Architectural Patterns and Design Principles
- Even though this is not a monolithic system, the design intent shows modularity – each tool is focused on a specific aspect of persistence or remote access.
- Separation of concerns by grouping tools based on their functional domain (e.g., network communications, kernel manipulation, service persistence).
- That the system design in this repository follows a “collection of independent modules” pattern where each module demonstrates a different technique.

##### Specific Elements
- A clear label for each module/component (e.g., “Remote Shells: bindshell.go / bindshell.py”).
- Notes or callouts that briefly describe the purpose of each tool if space permits (e.g., “Peony.zip – Windows Defender AV bypass using a Meterpreter harness”).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Command & Control Implementations
    subgraph "Command & Control Implementations"
        C2_1["cmdbot.py"]:::c2
        C2_2["TrojanSource.zip"]:::c2
        C2_3["icmp.py"]:::c2
        C2_4["luna.tgz"]:::c2
    end

    %% Remote Shells
    subgraph "Remote Shells"
        RS1["bindshell.go"]:::remote
        RS2["bindshell.py"]:::remote
    end

    %% Kernel and System-Level Backdoors
    subgraph "Kernel and System-Level Backdoors"
        K1["filehider.tgz"]:::kernel
        K2["magicroot.tgz"]:::kernel
        K3["rubilyn-0.0.1.tar.gz"]:::kernel
        K4["SYSTEMservice.tgz"]:::kernel
    end

    %% Auxiliary and Supporting Tools
    subgraph "Auxiliary and Supporting Tools"
        A1["StringCrypt.tgz"]:::aux
        A2["yolo-openssl.tgz"]:::aux
    end

    %% Additional PoC Tools
    subgraph "Additional PoC Tools"
        P1["Peony.zip"]:::poc
        P2["MalwareTool.tgz"]:::poc
        P3["Zombie.tgz"]:::poc
        P4["halloween.py"]:::poc
    end

    %% Connections
    C2_1 -->|"triggers"| RS1
    C2_3 -->|"executes"| RS1
    RS2 -->|"activates"| K1
    A1 -->|"supports"| K3
    C2_4 -->|"bypasses"| P1

    %% Click Events
    click RS1 "https://github.com/hackerhouse-opensource/backdoors/blob/master//bindshell.go"
    click RS2 "https://github.com/hackerhouse-opensource/backdoors/blob/master//bindshell.py"
    click C2_1 "https://github.com/hackerhouse-opensource/backdoors/blob/master//cmdbot.py"
    click C2_2 "https://github.com/hackerhouse-opensource/backdoors/blob/master//TrojanSource.zip"
    click C2_3 "https://github.com/hackerhouse-opensource/backdoors/blob/master//icmp.py"
    click C2_4 "https://github.com/hackerhouse-opensource/backdoors/blob/master//luna.tgz"
    click K1 "https://github.com/hackerhouse-opensource/backdoors/blob/master//filehider.tgz"
    click K2 "https://github.com/hackerhouse-opensource/backdoors/blob/master//magicroot.tgz"
    click K3 "https://github.com/hackerhouse-opensource/backdoors/blob/master//rubilyn-0.0.1.tar.gz"
    click K4 "https://github.com/hackerhouse-opensource/backdoors/blob/master//SYSTEMservice.tgz"
    click A1 "https://github.com/hackerhouse-opensource/backdoors/blob/master//StringCrypt.tgz"
    click A2 "https://github.com/hackerhouse-opensource/backdoors/blob/master//yolo-openssl.tgz"
    click P1 "https://github.com/hackerhouse-opensource/backdoors/blob/master//Peony.zip"
    click P2 "https://github.com/hackerhouse-opensource/backdoors/blob/master//MalwareTool.tgz"
    click P3 "https://github.com/hackerhouse-opensource/backdoors/blob/master//Zombie.tgz"
    click P4 "https://github.com/hackerhouse-opensource/backdoors/blob/master//halloween.py"

    %% Styles
    classDef remote fill:#AED6F1,stroke:#1F618D,stroke-width:2px;
    classDef c2 fill:#A9DFBF,stroke:#239B56,stroke-width:2px;
    classDef kernel fill:#F9E79F,stroke:#F1C40F,stroke-width:2px;
    classDef aux fill:#FAD7A0,stroke:#D35400,stroke-width:2px;
    classDef poc fill:#E8DAEF,stroke:#8E44AD,stroke-width:2px;
```
