See all Java Examples

The Java SDK package also includes a “Hello World” application based on Web Platform, an example of the authentication process in its simplest form including QR code integration. 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.

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, must have personal factor and be approved

Steps to install the application as a part of Tomcat:

1. Install Tomcat adapter
2. Rename the supplied web application “Hello World” from api-web-webapp-[version].war to api-web-webapp.war.
3. Load the api-web-webapp.war web archive to Tomcat (to the $TOMCAT_HOME/webapps directory).
4. Run Tomcat so that the installed sample web application unpacks to the subdirectory api-webapp in $TOMCAT_HOME/webapps directory.
5. Stop Tomcat.
6. Set the “aimUrl” context parameter in the file $TOMCAT_HOME/webapps/api-webapp/WEB-INF/web.xml 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.
7. Run Tomcat.

After the installation, the application will be available on:

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

Example of address:

http://10.20.29.189:8080/api-web-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, contains links to start ADUCID^® authentication and integrated QR code
• /loggedIn.jsp – the page to which the Web Platform reroutes the result of authentication; it shows authentication success
• /error.jsp – the page to which the Web Platform reroutes the result of authentication; it shows authentication failure

<font 11.0pt/11;;inherit;;inherit>The minimum sequence of the functional code and configuration can be found in the application source code. The code is essential for integration of ADUCID^® authentication into third-party systems.</font>