Clone or download
Pull request Compare This branch is 2 commits ahead, 18 commits behind develop.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
platformQuickStarts clean up Jun 5, 2018
scripts
webgoat-container New release v8.0.0.M20 Jun 20, 2018
webgoat-images/vagrant-training Update to new version for develop May 30, 2018
webgoat-lessons
webgoat-server
webwolf
.gitignore
.travis.yml
CREATE_RELEASE.MD
README.MD
buildspec.yml initial add of cloudformation for platform seeding purposes May 21, 2017
docker-compose-postgres.yml
docker-compose.yml
mvn-debug
pom.xml

README.MD

WebGoat 8: A deliberately insecure Web Application

Build Status Coverage Status Codacy Badge Dependency Status OWASP Labs GitHub release

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. Standalone

Download the latest WebGoat release from https://github.com/WebGoat/WebGoat/releases

java -jar webgoat-server-<<version>>.jar [--server.port=8080] [--server.address=localhost]

By default WebGoat starts on port 8080 with --server.port you can specify a different port. With server.address you can bind it to a different address (default localhost)

2. 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 -it webgoat/webgoat-8.0 /home/webgoat/start.sh 

If you want to keep the database between Docker sessions you need to map the WebGoat data directory to a folder on the host system as follows:

docker run -p 8080:8080 -it -v /tmp/webgoat-data:/home/webgoat/.webgoat-${VERSION} webgoat/webgoat-8.0 /home/webgoat/start.sh

where ${VERSION} is for example v8.0.0.M14. The data will now be stored in /tmp/webgoat-data on your host system.

Wait for the Docker container to start, and run docker ps to verify it's running.

  • If you are using docker-machine, verify the machine IP using docker-machine env
  • If you are using boot2docker on OSX, verify the IP by running docker network inspect bridge
  • Otherwise, the host will be bound to localhost

Once you have the IP and port, you'll want to navigate to the /WebGoat path in the URL. For example:

http://192.168.99.100:8080/WebGoat

Here you'll be able to register a new user and get started.

Please note: this version may not be completely in sync with the develop branch.

3. 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 git@github.com:WebGoat/WebGoat.git

Now let's start by compiling the project.

cd WebGoat
git checkout <<branch_name>>
mvn clean install

Now we are ready to run the project. WebGoat 8.x is using Spring-Boot.

mvn -pl webgoat-server spring-boot:run

... you should be running webgoat on localhost:8080/WebGoat momentarily

To change IP address add the following variable to WebGoat/webgoat-container/src/main/resources/application.properties file

server.address=x.x.x.x

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-training
   $ 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

NOTE: Travis will create a new Docker image automatically when making a new release.

WebGoat now has Docker support for x86 and ARM (raspberry pi).

Docker on x86

On x86 you can build a container with the following commands:

cd WebGoat/
mvn install
cd webgoat-server
docker build -t webgoat/webgoat-8.0 .
docker tag webgoat/webgoat-8.0 webgoat/webgoat-8.0:8.0
docker login
docker push webgoat/webgoat-8.0

Docker on ARM (Raspberry Pi)

On a Raspberry Pi (it has yet been tested with a Raspberry Pi 3 and the hypriot Docker image) you need to build JFFI for ARM first. This is needed by the docker-maven-plugin (see here):

sudo apt-get install build-essential
git clone https://github.com/jnr/jffi.git
cd jffi
ant jar
cd build/jni
sudo cp libjffi-1.2.so /usr/lib

When you have done this you can build the Docker container using the following commands:

cd WebGoat/
mvn install
cd webgoat-server
mvn docker:build -Drpi=true
docker tag webgoat/webgoat-8.0 webgoat/webgoat-8.0:8.0
docker login
docker push webgoat/webgoat-8.0