GitHub - SasanLabs/VulnerableApp: OWASP VulnerableApp Project: Break it. Scan it. Reproduce it. Benchmark against it. Improve it.

Break it. Scan it. Reproduce it. Benchmark against it. Improve it.

OWASP VulnerableApp is a modular deliberately vulnerable application designed primarily for validating and benchmarking security scanners through reproducible test scenarios, while also supporting learning and experimentation.

🔍 What makes it different

Unlike traditional vulnerable applications, VulnerableApp is designed as a testable security ecosystem, not a static training app.

It enables:

🔬 Scanner benchmarking for tools like Burp Suite, OWASP ZAP, and custom DAST engines
🧩 Modular vulnerability design that allows new scenarios without modifying core services
📊 Security regression testing across releases and environments
🎯 Realistic attack surface simulation for modern web application patterns
🧪 Deterministic vulnerability behavior for repeatable scanning results
🧠 Built for security engineers, researchers, and educators

VulnerableApp helps you:

Validate how security tools behave across known vulnerability patterns
Build controlled environments for security experimentation
Extend vulnerability coverage as new attack techniques emerge
Run consistent, repeatable security testing pipelines

⚙️ Why it matters

Most vulnerable apps are:

Static
Hard to extend
Designed only for manual learning

VulnerableApp is built for:

automation, reproducibility, and evolution

User Interface

Running the project

There are 2 ways to run the project:

The simplest way to run the project is using Docker containers which will run the full-fleged VulnerableApplication with all the components. For running as Docker application, follow following steps:
1. Download and Install Docker Compose
2. Clone this Github repository
3. Open the terminal and Navigate to the Project root directory
4. Run the command docker-compose pull && docker-compose up
5. Navigate to browser and visit http://localhost and this will give the User Interface for VulnerableApp.
Note: The above steps will run the latest unreleased VulnerableApp version. If you want to run the latest released version, please use docker latest tag.
Another way to run the VulnerableApp is as standalone Vulnerable Application is:
1. Navigate to Releases Section in github and download the Jar for the latest released version
2. Open the terminal and navigate to the project root directory
3. Run the command java -jar VulnerableApp-*
4. Navigate to browser and visit http://localhost:9090/VulnerableApp. This will give the Legacy User Interface for the VulnerableApp.

Building the project

There are 2 ways in which this project can be built and used:

As a Docker application which will help in running the full-fledged VulnerableApplication. For running as Docker application, follow following steps:
1. Build the docker image by running ./gradlew jibDockerBuild
2. Download Docker-Compose and run in the same directory docker-compose up
3. Navigate to browser and visit http://localhost and this will give the User Interface for VulnerableApp.
As a SpringBoot application which will run with the Legacy UI or Rest API but gives the benefit of debugging and solving issues. This is the simple way,
1. Import the project into your favorite IDE and run it
2. Navigate to browser and visit: http://localhost:9090/VulnerableApp and this will give the Legacy User Interface for VulnerableApp which you can use to debug and test.

Contributing to Project

There are multiple ways in which you can contribute to the project:

If you are a developer and trying to start on to the project, then the suggestion is to go through the list of issues which contains good first issue which can be a good starter.
If you are a developer or a security professional looking to add new Vulnerability type then you can Generate the Sample Vulnerability by running ./gradlew GenerateSampleVulnerability. It will generate the Sample Vulnerability template which has placeholders and comments. Modified files can be seen in the logs of the command or in the github history. You can navigate to those files, fill in the placeholders and then build the project to see the effect of the changes.
In case you are looking to contribute to the project by publicising it or working on the growth of the project, please feel free to add your thoughts to discussions section or issues and we can discuss over them.

Testing with Modern UI

VulnerableApp-facade provides a modern UI for VulnerableApp. To test your local changes with the Modern UI:

Prerequisite: Ensure you have Docker and Docker-Compose installed.
Run Testing Script:
- On Windows: .\scripts\testWithModernUI.bat
- On Linux/Mac: ./scripts/testWithModernUI.sh

This script will build your local changes into a Docker image (sasanlabs/owasp-vulnerableapp:unreleased) and start the full stack (including facade, jsp, and php services) using docker-compose.local.yml.

Access the UI: Navigate to http://localhost to see the modern UI with your changes.

Technologies used

Java17
Spring Boot
ReactJS
Javascript/TypeScript

Connecting to embedded H2 database

For accessing database from browser, visit: http://localhost:9090/VulnerableApp/h2

Database Connection properties:

JDBC Url: jdbc:h2:mem:testdb
User Name: admin
Password: hacker

Currently handled Vulnerability types

Benchmarking your scanner

VulnerableApp ships a comparator that grades a scanner's findings against the project's built-in ground truth and writes a coverage / missed / unmatched report. Both DAST and SAST scanners are supported via the same endpoint:

Endpoint: POST http://<baseurl>/VulnerableApp/scanner/benchmark
Request body — pick the shape that matches your scanner:
- DAST: { tool, scanType: "DAST", findings: [ { url, type, cwe, wascId } ] } (scanType is optional and defaults to DAST; type/cwe/wascId are individually optional — any one axis matching is enough)
- SAST: { tool, scanType: "SAST", findings: [ { filePath, line, cwe, type } ] }
Response body and benchmarks/<tool>-results.json on disk: coverage report

Running the scanner itself is out of scope — you supply the JSON. See benchmarks/README.md for the full input/output schemas, matching rules, canonical vulnerability-type vocabulary, and curl examples.

Contact

In case you are stuck with any of the steps or understanding anything related to project and its goals, feel free to shoot a mail at karan.sasan@owasp.org or raise an issue and we will try our best to help you.