DVBank Lab: Hands-on Web Security with Python & React

A Practical Guide to Secure Code Review and Web Application Security

Welcome to DVBank Lab, an intentionally vulnerable banking application designed for learning secure code review and web application security. This project serves as both a hands-on learning environment and a comprehensive course in identifying, understanding, and fixing security vulnerabilities.

Inspired by DVWA (Damn Vulnerable Web Application), this project aims to provide a modern, full-stack vulnerable application specifically focused on banking security scenarios.

🎯 Demo

Dashboard

Transaction System

Profile Features

🎯 Educational Objectives

This project helps you master:

• Secure code review techniques
• Vulnerability identification and exploitation
• Security fix implementation
• Security assessment methodologies
• Secure coding practices

🛠️ Technology Stack

Backend

• Python 3.9+
• Flask Framework
• SQLAlchemy ORM
• JWT Authentication
• SQLite Database

Frontend

• React 18
• TailwindCSS
• Lucide Icons
• Modern UI/UX

Development & Deployment

• Docker & Docker Compose
• Git Version Control
• Development Tools Integration

📚 Module Index

Detailed course materials can be found in the following files:

Module	Description	Link
0. Methodology	Secure Code Review Methodology	📘 Module 0
1. Application Reconnaissance	Application Reconnaissance & Attack Surface Mapping	📘 Module 1
2. Software Composition Analysis	Dependency Security Analysis	📘 Module 2
3. Authentication & Authorization	Authentication & Authorization Vulnerabilities	📘 Module 3
4. SQL Injection	SQL Injection Vulnerabilities	📘 Module 4
5. Input Validation	Input Validation Vulnerabilities	📘 Module 5
6. API Security	API Security Best Practices	📘 Module 6
7. Secure Coding	Secure Coding Practices	📘 Module 7
8. Static Analysis	Automated Static Analysis with Semgrep	📘 Module 8

Each module contains:

• Theoretical background
• Vulnerable code examples
• Exploitation techniques
• Prevention methods
• Hands-on exercises
• Additional resources

🚀 Quick Start

Prerequisites

• Python 3.9 or higher
• Node.js 16 or higher
• Docker and Docker Compose (optional)
• Git

Docker Setup (Recommended)

# Clone repository
git clone https://github.com/mamgad/DVBLab.git
cd DVBLab

# Launch application
docker-compose up --build

Manual Setup

Backend (Python/Flask)

# Clone repository
git clone https://github.com/mamgad/DVBLab.git
cd DVBLab

# Backend setup
cd backend
python -m venv venv

# Activate virtual environment
source venv/bin/activate  # Linux/macOS
.\venv\Scripts\activate   # Windows

# Install dependencies
pip install -r requirements.txt

# Start server
python app.py

Frontend (React)

# In a new terminal
cd frontend
npm install
npm start

Access the Application

• Frontend: http://localhost:3000
• Backend API: http://localhost:5000

Test Credentials

• Username: alice, Password: password123
• Username: bob, Password: password123

🏗️ Project Structure

vulnerable-bank/
├── backend/                  # Flask backend
│   ├── routes/              # API endpoints
│   │   ├── auth_routes.py   # Authentication
│   │   └── transaction_routes.py  # Transactions
│   ├── app.py              # Main application
│   ├── models.py           # Database models
│   └── requirements.txt    # Python dependencies
├── frontend/               # React frontend
│   ├── src/
│   │   ├── components/    # React components
│   │   └── App.js        # Main app component
│   └── package.json      # Node dependencies
├── course/               # Educational content
│   ├── modules/         # Course modules
│   └── exercises/       # Practice materials
└── docker-compose.yml   # Docker configuration

🔒 Security Features

Authentication System

• JWT-based authentication
• Password hashing
• Session management

Transaction System

• Money transfers
• Balance tracking
• Transaction history

User Management

• User registration
• Profile management
• Role-based access

🎯 Learning Objectives

Vulnerability Categories

1. Authentication Bypass
2. Authorization Flaws
3. Input Validation
4. Business Logic Flaws
5. API Security Issues

Security Skills

1. Code Review Techniques
2. Vulnerability Assessment
3. Security Testing
4. Fix Implementation

⚠️ Security Notice

This application contains INTENTIONAL security vulnerabilities for educational purposes:

1. SQL Injection vulnerabilities
2. Insecure JWT implementation
3. Missing input validation
4. IDOR vulnerabilities
5. Race conditions
6. Weak password policies

DO NOT:

• Deploy to production
• Use real credentials
• Use production data
• Host publicly

🤝 Contributing

We welcome contributions! Please:

1. Fork the repository
2. Create a feature branch
3. Submit a pull request
4. Follow security guidelines

📚 Additional Resources

Documentation

• Course Modules
• Installation Guide
• Known Vulnerabilities - Detailed list of intentional security issues

External Resources

• OWASP Top 10
• Flask Security

🙏 Acknowledgments

• OWASP Foundation
• DVWA - The original inspiration for this project
• Security research community
• Open source contributors

⚠️ Disclaimer

This application contains intentional security vulnerabilities for educational purposes. The creators are not responsible for any misuse or damage caused by this application. Use at your own risk and only in a controlled, isolated environment.

---

Legal Notice

© 2024 All Rights Reserved.

This educational material is provided for learning purposes only. The code examples and vulnerabilities demonstrated are for educational use in a controlled environment. The authors and contributors are not responsible for any misuse of the information provided.

Note: All code examples contain intentional vulnerabilities for educational purposes. Do not use in production environments.