# kucukkgl/nsm_code_base architecture

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

- Interactive diagram: https://gitdiagram.com/kucukkgl/nsm_code_base
- Repository: https://github.com/kucukkgl/nsm_code_base

## Overview

This repository is a collection of standalone network-security lab tools, not a single coordinated application. The principal workflow is to launch a traffic or web-request script for a target IP or roster group, then send its protocol-specific activity to that target. Separate utilities transfer files to and from student VMs and drive browser visits through a local proxy. Edges reflect only the sampled scripts and README; other listed tools are not assumed to share a runtime pipeline.

Main entry points: [`ids_sec3_students.json`](https://github.com/kucukkgl/nsm_code_base/blob/main/ids_sec3_students.json) (Student rosters), [`send_file.py`](https://github.com/kucukkgl/nsm_code_base/blob/main/send_file.py) (Send files), [`receive_file.py`](https://github.com/kucukkgl/nsm_code_base/blob/main/receive_file.py) (Receive files), [`osi_layer3_ping.py`](https://github.com/kucukkgl/nsm_code_base/blob/main/osi_layer3_ping.py) (ICMP ping)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_traffic["Traffic labs"]
  node_ping["ICMP ping<br/>[osi_layer3_ping.py]"]
  node_pod["Ping of Death"]
  node_ack["TCP ACK flood"]
  node_tcp80["TCP port 80"]
  node_udp["UDP probe"]
  node_tls["TLS handshake"]
end

subgraph group_web["Web exercises"]
  node_sqli["SQLi request<br/>[osi_layer7_sqli.py]"]
  node_curl80["HTTP curl probe"]
end

subgraph group_files["VM file transfer"]
  node_send["Send files<br/>[send_file.py]"]
  node_receive["Receive files<br/>[receive_file.py]"]
  node_localfiles["Local files"]
end

subgraph group_browser["Browser demos"]
  node_scraper["Proxy browsing<br/>[scraper.py]"]
  node_visit["URL visits<br/>[visit.py]"]
end

node_operator(("Lab operator"))
node_roster["Student rosters"]
node_target(("Target VMs"))
node_studentvms(("Student VMs"))
node_websites(("Websites"))
node_proxy(("Local proxy"))

node_operator -->|"launches"| node_ping
node_operator -->|"launches"| node_pod
node_operator -->|"launches"| node_ack
node_operator -->|"launches"| node_tcp80
node_operator -->|"launches"| node_udp
node_operator -->|"launches"| node_tls
node_operator -->|"launches"| node_sqli
node_operator -->|"launches"| node_curl80
node_ping -->|"loads JSON"| node_roster
node_pod -->|"loads JSON"| node_roster
node_ack -->|"loads JSON"| node_roster
node_tcp80 -->|"loads JSON"| node_roster
node_udp -->|"loads JSON"| node_roster
node_tls -->|"loads JSON"| node_roster
node_sqli -->|"loads JSON"| node_roster
node_curl80 -->|"loads JSON"| node_roster
node_ping -->|"sends ICMP"| node_target
node_pod -->|"sends fragments"| node_target
node_ack -->|"sends ACKs"| node_target
node_tcp80 -->|"sends SYN"| node_target
node_udp -->|"runs Nmap"| node_target
node_tls -->|"starts handshake"| node_target
node_sqli -->|"requests HTTPS"| node_target
node_curl80 -->|"requests HTTP"| node_target
node_operator -->|"launches"| node_send
node_operator -->|"launches"| node_receive
node_send -->|"loads JSON"| node_roster
node_receive -->|"loads JSON"| node_roster
node_send -->|"reads file"| node_localfiles
node_receive -->|"writes downloads"| node_localfiles
node_send -->|"uploads via SFTP"| node_studentvms
node_receive -->|"downloads via SFTP"| node_studentvms
node_operator -->|"runs script"| node_scraper
node_operator -->|"runs script"| node_visit
node_scraper -->|"configures browser"| node_proxy
node_visit -->|"configures browser"| node_proxy
node_scraper -->|"visits URLs"| node_websites
node_visit -->|"visits URLs"| node_websites

click node_ping "https://github.com/kucukkgl/nsm_code_base/blob/main/osi_layer3_ping.py"
click node_pod "https://github.com/kucukkgl/nsm_code_base/blob/main/osi_layer3_ping_of_death.py"
click node_ack "https://github.com/kucukkgl/nsm_code_base/blob/main/osi_layer4_ack_flood.py"
click node_tcp80 "https://github.com/kucukkgl/nsm_code_base/blob/main/osi_layer4_tcp_port80.py"
click node_udp "https://github.com/kucukkgl/nsm_code_base/blob/main/osi_layer4_udp_flood.py"
click node_tls "https://github.com/kucukkgl/nsm_code_base/blob/main/osi_layer5_tls12_trigger.py"
click node_sqli "https://github.com/kucukkgl/nsm_code_base/blob/main/osi_layer7_sqli.py"
click node_curl80 "https://github.com/kucukkgl/nsm_code_base/blob/main/deprectaed_curl_port_80.py"
click node_roster "https://github.com/kucukkgl/nsm_code_base/blob/main/ids_sec3_students.json"
click node_send "https://github.com/kucukkgl/nsm_code_base/blob/main/send_file.py"
click node_receive "https://github.com/kucukkgl/nsm_code_base/blob/main/receive_file.py"
click node_scraper "https://github.com/kucukkgl/nsm_code_base/blob/main/scraper.py"
click node_visit "https://github.com/kucukkgl/nsm_code_base/blob/main/visit.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_ping,node_pod,node_ack,node_tcp80,node_udp,node_tls toneBlue
class node_sqli,node_curl80 toneAmber
class node_send,node_receive,node_localfiles toneMint
class node_scraper,node_visit toneRose
class node_operator,node_target,node_studentvms,node_websites,node_proxy toneIndigo
class node_roster toneTeal
```

## Components

### Traffic labs

- [ICMP ping](https://github.com/kucukkgl/nsm_code_base/blob/main/osi_layer3_ping.py): `osi_layer3_ping.py`
- [Ping of Death](https://github.com/kucukkgl/nsm_code_base/blob/main/osi_layer3_ping_of_death.py): `osi_layer3_ping_of_death.py`
- [TCP ACK flood](https://github.com/kucukkgl/nsm_code_base/blob/main/osi_layer4_ack_flood.py): `osi_layer4_ack_flood.py`
- [TCP port 80](https://github.com/kucukkgl/nsm_code_base/blob/main/osi_layer4_tcp_port80.py): `osi_layer4_tcp_port80.py`
- [UDP probe](https://github.com/kucukkgl/nsm_code_base/blob/main/osi_layer4_udp_flood.py): `osi_layer4_udp_flood.py`
- [TLS handshake](https://github.com/kucukkgl/nsm_code_base/blob/main/osi_layer5_tls12_trigger.py): `osi_layer5_tls12_trigger.py`

### Web exercises

- [SQLi request](https://github.com/kucukkgl/nsm_code_base/blob/main/osi_layer7_sqli.py): `osi_layer7_sqli.py`
- [HTTP curl probe](https://github.com/kucukkgl/nsm_code_base/blob/main/deprectaed_curl_port_80.py): `deprectaed_curl_port_80.py`

### VM file transfer

- [Send files](https://github.com/kucukkgl/nsm_code_base/blob/main/send_file.py): `send_file.py`
- [Receive files](https://github.com/kucukkgl/nsm_code_base/blob/main/receive_file.py): `receive_file.py`
- **Local files**

### Browser demos

- [Proxy browsing](https://github.com/kucukkgl/nsm_code_base/blob/main/scraper.py): `scraper.py`
- [URL visits](https://github.com/kucukkgl/nsm_code_base/blob/main/visit.py): `visit.py`

### Other components

- **Lab operator**
- [Student rosters](https://github.com/kucukkgl/nsm_code_base/blob/main/ids_sec3_students.json): `ids_sec3_students.json`
- **Target VMs**
- **Student VMs**
- **Websites**
- **Local proxy**

## Connections

- Lab operator → ICMP ping: launches (evidence: `osi_layer3_ping.py`)
- Lab operator → Ping of Death: launches (evidence: `osi_layer3_ping_of_death.py`)
- Lab operator → TCP ACK flood: launches (evidence: `osi_layer4_ack_flood.py`)
- Lab operator → TCP port 80: launches (evidence: `osi_layer4_tcp_port80.py`)
- Lab operator → UDP probe: launches (evidence: `osi_layer4_udp_flood.py`)
- Lab operator → TLS handshake: launches (evidence: `osi_layer5_tls12_trigger.py`)
- Lab operator → SQLi request: launches (evidence: `osi_layer7_sqli.py`)
- Lab operator → HTTP curl probe: launches (evidence: `deprectaed_curl_port_80.py`)
- ICMP ping → Student rosters: loads JSON (evidence: `osi_layer3_ping.py`)
- Ping of Death → Student rosters: loads JSON (evidence: `osi_layer3_ping_of_death.py`)
- TCP ACK flood → Student rosters: loads JSON (evidence: `osi_layer4_ack_flood.py`)
- TCP port 80 → Student rosters: loads JSON (evidence: `osi_layer4_tcp_port80.py`)
- UDP probe → Student rosters: loads JSON (evidence: `osi_layer4_udp_flood.py`)
- TLS handshake → Student rosters: loads JSON (evidence: `osi_layer5_tls12_trigger.py`)
- SQLi request → Student rosters: loads JSON (evidence: `osi_layer7_sqli.py`)
- HTTP curl probe → Student rosters: loads JSON (evidence: `deprectaed_curl_port_80.py`)
- ICMP ping → Target VMs: sends ICMP (evidence: `osi_layer3_ping.py`)
- Ping of Death → Target VMs: sends fragments (evidence: `osi_layer3_ping_of_death.py`)
- TCP ACK flood → Target VMs: sends ACKs (evidence: `osi_layer4_ack_flood.py`)
- TCP port 80 → Target VMs: sends SYN (evidence: `osi_layer4_tcp_port80.py`)
- UDP probe → Target VMs: runs Nmap (evidence: `osi_layer4_udp_flood.py`)
- TLS handshake → Target VMs: starts handshake (evidence: `osi_layer5_tls12_trigger.py`)
- SQLi request → Target VMs: requests HTTPS (evidence: `osi_layer7_sqli.py`)
- HTTP curl probe → Target VMs: requests HTTP (evidence: `deprectaed_curl_port_80.py`)
- Lab operator → Send files: launches (evidence: `send_file.py`)
- Lab operator → Receive files: launches (evidence: `receive_file.py`)
- Send files → Student rosters: loads JSON (evidence: `send_file.py`)
- Receive files → Student rosters: loads JSON (evidence: `receive_file.py`)
- Send files → Local files: reads file (evidence: `send_file.py`)
- Receive files → Local files: writes downloads (evidence: `receive_file.py`)
- Send files → Student VMs: uploads via SFTP (evidence: `send_file.py`)
- Receive files → Student VMs: downloads via SFTP (evidence: `receive_file.py`)
- Lab operator → Proxy browsing: runs script (evidence: `scraper.py`)
- Lab operator → URL visits: runs script (evidence: `visit.py`)
- Proxy browsing → Local proxy: configures browser (evidence: `scraper.py`)
- URL visits → Local proxy: configures browser (evidence: `visit.py`)
- Proxy browsing → Websites: visits URLs (evidence: `scraper.py`)
- URL visits → Websites: visits URLs (evidence: `visit.py`)
