Difference between revisions of "ESAPI Swingset"

Revision as of 21:01, 4 September 2008

The ESAPI Swingset is a web application which demonstrates the many uses of the Enterprise Security API (ESAPI).

Swingset is still under development, but will be available for download soon.

Download/Run

This download will contain everything you need to get Swingset up and running in a matter of minutes. No installation is necessary (assuming you have a Java JDK installed), just edit one line of a batch file or shell script and you're ready to go!

Downloads

ESAPI Swingset/Apache Tomcat Bundle

1. [ESAPI Swingset bundled with Apache Tomcat]

What is included in this download?

This download includes:

• Apache Tomcat version 6.0.18
• ESAPI Swingset application
• Batch file for easy loading of Apache Tomcat in Windows
• Shell script for easy loading of Apache Tomcat in Unix will be bundled soon
• Everything you need to try Swingset

ESAPI Swingset Source Code

1. [ESAPI Swingset Source Code]

What is included in this download?

This download includes:

• All ESAPI Swingset source files

ESAPI Swingset WAR file

1. [ESAPI Swingset WAR file]

What is included in this download?

This download includes:

• The ESAPI Swingset WAR file -- just drop it in your Apache Tomcat Webapps directory and you're ready to go

Download the JDK

If it is not already installed, please download a Java JDK version 5 or later. Tomcat, the web server you will be using, requires a JDK, rather than a JRE, due to the use of JSPs in ESAPI Swingset.

The Java JDK is available here.

Setup and Run Swingset

Setup Swingset for Windows

1. Extract ESAPI_Swingset.zip to a directory of your choice.
2. Open Windows Explorer and Navigate to the directory to which ESAPI_Swingset.zip was extracted
3. Open Tomcat_6.0.18_start.bat with notepad
4. Set your JAVA_HOME environment variable to a JDK version 5 or later. To do this, change the line "set JAVA_HOME=jdk_directory" to your Java install directory, where "jdk_directory" is the root of your Java directory. For many, the line will look like: "set JAVA_HOME=C:\Program Files\Java\jdk1.6.0_10". Please remember that Swingset requires JDK version 5 or higher. A JRE installation will not work.
5. Save the file

Running Swingset on Windows

1. Navigate to the ESAPI_Swingset directory
2. Execute Tomcat_6.0.18_start.bat. This can be done through the command line or by double clicking the file.
3. If you followed the installation instructions in this wiki, Tomcat should now be running
4. Open a web browser and navigate to http://localhost:8080/main
5. You should see the ESAPI Swingset start page

Project Sponsors

The OWASP ESAPI project is sponsored by