Git Product home page Git Product logo

webgoat's Introduction

WebGoat: A deliberately insecure Web Application

Build Status

Important Information

This is a work in progress of the WebGoat Lesson Server, which is currently UNDER MAJOR DEVELOMENT

Current stable version and instructions can be found at: WebGoat-Legacy

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

Easy Run Instructions ( For non-developers )

Note - Use WebGoat-Legacy for a stable build

Follow these instructions if you simply wish to run WebGoat

Prerequisites:

  • Java VM >= 1.6 installed ( JDK 1.7 recommended)
  1. Download the executable jar file which contains all the lessons:

https://s3.amazonaws.com/webgoat-war/webgoat-container-7.0-SNAPSHOT-war-exec.jar

  1. Run it using java:
java -jar webgoat-container-7.0-SNAPSHOT-war-exec.jar
  1. Then navigate in your browser to: (http://localhost:8080/WebGoat)

4.(Optional) If you would like to change the port or other options, use:

java -jar webgoat-container-7.0-SNAPSHOT-war-exec.jar --help

For Developers

Follow these instructions if you wish to run Webgoat and modify the source code as well.

Prerequisites:

  • Java >= 1.6 ( JDK 1.7 recommended )
  • Maven > 2.0.9
  • Your favorite IDE, with Maven awareness: Netbeans/IntelliJ/Eclipse with m2e installed.
  • Git, or Git support in your IDE

The Easy Way: Developer Edition run using Linux or Mac

The webgoat_developer_bootstrap.sh script will clone the necessary repositories, call the maven goals in order launch Tomcat listening on localhost:8080

mkdir WebGoat-Workspace
cd WebGoat-Workspace
curl -o webgoat_developer_bootstrap.sh https://raw.githubusercontent.com/WebGoat/WebGoat/master/webgoat_developer_bootstrap.sh
sh webgoat_developer_bootstrap.sh

The Manual Way: Developer Edition!

Cloning the Lesson Server and the Lessons project:

Open a command shell/window, navigate to where you wish to download the source and type:

git clone https://github.com/WebGoat/WebGoat.git
git clone https://github.com/WebGoat/WebGoat-Lessons.git

Now let's start by compiling the WebGoat Lessons server.

cd WebGoat
mvn clean compile install
cd ..

Before you can run the project, we need to compile the lessons and copy them over:

** If you don't run this step, you will not have any Lessons to work with!**

cd WebGoat-Lessons
mvn package
cp target/plugins/*.jar ../WebGoat/webgoat-container/src/main/webapp/plugin_lessons/
cd ..

Now we are ready to run the project. There are 3 options you can choose from to run the project:

Then you can run the project with one of the steps below (From the WebGoat folder not WebGoat-Lessons):

Option #1: Using the Maven-Tomcat Plugin

The maven tomcat7:run-war goal runs the project in an embedded tomcat:

cd WebGoat
mvn -pl webgoat-container tomcat7:run-war

Browse to http://localhost:8080/WebGoat and happy hacking !

Option #2: Java executable JAR

The maven package goal generates an executable .jar file:

cd WebGoat
mvn package
cd webgoat-container/target
java -jar webgoat-container-7.0-SNAPSHOT-war-exec.jar http://localhost:8080/WebGoat

Browse to http://localhost:8080/WebGoat and happy hacking !

Option #3: Deploy the WebGoat WAR file in yout local Tomcat or other Application Serve:

The maven package goal generates a .war file that can deployed into an Application Server, such as Tomcat

cd WebGoat
mvn package 
cp webgoat-container/target/webgoat-container-7.0-SNAPSHOT-war-exec.jar <your_tomcat_directory>/webapps/

Browse to http://localhost:8080/WebGoat and happy hacking !

Reloading plugins

If you want to reload all the plugin visit the following url: http://localhost:8080/WebGoat/service/reloadplugins.mvc in a new browser tab. After reloading a message will appear and you can refresh the WebGoat browser tab.

Debugging label properties

To be able to see which labels are loaded through a property file you first need to visit the following url: http://localhost:8080/WebGoat/service/debug/labels.mvc in a new browser tab. Switch back to the WebGoat page and reload this page. After this labels which load label from the property file will marked green.

webgoat's People

Contributors

act-ive avatar aloney avatar arajparaj avatar dcowden avatar dmayhew avatar dougmorato avatar iammyr avatar juliadotter avatar lawson89 avatar mayhew64 avatar misfir3 avatar mosabua avatar nbaars avatar thiswayman avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.