How commando-x/vuln-bank works
Vulnerable Bank is an intentionally insecure Flask banking application for security training. Users interact with web pages and APIs for authentication, account operations, transfers, loans, cards, bills, and transaction history; administrators have management and analytics views, and merchants can use a separate payment API. The app also offers an AI support agent and stored-XSS cleanup. The sampled sources confirm several module integrations, but many feature implementations live in unsampled portions of app.py, so those are grouped there rather than mapped as speculative internal pipelines.
Main entry points: app.py Banking routes · database.py Bank database · templates Banking web UI · ai_agent_deepseek.py AI support agent
Components 15
Banking application
- Banking web UI
templates - Dashboard interactions
static/dashboard.js - Banking routes
app.py - Authentication
auth.py - Username validation
username_validation.py - Transaction analytics
transaction_graphql.py - Merchant payments
merchant_payments.py - Exposed env files
exposed_env_files.py
External integrations
- AI support agent
ai_agent_deepseek.py - DeepSeek API
Data and runtime
- Bank database
database.py - Stored-XSS cleanup
xss_cleanup.py
Other components
- Bank customer
- Administrator
- Merchant
Connections 18
- Bank customer → Banking web UI: uses
README.md - Administrator → Banking web UI: uses
README.md - Merchant → Merchant payments: calls
README.md - Banking web UI → Dashboard interactions: loads
- Dashboard interactions → Banking routes: calls APIs
static/dashboard.js - Banking web UI → Banking routes: submits requests
- Banking routes → Authentication: uses
app.py - Banking routes → Username validation: validates usernames
app.py - Banking routes → Transaction analytics: routes analytics
app.py - Banking routes → Merchant payments: registers routes
app.py - Banking routes → AI support agent: uses
app.py - Banking routes → Exposed env files: uses
app.py - Banking routes → Bank database: queries
app.py - Merchant payments → Bank database: queries
merchant_payments.py - Transaction analytics → Bank database: queries
transaction_graphql.py - AI support agent → Bank database: queries
ai_agent_deepseek.py - AI support agent → DeepSeek API: sends prompts
ai_agent_deepseek.py - Stored-XSS cleanup → Bank database: cleans stored payloads
xss_cleanup.py