How uzankhan/shadownet-cyber-lab works
ShadowNet is a local-only Flask security lab. A learner browses the challenge catalog and intentionally vulnerable banking-themed flows, uses hints, submits discovered flags, and checks session-oriented progress. The main runtime is concentrated in app.py; the README documents UI, SQLite, and seeding relationships, while excerpts show selected route behavior and browser-side flag submission. The challenge families are represented as a single exercise subsystem because their implementation is not separately sampled. Docker and other delivery machinery are omitted.
Main entry points: app.py Flask routes · seed_db.py Seed data · app.js Browser glue · shadownet.db SQLite lab state
Components 14
Web experience
- Flask routes
app.py - Jinja pages
templates - Browser glue
static/js/app.js - Shared styling
static/css/style.css
Challenge lab
- Vulnerable exercises
app.py - Challenge interface
templates/challenges.html - Challenge hints
app.py
Learning progress
- Flag submission
app.py - Session progress
app.py - Attempt tracking
app.py
Lab data
- SQLite lab state
shadownet.db - Seed data
scripts/seed_db.py - Challenge flags
vault/secret
Other components
- Learner
Connections 14
- Learner → Flask routes: browses and submits
README.md - Flask routes → Jinja pages: renders
README.md - Flask routes → Browser glue: serves UI assets
README.md - Flask routes → Shared styling: serves UI assets
README.md - Flask routes → Vulnerable exercises: handles challenge routes
README.md - Flask routes → SQLite lab state: reads and writes
README.md - Flask routes → Challenge hints: provides hints
README.md - Browser glue → Flag submission: posts flag
static/js/app.js - Flask routes → Flag submission: accepts submission
README.md - Flask routes → Session progress: tracks progress
app.py - Flask routes → Attempt tracking: records attempts
app.py - Seed data → SQLite lab state: creates tables
scripts/seed_db.py - Seed data → Challenge flags: writes flags
scripts/seed_db.py - Challenge interface → Challenge hints: requests hints
README.md