# frostbits-security/siet architecture

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

- Interactive diagram: https://gitdiagram.com/frostbits-security/siet
- Repository: https://github.com/frostbits-security/siet

## Overview

SIET is a Python 2 command-line tool for probing and exploiting Cisco Smart Install devices. The main workflow selects a target or target list, tests Smart Install or sends a mode-specific request, and—in workflows that need file transfer—uses a TFTP server to exchange configuration, IOS, or command files. The README also documents a separate Nmap script for detection and configuration retrieval. The source excerpts show the CLI’s TCP request construction and the TFTP server’s file-transfer behavior; links for documented workflows rely on the README because the relevant implementation sections were not all sampled.

Main entry points: [`siet.py`](https://github.com/frostbits-security/siet/blob/master/siet.py) (SIET CLI), [`cisco-siet.nse`](https://github.com/frostbits-security/siet/blob/master/cisco-siet.nse) (Nmap Script), [`sTFTP.py`](https://github.com/frostbits-security/siet/blob/master/sTFTP.py) (TFTP Server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["SIET Workflows"]
  node_cli["SIET CLI<br/>[siet.py]"]
  node_probe["Smart Install Probe<br/>[siet.py]"]
  node_config_read["Config Retrieval<br/>[siet.py]"]
  node_config_write["Config Changes<br/>[siet.py]"]
  node_ios["IOS Upgrade<br/>[siet.py]"]
  node_commands["Command Execution<br/>[siet.py]"]
end

subgraph group_nmap["Nmap Detection"]
  node_nmap_script["Nmap Script<br/>[cisco-siet.nse]"]
end

subgraph group_transfer["File Transfer"]
  node_tftp["TFTP Server<br/>[sTFTP.py]"]
end

node_operator(("Operator"))
node_target(("Cisco Switch"))

node_operator -->|"runs"| node_cli
node_cli -->|"selects"| node_probe
node_cli -->|"selects"| node_config_read
node_cli -->|"selects"| node_config_write
node_cli -->|"selects"| node_ios
node_cli -->|"selects"| node_commands
node_probe -->|"probes"| node_target
node_config_read -->|"requests config"| node_target
node_config_write -->|"changes config"| node_target
node_ios -->|"upgrades IOS"| node_target
node_commands -->|"sends commands"| node_target
node_operator -->|"runs via Nmap"| node_nmap_script
node_nmap_script -->|"tests or retrieves"| node_target
node_cli -->|"starts for execution"| node_tftp
node_tftp -->|"transfers files"| node_target

click node_cli "https://github.com/frostbits-security/siet/blob/master/siet.py"
click node_probe "https://github.com/frostbits-security/siet/blob/master/siet.py"
click node_config_read "https://github.com/frostbits-security/siet/blob/master/siet.py"
click node_config_write "https://github.com/frostbits-security/siet/blob/master/siet.py"
click node_ios "https://github.com/frostbits-security/siet/blob/master/siet.py"
click node_commands "https://github.com/frostbits-security/siet/blob/master/siet.py"
click node_nmap_script "https://github.com/frostbits-security/siet/blob/master/cisco-siet.nse"
click node_tftp "https://github.com/frostbits-security/siet/blob/master/sTFTP.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_cli,node_probe,node_config_read,node_config_write,node_ios,node_commands toneBlue
class node_nmap_script toneAmber
class node_tftp toneMint
class node_operator,node_target toneIndigo
```

## Components

### SIET Workflows

- [SIET CLI](https://github.com/frostbits-security/siet/blob/master/siet.py): `siet.py`
- [Smart Install Probe](https://github.com/frostbits-security/siet/blob/master/siet.py): `siet.py`
- [Config Retrieval](https://github.com/frostbits-security/siet/blob/master/siet.py): `siet.py`
- [Config Changes](https://github.com/frostbits-security/siet/blob/master/siet.py): `siet.py`
- [IOS Upgrade](https://github.com/frostbits-security/siet/blob/master/siet.py): `siet.py`
- [Command Execution](https://github.com/frostbits-security/siet/blob/master/siet.py): `siet.py`

### Nmap Detection

- [Nmap Script](https://github.com/frostbits-security/siet/blob/master/cisco-siet.nse): `cisco-siet.nse`

### File Transfer

- [TFTP Server](https://github.com/frostbits-security/siet/blob/master/sTFTP.py): `sTFTP.py`

### Other components

- **Operator**
- **Cisco Switch**

## Connections

- Operator → SIET CLI: runs (evidence: `README.md`)
- SIET CLI → Smart Install Probe: selects (evidence: `siet.py`)
- SIET CLI → Config Retrieval: selects (evidence: `README.md`)
- SIET CLI → Config Changes: selects (evidence: `README.md`)
- SIET CLI → IOS Upgrade: selects (evidence: `README.md`)
- SIET CLI → Command Execution: selects (evidence: `README.md`)
- Smart Install Probe → Cisco Switch: probes (evidence: `siet.py`)
- Config Retrieval → Cisco Switch: requests config (evidence: `README.md`)
- Config Changes → Cisco Switch: changes config (evidence: `README.md`)
- IOS Upgrade → Cisco Switch: upgrades IOS (evidence: `README.md`)
- Command Execution → Cisco Switch: sends commands (evidence: `README.md`)
- Operator → Nmap Script: runs via Nmap (evidence: `README.md`)
- Nmap Script → Cisco Switch: tests or retrieves (evidence: `README.md`)
- SIET CLI → TFTP Server: starts for execution (evidence: `README.md`)
- TFTP Server → Cisco Switch: transfers files (evidence: `README.md`)
