The Java SDK package also includes an advanced “Hello World” application, an example of all basic operation and showcase of some advanced operation. 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.

Try it out

Get sources and binaries on GitHub

If full application functionality is expected, the following needs to be arranged:

• PEIG must be running (ADUCID^® client side)
• Valid identity must exist in ADUCID^® Server Kit

Steps to install the application as a part of Tomcat:

1. Rename the supplied advanced web application “Hello World” from api-advanced-webapp-[version].war to api-advanced-webapp.war.
2. Load the api-advanced-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-advanced-webapp in $TOMCAT_HOME/webapps directory.
4. Stop Tomcat.
5. Set the “host” parameter in the file $TOMCAT_HOME/webapps/api-advanced-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-advanced-webapp

Example of address:

http://10.20.29.189:8080/api-advanced-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:

• /requestOperation.jsp, access also via / – freely accessible page, it shows all request operation methods, which can be called; methods starting authentication session
• /getPSLAttributes.jsp – the page to which the AIM Proxy reroutes the result of authentication; it shows authentication success/failure information and links to advanced operations, calling advanced operations requires authId and authKey pair
• /executePersonalObject.jsp – the page with result of advanced operation
• /closeSession.jsp – the page with result of close session operation

<font 11.0pt/11;;inherit;;inherit>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.</font>