IOPLEX

Jespa Technical Documentation

Learn / Run the Jespa Start Webapp
Run the Jespa Start Executable Jar
Run the Jespa Start Webapp
Install the HttpSecurityService for Windows Silent SSO with SPNEGO Diagnosing and Fixing Issues with Kerberos Possible Issues using the HttpSecurityService The HssSetup Console Menu Program How Silent SSO with SPNEGO Over HTTP Works Manually Create the Computer Account for the HttpSecurityService Upgrading a Pre-Jespa 2.1 Installation for Windows Silent SSO with SPNEGO Increasing Request Header Size for Users in Many Groups

Run the Jespa Start Webapp

As an alternative to the Jespa Start executable jar, there is also a webapp war file version of Jespa Start located in the jespa-start-webapp directory of the standard Jespa package. The Jespa Start webapp is meant to be a good example of how to integrate Jespa into a Jakarta application.

Specifically, consider the file:

jespa-start-webapp/src/main/webapp/WEB-INF/web.xml

and how it uses jespa.servlet.SsoOrLoginSecurityFilter and jespa.servlet.LoginServlet as generic components.

Generate the HSS Properties File

Before we do anything else, we need an HttpSecurityService (HSS) properties file.

With the application server running with HTTPS, run HssSetup like: 

$ cd jespa-2.1.1
$ bin/HssSetup.sh jespa1.prp
--
HttpSecurityService Setup / Jespa 2.1.1
...

See steps 1 and 2 from Install the HttpSecurityService for Windows Silent SSO with SPNEGO for details about generating an HSS properties file.

Copy the HSS properties file to the specific name jespa.prp in the context root of your application server (like $CATALINA_BASE or $JETTY_BASE).

Note: The name and location of the HSS properties file is specified by the properties.path parameter in the web.xml.

Build the Jespa Start Webapp War file

To build the war file, you must first install the Jespa jar file (the jakarta version) into your local Maven repo with a command like: 

$ cd jespa-2.1.1
$ mvn install:install-file -Dfile=jespa-jakarta-2.1.1.jar -DgroupId=com.ioplex -DartifactId=jespa-jakarta -Dversion=2.1.1 -Dpackaging=jar
Installing the jespa-jakarta-2.1.1.jar file into the local Maven repo

Now you can build the war file like: 

$ cd jespa-start-webapp
$ mvn clean package

Deploying the Jespa Start Webapp

Deploy the target/jespa-start-webapp.war into your application server (such as by copying it to webapps/ROOT.war).

If necessary, create a logs directory in the application server context root (like $JETTY_BASE/logs) for the Jespa log file.

At this point, the Jespa Start webapp should be ready for clients. However, before trying to visit the site, you will probably need to adjust browser client settings and open a firewall port as described in Browser Settings and Adding a Firewall Rule.

Now visit the jespa-start resource. The URL might be like https://rkyas15.mega.corp:8443/jespa-start but substitute your host, port and context path.

Review logs/jespa.log for issues.

See also: Run the Jespa Start Executable Jar

To un-install the Jespa jar from your local Maven repo, use the following command: 

$ mvn dependency:purge-local-repository -DmanualInclude="com.ioplex:jespa-jakarta"
Un-installing the jespa-jakarta-2.1.1.jar file from the local Maven repo