Difference between revisions of "WebGoat Installation"

From OWASP
Jump to: navigation, search
m (Undid own damage; merged OS X subsection into parent; updated Linux and FreeBSD sections)
m (simplified HTML)
Line 25: Line 25:
 
<li>Change "1.5" on lines 17, 19, and 23 of webgoat.sh to "1.6".</li>
 
<li>Change "1.5" on lines 17, 19, and 23 of webgoat.sh to "1.6".</li>
 
<li>Since the latest version runs on a privileged port, you will need to start/stop WebGoat & Tomcat either:</li>
 
<li>Since the latest version runs on a privileged port, you will need to start/stop WebGoat & Tomcat either:</li>
</ol>
 
 
<ol type="a">
 
<ol type="a">
:<li>on port 80 as root:</li>
+
<li>on port 80 as root:<pre>
 +
sudo sh webgoat.sh start80
 +
sudo sh webgoat.sh stop
 +
</pre></li>
 +
<li>or on port 8080:<pre>
 +
sh webgoat.sh start8080
 +
sh webgoat.sh stop
 +
</pre></li>
 
</ol>
 
</ol>
sudo sh webgoat.sh start80
+
</li>
sudo sh webgoat.sh stop
+
<ol type="a" start="2">
+
:<li>or on port 8080:</li>
+
 
</ol>
 
</ol>
sh webgoat.sh start8080
 
sh webgoat.sh stop
 
  
 
==Installing to OS X (Tiger 10.4+) ==
 
==Installing to OS X (Tiger 10.4+) ==
Line 42: Line 43:
 
<li>Change "1.5" on line 10 of webgoat.sh to "1.6".</li>
 
<li>Change "1.5" on line 10 of webgoat.sh to "1.6".</li>
 
<li>Since the latest version runs on a privileged port, you will need to start/stop WebGoat & Tomcat either:</li>
 
<li>Since the latest version runs on a privileged port, you will need to start/stop WebGoat & Tomcat either:</li>
</ol>
 
 
<ol type="a">
 
<ol type="a">
:<li>on port 80 as root:</li>
+
<li>on port 80 as root:<pre>
 +
sudo sh webgoat.sh start80
 +
sudo sh webgoat.sh stop
 +
</pre></li>
 +
<li>or on port 8080:<pre>
 +
sh webgoat.sh start8080
 +
sh webgoat.sh stop
 +
</pre></li>
 
</ol>
 
</ol>
sudo sh webgoat.sh start80
+
</li>
sudo sh webgoat.sh stop
+
<ol type="a" start="2">
+
:<li>or on port 8080:</li>
+
 
</ol>
 
</ol>
sh webgoat.sh start8080
 
sh webgoat.sh stop
 
  
 
==Installing on FreeBSD ==
 
==Installing on FreeBSD ==
 
<ol>
 
<ol>
<li>Install Tomcat and Java from the ports collection:</li>
+
<li>Install Tomcat and Java from the ports collection:<pre>
</ol>
+
cd /usr/ports/www/tomcat55
  cd /usr/ports/www/tomcat55
+
sudo make install
  sudo make install
+
</pre></li>
<ol start="2">
+
 
