# m1cckey/websecurityacademy architecture

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

- Interactive diagram: https://gitdiagram.com/m1cckey/websecurityacademy
- Repository: https://github.com/m1cckey/websecurityacademy

## Overview

WebSecurityAcademy is a collection of standalone Python scripts for practicing web-security labs, rather than a single integrated application. The principal workflow is an operator running a lab script, which sends crafted HTTP requests to a Web Security Academy target and uses response content, status, or timing to identify credentials or other lab results. The scripts cover authentication enumeration, password guessing, 2FA, persistent-login cookies, and several SQL injection techniques. The shared AcademyClient is a separate helper; no sampled lab script is shown using it. The README documents SQLi lab aims, but other unsampled behavior is not inferred.

Main entry points: [`auth/enum/lab_2.py`](https://github.com/m1cckey/websecurityacademy/blob/main/auth/enum/lab_2.py) (Username Enum), [`auth/enum/lab_3.py`](https://github.com/m1cckey/websecurityacademy/blob/main/auth/enum/lab_3.py) (Login Brute Force), [`auth/enum/lab_4.py`](https://github.com/m1cckey/websecurityacademy/blob/main/auth/enum/lab_4.py) (Password Guessing), [`auth/enum/lab_5.py`](https://github.com/m1cckey/websecurityacademy/blob/main/auth/enum/lab_5.py) (Credential Enum)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_auth["Authentication Labs"]
  node_enum1["Enumeration Lab 1<br/>[lab_1.py]"]
  node_enum2["Username Enum<br/>[lab_2.py]"]
  node_enum3["Login Brute Force<br/>[lab_3.py]"]
  node_enum4["Password Guessing<br/>[lab_4.py]"]
  node_enum5["Credential Enum<br/>[lab_5.py]"]
  node_twofa["2FA Guessing<br/>[lab_6.py]"]
  node_stay["Persistent Login<br/>[lab_7.py]"]
end

subgraph group_sqli["SQL Injection Labs"]
  node_boolean["Boolean Blind SQLi<br/>[lab_11.py]"]
  node_error12["Error Blind SQLi<br/>[lab_12.py]"]
  node_error13["Error Extraction<br/>[lab_13.py]"]
  node_timing["Time-Based SQLi<br/>[lab_14.py]"]
end

subgraph group_client["HTTP Client"]
  node_client["AcademyClient<br/>[client.py]"]
end

node_operator(("Operator"))
node_academy["Lab Target"]

node_operator -->|"runs"| node_enum2
node_enum2 -->|"posts login"| node_academy
node_operator -->|"runs"| node_enum3
node_enum3 -->|"posts login"| node_academy
node_operator -->|"runs"| node_enum4
node_enum4 -->|"posts login"| node_academy
node_operator -->|"runs"| node_enum5
node_enum5 -->|"posts login"| node_academy
node_operator -->|"runs"| node_twofa
node_twofa -->|"posts codes"| node_academy
node_operator -->|"runs"| node_stay
node_stay -->|"gets account"| node_academy
node_operator -->|"runs"| node_boolean
node_boolean -->|"sends probes"| node_academy
node_operator -->|"runs"| node_error12
node_error12 -->|"sends probes"| node_academy
node_operator -->|"runs"| node_error13
node_error13 -->|"sends probe"| node_academy
node_operator -->|"runs"| node_timing
node_timing -->|"sends timed probes"| node_academy
node_client -->|"sends requests"| node_academy

click node_enum1 "https://github.com/m1cckey/websecurityacademy/blob/main/auth/enum/lab_1.py"
click node_enum2 "https://github.com/m1cckey/websecurityacademy/blob/main/auth/enum/lab_2.py"
click node_enum3 "https://github.com/m1cckey/websecurityacademy/blob/main/auth/enum/lab_3.py"
click node_enum4 "https://github.com/m1cckey/websecurityacademy/blob/main/auth/enum/lab_4.py"
click node_enum5 "https://github.com/m1cckey/websecurityacademy/blob/main/auth/enum/lab_5.py"
click node_twofa "https://github.com/m1cckey/websecurityacademy/blob/main/auth/2FA/lab_6.py"
click node_stay "https://github.com/m1cckey/websecurityacademy/blob/main/auth/stay-log-in/lab_7.py"
click node_boolean "https://github.com/m1cckey/websecurityacademy/blob/main/sqli/blind-boolean/lab_11.py"
click node_error12 "https://github.com/m1cckey/websecurityacademy/blob/main/sqli/blind-erorr/lab_12.py"
click node_error13 "https://github.com/m1cckey/websecurityacademy/blob/main/sqli/blind-erorr/lab_13.py"
click node_timing "https://github.com/m1cckey/websecurityacademy/blob/main/sqli/time-based/lab_14.py"
click node_client "https://github.com/m1cckey/websecurityacademy/blob/main/utils/client.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_enum1,node_enum2,node_enum3,node_enum4,node_enum5,node_twofa,node_stay toneBlue
class node_boolean,node_error12,node_error13,node_timing toneAmber
class node_client toneMint
class node_operator,node_academy toneIndigo
```

## Components

### Authentication Labs

- [Enumeration Lab 1](https://github.com/m1cckey/websecurityacademy/blob/main/auth/enum/lab_1.py): `auth/enum/lab_1.py`
- [Username Enum](https://github.com/m1cckey/websecurityacademy/blob/main/auth/enum/lab_2.py): `auth/enum/lab_2.py`
- [Login Brute Force](https://github.com/m1cckey/websecurityacademy/blob/main/auth/enum/lab_3.py): `auth/enum/lab_3.py`
- [Password Guessing](https://github.com/m1cckey/websecurityacademy/blob/main/auth/enum/lab_4.py): `auth/enum/lab_4.py`
- [Credential Enum](https://github.com/m1cckey/websecurityacademy/blob/main/auth/enum/lab_5.py): `auth/enum/lab_5.py`
- [2FA Guessing](https://github.com/m1cckey/websecurityacademy/blob/main/auth/2FA/lab_6.py): `auth/2FA/lab_6.py`
- [Persistent Login](https://github.com/m1cckey/websecurityacademy/blob/main/auth/stay-log-in/lab_7.py): `auth/stay-log-in/lab_7.py`

### SQL Injection Labs

- [Boolean Blind SQLi](https://github.com/m1cckey/websecurityacademy/blob/main/sqli/blind-boolean/lab_11.py): `sqli/blind-boolean/lab_11.py`
- [Error Blind SQLi](https://github.com/m1cckey/websecurityacademy/blob/main/sqli/blind-erorr/lab_12.py): `sqli/blind-erorr/lab_12.py`
- [Error Extraction](https://github.com/m1cckey/websecurityacademy/blob/main/sqli/blind-erorr/lab_13.py): `sqli/blind-erorr/lab_13.py`
- [Time-Based SQLi](https://github.com/m1cckey/websecurityacademy/blob/main/sqli/time-based/lab_14.py): `sqli/time-based/lab_14.py`

### HTTP Client

- [AcademyClient](https://github.com/m1cckey/websecurityacademy/blob/main/utils/client.py): `utils/client.py`

### Other components

- **Operator**
- **Lab Target**

## Connections

- Operator → Username Enum: runs (evidence: `auth/enum/lab_2.py`)
- Username Enum → Lab Target: posts login (evidence: `auth/enum/lab_2.py`)
- Operator → Login Brute Force: runs (evidence: `auth/enum/lab_3.py`)
- Login Brute Force → Lab Target: posts login (evidence: `auth/enum/lab_3.py`)
- Operator → Password Guessing: runs (evidence: `auth/enum/lab_4.py`)
- Password Guessing → Lab Target: posts login (evidence: `auth/enum/lab_4.py`)
- Operator → Credential Enum: runs (evidence: `auth/enum/lab_5.py`)
- Credential Enum → Lab Target: posts login (evidence: `auth/enum/lab_5.py`)
- Operator → 2FA Guessing: runs (evidence: `auth/2FA/lab_6.py`)
- 2FA Guessing → Lab Target: posts codes (evidence: `auth/2FA/lab_6.py`)
- Operator → Persistent Login: runs (evidence: `auth/stay-log-in/lab_7.py`)
- Persistent Login → Lab Target: gets account (evidence: `auth/stay-log-in/lab_7.py`)
- Operator → Boolean Blind SQLi: runs (evidence: `sqli/blind-boolean/lab_11.py`)
- Boolean Blind SQLi → Lab Target: sends probes (evidence: `sqli/blind-boolean/lab_11.py`)
- Operator → Error Blind SQLi: runs (evidence: `sqli/blind-erorr/lab_12.py`)
- Error Blind SQLi → Lab Target: sends probes (evidence: `sqli/blind-erorr/lab_12.py`)
- Operator → Error Extraction: runs (evidence: `sqli/blind-erorr/lab_13.py`)
- Error Extraction → Lab Target: sends probe (evidence: `sqli/blind-erorr/lab_13.py`)
- Operator → Time-Based SQLi: runs (evidence: `sqli/time-based/lab_14.py`)
- Time-Based SQLi → Lab Target: sends timed probes (evidence: `sqli/time-based/lab_14.py`)
- AcademyClient → Lab Target: sends requests (evidence: `utils/client.py`)
