Skip to content

Commit 43fccdc

Browse files
committed
WEB-126 Updated all introduction lessons
1 parent 710e3ee commit 43fccdc

File tree

7 files changed

+49
-54
lines changed

7 files changed

+49
-54
lines changed
-35 KB
Binary file not shown.
-52.3 KB
Binary file not shown.
-28.2 KB
Binary file not shown.
324 KB
Loading
-31.3 KB
Binary file not shown.
Lines changed: 48 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,23 @@
11
<!-- Start Instructions -->
22
<h1>How To Work With WebGoat</h1>
33
<p>
4-
Welcome to a short introduction to WebGoat.<br>
5-
Here you will learn how to use WebGoat and additional tools for the lessons.<br><br>
4+
Welcome to a brief overview of WebGoat.<br>
65
</p>
76
<h2>Environment Information</h2>
87
<p>
9-
WebGoat uses the Apache Tomcat server. It is configured to run on localhost although this can be
10-
easily changed. This
11-
configuration is for single user, additional users can be added in the tomcat-users.xml file.
12-
If you want to use WebGoat in a laboratory or in
13-
class you might need to change this setup. Please refer to the Tomcat Configuration
14-
in the Introduction section.</p>
8+
WebGoat uses the Apache Tomcat server but can run in any application server. It is configured to run on
9+
localhost although this can be easily changed. </p>
1510

1611
<h2>The WebGoat Interface</h2>
1712
<p>
18-
<img src="images/introduction/interface.jpg"><br><br>
13+
<img src="images/introduction/interface.png"><br><br>
1914
1. These are Lesson Categories in WebGoat. Click on a Category to see all Lessons in it.<br>
20-
2. This will show technical hints to solve the lesson.<br>
21-
3. This will show the HTTP Request Parameters<br>
22-
4. This will show the HTTP Request Cookies<br>
23-
5. This will show goals and objectives of the lesson.<br>
24-
6. This will show the underlying Java source code.<br>
25-
7. This will show the complete solution of the selected lesson.<br>
26-
8. If you want to restart a lesson you can use this link.</p>
15+
2. This will show the underlying Java source code.<br>
16+
3. This will show the complete solution of the selected lesson.<br>
17+
4. This will show goals and objectives of the lesson.<br>
18+
5. This will show technical hints to solve the lesson.<br>
19+
6. This will show the HTTP request data<br>
20+
7. If you want to restart a lesson you can use this link.</p>
2721
<h2>Solve The Lesson</h2>
2822
<p>
2923
Always start with the lessons plan. Then try to solve the lesson and if necessary,
@@ -32,12 +26,48 @@ <h2>Solve The Lesson</h2>
3226
<h2>Read And Edit Parameters</h2>
3327
<p>
3428
To read and edit Parameters you need a local proxy to intercept the HTTP request.
35-
Here we use WebScarab. More information on WebScarab can be found in the "Useful Tools" Chapter.
29+
Here we use OWASP ZAP. More information on ZAP can be found in the "Useful Tools" Chapter.
3630
</p>
3731
<h2>Read And Edit Cookies</h2>
3832
<p>
3933
Often it is not only necessary to change the value of the parameters but to change the value of cookies.
40-
WebScarab has functionality for this as well.
34+
OWASP ZAP has functionality for this as well.
4135

4236
</p>
37+
38+
<h2>Configuring new WebGoat users</h2>
39+
<p>
40+
WebGoat uses spring-security.xml to configure users.
41+
<br/>
42+
<pre>
43+
&lt;!-- Authentication Manager --&gt;
44+
&lt;authentication-manager alias="authenticationManager"&gt;
45+
&lt;authentication-provider&gt;
46+
&lt;user-service&gt;
47+
&lt;user name="guest" password="guest" authorities="ROLE_WEBGOAT_USER" /&gt;
48+
&lt;user name="webgoat" password="webgoat" authorities="ROLE_WEBGOAT_ADMIN" /&gt;
49+
&lt;user name="server" password="server" authorities="ROLE_SERVER_ADMIN" /&gt;
50+
&lt;/user-service&gt;
51+
&lt;/authentication-provider&gt;
52+
&lt;/authentication-manager&gt;
53+
</pre>
54+
</p>
55+
<h2>Adding Users</h2>
56+
<p>
57+
Usually using WebGoat you just use the user guest with the password guest.
58+
But maybe in laboratory you have made a setup with one server and a lot of
59+
clients. In this case you might want to have a user for every client
60+
and you have to alter /WEB-INF/spring-security.xml as the users are stored there. <b>We recommend not to use real passwords
61+
as the passwords are stored in plain text in this file!</b>
62+
</p>
63+
<h3>Add User</h3>
64+
<p>
65+
Adding a user is straight forward. You can use the guest entry as an example. The added
66+
users should have the same role as the guest user. The new user/password will not show on the login page.
67+
Add lines like this to the file:
68+
</p>
69+
<pre>
70+
&lt;user name="guest2" password="guest2" authorities="ROLE_WEBGOAT_USER" /&gt;
71+
...
72+
</pre>
4373
<!-- Stop Instructions -->

src/main/webapp/lesson_plans/English/TomcatSetup.html

Lines changed: 1 addition & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -78,41 +78,6 @@ <h3>Permit Only Certain Clients Connection</h3>
7878
</pre>
7979
<p>In this case only localhost, ip1 and ip2 are permitted to connect.</p>
8080

81-
<h2>Configuring new WebGoat users</h2>
82-
<p>
83-
WebGoat uses spring-security.xml to configure users.
84-
<br/>
85-
<pre>
86-
&lt;!-- Authentication Manager --&gt;
87-
&lt;authentication-manager alias="authenticationManager"&gt;
88-
&lt;authentication-provider&gt;
89-
&lt;user-service&gt;
90-
&lt;!-- TODO: credentials in the config - this isn't something I'm proud of - get rid of this ASAP --&gt;
91-
&lt;user name="guest" password="guest" authorities="ROLE_WEBGOAT_USER" /&gt;
92-
&lt;user name="webgoat" password="webgoat" authorities="ROLE_WEBGOAT_ADMIN" /&gt;
93-
&lt;user name="server" password="server" authorities="ROLE_SERVER_ADMIN" /&gt;
94-
&lt;/user-service&gt;
95-
&lt;/authentication-provider&gt;
96-
&lt;/authentication-manager&gt;
97-
</pre>
98-
</p>
99-
<h2>Adding Users</h2>
100-
<p>
101-
Usually using WebGoat you just use the user guest with the password guest.
102-
But maybe in laboratory you have made a setup with one server and a lot of
103-
clients. In this case you might want to have a user for every client
104-
and you have to alter /WEB-INF/spring-security.xml as the users are stored there. <b>We recommend not to use real passwords
105-
as the passwords are stored in plain text in this file!</b>
106-
</p>
107-
<h3>Add User</h3>
108-
<p>
109-
Adding a user is straight forward. You can use the guest entry as an example. The added
110-
users should have the same role as the guest user. The new user/password will not show on the login page.
111-
Add lines like this to the file:
112-
</p>
113-
<pre>
114-
&lt;user name="guest2" password="guest2" authorities="ROLE_WEBGOAT_USER" /&gt;
115-
...
116-
</pre>
81+
11782

11883
<!-- Stop Instructions -->

0 commit comments

Comments
 (0)