<li>You will be required to manually [http://www.FreeBSDFoundation.org/cgi-bin/download?download=diablo-caffe-freebsd6-i386-1.5.0_07-b01.tar.bz2 download the Java JDK] to install it.  Instructions are given by the ports system about when and how to do this.</li>
 
<li>You will be required to manually [http://www.FreeBSDFoundation.org/cgi-bin/download?download=diablo-caffe-freebsd6-i386-1.5.0_07-b01.tar.bz2 download the Java JDK] to install it.  Instructions are given by the ports system about when and how to do this.</li>
 
<li>Unzip WebGoat-OWASP_Standard-x.x.zip to your working directory.</li>
 
<li>Unzip WebGoat-OWASP_Standard-x.x.zip to your working directory.</li>
 
<li>Change "1.5" on lines 17, 19, and 23 of webgoat.sh to "1.6".</li>
 
<li>Change "1.5" on lines 17, 19, and 23 of webgoat.sh to "1.6".</li>
</ol>
 
<ol start="5">
 
 
<li>Since the latest version runs on a privileged port, you will need to start/stop WebGoat & Tomcat either:</li>
 
<li>Since the latest version runs on a privileged port, you will need to start/stop WebGoat & Tomcat either:</li>
</ol>
 
 
<ol type="a">
 
<ol type="a">
:<li>on port 80 as root:</li>
+
<li>on port 80 as root:<pre>
 +
sudo sh webgoat.sh start80
 +
sudo sh webgoat.sh stop
 +
</pre></li>
 +
<li>or on port 8080:<pre>
 +
sh webgoat.sh start8080
 +
sh webgoat.sh stop
 +
</pre></li>
 
</ol>
 
</ol>
sudo sh webgoat.sh start80
+
</li>
sudo sh webgoat.sh stop
+
<ol type="a" start="2">
+
:<li>or on port 8080:</li>
+
 
</ol>
 
</ol>
sh webgoat.sh start8080
 
sh webgoat.sh stop
 
  
 
==Running ==
 
==Running ==

Revision as of 19:58, 16 January 2009

WebGoat User Guide Table of Contents

Contents


WebGoat is a platform independent environment. It utilizes Apache Tomcat and the JAVA development environment. Installers are provided for Microsoft Windows and UN*X environments, together with notes for installation on other platforms.

Installing Java and Tomcat

Note: This may no longer be necessary for v5.

Installing Java

  1. Install and deploy the approprite version from http://java.sun.com/downloads/ (1.4.1 or later)

Installing Tomcat

  1. Install and deploy core Tomcat from http://tomcat.apache.org/download-55.cgi

Installing to Windows

  1. Unzip WebGoat-OWASP_Standard-5.2.zip to your working environment.
  2. To start Tomcat, browse to the WebGoat directory unzipped above and double click "webgoat.bat"
  3. Start your browser and browse to: http://localhost/WebGoat/attack This link is case-sensitive. Make sure to use a large ‘W’ and ‘G’.

Installing to Linux

  1. Unzip WebGoat-OWASP_Standard-x.x.zip to your working directory.
  2. Change "1.5" on lines 17, 19, and 23 of webgoat.sh to "1.6".
  3. Since the latest version runs on a privileged port, you will need to start/stop WebGoat & Tomcat either:
    1. on port 80 as root:
      sudo sh webgoat.sh start80
      sudo sh webgoat.sh stop
      
    2. or on port 8080:
      sh webgoat.sh start8080
      sh webgoat.sh stop
      

Installing to OS X (Tiger 10.4+)

  1. Unzip WebGoat-OWASP_Standard-x.x.zip to your working directory.
  2. Change "1.5" on line 10 of webgoat.sh to "1.6".
  3. Since the latest version runs on a privileged port, you will need to start/stop WebGoat & Tomcat either:
    1. on port 80 as root:
      sudo sh webgoat.sh start80
      sudo sh webgoat.sh stop
      
    2. or on port 8080:
      sh webgoat.sh start8080
      sh webgoat.sh stop
      

Installing on FreeBSD

  1. Install Tomcat and Java from the ports collection:
    cd /usr/ports/www/tomcat55
    sudo make install
    
  2. You will be required to manually download the Java JDK to install it. Instructions are given by the ports system about when and how to do this.
  3. Unzip WebGoat-OWASP_Standard-x.x.zip to your working directory.
  4. Change "1.5" on lines 17, 19, and 23 of webgoat.sh to "1.6".
  5. Since the latest version runs on a privileged port, you will need to start/stop WebGoat & Tomcat either:
    1. on port 80 as root:
      sudo sh webgoat.sh start80
      sudo sh webgoat.sh stop
      
    2. or on port 8080:
      sh webgoat.sh start8080
      sh webgoat.sh stop
      

Running

  1. Start your browser and browse to: http://localhost/WebGoat/attack. Notice the capital 'W' and 'G'
  2. Login in as: user = guest, password = guest

Building

Skip these instructions if you are only interested in running WebGoat.

WebGoat is built using eclipse WTP 1.5.x. Please read the instructions at Goodle code to build the WebGoat application.

Return to the WebGoat User Guide Table of Contents