WebGoat: A deliberately insecure Web Application
Important
This is the development version of WebGoat 8, if you are looking for a released stable version please go to: https://github.com/WebGoat/WebGoat/wiki/Running-WebGoat
Introduction
WebGoat is a deliberately insecure web application maintained by OWASP designed to teach web application security lessons.
This program is a demonstration of common server-side application flaws. The exercises are intended to be used by people to learn about application security and penetration testing techniques.
WARNING 1: While running this program your machine will be extremely vulnerable to attack. You should disconnect from the Internet while using this program. WebGoat's default configuration binds to localhost to minimize the exposure.
WARNING 2: This program is for educational purposes only. If you attempt these techniques without authorization, you are very likely to get caught. If you are caught engaging in unauthorized hacking, most companies will fire you. Claiming that you were doing security research will not work as that is the first thing that all hackers claim.
Run Instructions:
1. Run using Docker
From time to time we publish a new development preview of WebGoat 8 on Docker HUB, you can download this version https://hub.docker.com/r/webgoat/webgoat-8.0/. First install Docker, then open a command shell/window and type:
docker pull webgoat/webgoat-8.0
docker run -p 8080:8080 webgoat/webgoat-8.0
Wait for the Docker container to start and go to step 3. Please note: this version may not be completely in sync with the develop branch.
2. Run from the sources
Prerequisites:
- Java 8
- Maven > 3.2.1
- Your favorite IDE
- Git, or Git support in your IDE
Open a command shell/window:
git clone [email protected]:WebGoat/WebGoat.git
Now let's start by compiling the project.
cd WebGoat
git checkout develop
mvn clean package
Now we are ready to run the project. WebGoat 8.x is using Spring-Boot.
mvn -pl webgoat-container spring-boot:run
... you should be running webgoat on localhost:8080/WebGoat momentarily
Vagrant
We supply a complete development environment using Vagrant, to run WebGoat with Vagrant you must first have Vagrant and Virtualbox installed.
$ cd WebGoat/webgoat-images/vagrant-users
$ vagrant up
Once the provisioning is complete login to the Virtualbox with username vagrant and password vagrant. The source code will be available in the home directory.
Building a new Docker image
WebGoat now has Docker support you can build a container with the following commands:
cd WebGoat/
mvn package
cd webgoat-container
mvn docker:build
docker tag webgoat/webgoat-8.0 webgoat/webgoat-8.0:8.0
docker login
docker push webgoat/webgoat-container
With the following command you are able to run the Docker container on your local machine:
docker run -p 8080:8080 -t webgoat/webgoat-8.0
docker ps
With the last command you are able to determine ip address to connect to.