# esther7171/wifi-pentesting architecture

> Architecture diagram of the GitHub repository esther7171/wifi-pentesting, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/esther7171/wifi-pentesting
- Repository: https://github.com/esther7171/wifi-pentesting

## Overview

##### Project type and purpose
- This is a shell-script-driven Wi-Fi pentesting toolkit and driver-installer for Linux (e.g., Kali, Parrot).
- It provides:
- An install script (install.sh) that builds and installs wireless drivers (compat-wireless).
- A “fake-auth” tool for authentication attacks.
- Documentation/checklists under “Check-List” and “Ports” folders.
- Integration with standard aircrack-ng suite commands (airmon-ng, airodump-ng, aireplay-ng, aircrack-ng).

##### File structure
- Top level:
- install.sh – orchestrates driver compilation/installation and environment setup.
- compat-wireless-2010-06-28.tar.bz2 – source bundle for Realtek wireless drivers.
- fake-auth/ – custom authentication-attack scripts.
- Check-List/ & Ports/ – markdown guides and checklists.
- README.md – user-facing documentation.
- No traditional “frontend/backend,” but two phases:
a. Installation phase (driver build & kernel module insertion)
b. Runtime phase (packet capture/injection using aircrack-ng tools + fake-auth)

##### README for insights
- Confirms the focus on:
- Installing drivers for adapters supporting monitor mode & packet injection.
- Executing standard pentest workflows: scanning, deauth attacks, handshake capture, cracking.
- Mentions prerequisites (Linux distro, adapter chipset).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Installation Layer
    subgraph "Installation Layer"
        direction TB
        User("User")
        InstallScript["install.sh"]:::installation
        CompatBundle["compat-wireless-2010-06-28.tar.bz2"]:::installation
        MakeBuild["GNU Make"]:::installation
    end

    %% Kernel / Hardware Layer
    subgraph "Kernel & Hardware Layer"
        direction TB
        KernelModule["Kernel Modules\n(Realtek RTL8821AU)"]:::kernel
        WirelessAdapter["Wireless Adapter\n(USB Dongle)"]:::kernel
    end

    %% Runtime Pentest Tools
    subgraph "Runtime Pentest Tools"
        direction TB
        Airmon["airmon-ng"]:::runtime
        Airodump["airodump-ng"]:::runtime
        Aireplay["aireplay-ng"]:::runtime
        fakeAuth["fake-auth module"]:::runtime
        Aircrack["aircrack-ng"]:::runtime
        CapFile["Handshake .cap Files"]:::persistent
        Wordlist["Wordlists"]:::persistent
        WirelessNetwork["Wireless Network"]:::external
    end

    %% Documentation
    subgraph "Documentation" 
        direction TB
        README["README.md"]:::docs
        CheckList["Check-List/"]:::docs
        Ports["Ports/"]:::docs
        LICENSE["LICENSE"]:::docs
    end

    %% Connections - Installation Workflow
    User -->|"invoke install.sh"| InstallScript
    InstallScript -->|"unpack"| CompatBundle
    CompatBundle -->|"build"| MakeBuild
    MakeBuild -->|"install (insmod)"| KernelModule
    KernelModule -->|"driver ↔ hardware"| WirelessAdapter

    %% Connections - Runtime Workflow
    User -->|"invoke"| Airmon
    Airmon -->|"enable monitor mode"| WirelessAdapter
    WirelessAdapter -->|"capture packets"| Airodump
    Airodump -->|"produces .cap"| CapFile
    User -->|"run deauth attack"| Aireplay
    Aireplay -->|"inject frames"| WirelessNetwork
    User -->|"run auth attack"| fakeAuth
    fakeAuth -->|"inject frames"| WirelessNetwork
    WirelessNetwork -->|"traffic"| WirelessAdapter
    CapFile -->|"input"| Aircrack
    Wordlist -->|"input"| Aircrack
    Aircrack -->|"crack → password"| User

    %% Documentation References
    InstallScript -.->|"see README"| README
    Airodump -.->|"see Check-List Guide"| CheckList
    Aireplay -.->|"see Ports Guide"| Ports
    Aircrack -.->|"see README"| README

    %% Click Events
    click InstallScript "https://github.com/esther7171/wifi-pentesting/blob/main/install.sh"
    click CompatBundle "https://github.com/esther7171/wifi-pentesting/blob/main/compat-wireless-2010-06-28.tar.bz2"
    click fakeAuth "https://github.com/esther7171/wifi-pentesting/tree/main/fake-auth/"
    click CheckList "https://github.com/esther7171/wifi-pentesting/tree/main/Check-List/"
    click Ports "https://github.com/esther7171/wifi-pentesting/tree/main/Ports/"
    click README "https://github.com/esther7171/wifi-pentesting/blob/main/README.md"
    click LICENSE "https://github.com/esther7171/wifi-pentesting/tree/main/LICENSE"

    %% Styles
    classDef installation fill:#cce5ff,stroke:#0366d6,color:#0366d6
    classDef kernel fill:#e6e6e6,stroke:#5a5a5a,color:#333
    classDef runtime fill:#f8d7da,stroke:#d93025,color:#a50e0e
    classDef docs fill:#d4edda,stroke:#155724,color:#155724
    classDef persistent fill:#fff3cd,stroke:#856404,color:#856404
    classDef external fill:#fff3cd,stroke:#856404,color:#856404
```
