ADUCID 4.x

The Java SDK package also includes a simple “Hello World” application, an example of the authentication process in its simplest form. It is a standard Java web application that can be placed in any web container supporting servlet 3.0. The Tomcat web container will be used here. The application is provided including source files, nevertheless all logic is in jsp in the form of scriptlets.

Steps to install the application as a part of Tomcat:

1. Rename the supplied simple web application “Hello World” from api-webapp-[version].war to api-webapp.war.
2. Load the api-webapp.war web archive to Tomcat (to the $TOMCAT_HOME/webapps directory).
3. Run Tomcat so that the installed sample web application unpacks to the subdirectory api-webapp in $TOMCAT_HOME/webapps directory.
4. Stop Tomcat.
5. Set the “host” parameter in the file $TOMCAT_HOME/webapps/api-webapp/WEB-INF/classes/config.properties to the machine address (including port), where the AIM and AIM-Proxy applications are running. If the parameter is not configured, the application won’t work properly.
6. Run Tomcat.

After the installation, the application will be available on:

http://[your_container_ip]:[your_container_port]/api-webapp

Example of address:

http://10.20.29.189:8080/api-webapp

If you install the sample application in Linux/Unix OS, stop the iptables service or modify its configuration.

Then the following pages will be available:

• /index.jsp, access also via / – freely accessible page, which automatically initiates the authentication process after being called
• /result.jsp – the page to which the AIM Proxy reroutes the result of authentication; it shows authentication success/failure information, including the basic set of user attributes

The minimum sequence of the functional code can be found in the code of these pages. The code is essential for integration of ADUCID^® authentication into third-party systems.