-
Obtain the authentication-translator-1.0.0.jar file from
the web directory of an Integration Server deployment or extract it from the
Integration Server WAR file. This jar file contains the classes and source
required for developing a custom authentication class.
Class Description com.imagenow.authentication.translator. AuthenticationTranslator Abstract base class that defines the interface for all authentication plugins. com.imagenow.authentication.translator. HTTPHeaderTranslator A concrete implementation of an authentication plugin provided for reference. This plugin can read the username from an HTTP header with a custom name supplied by the application.
-
Create a java class that derives from com.imagenow.authentication.translator.AuthenticationTranslator.
-
Choose a meaningful class and package name to reflect what your plugin does.
-
Your class must implement the following method. If an exception is thrown, the user is denied access to the application. If the return value is the empty string, the user is denied access to the application. If a valid user name is returned, the application attempts to authenticate as that user.
public abstract String getUsername(Map<String, List<String>> headers);
-
Your class can get access to properties defined in the Integration Server configuration file (integrationserver.ini) through the getProperty method on the base class.
String headerName = getProperty("sso.httpheader.name");
-
- Compile your class and bundle it into a JAR file with a name of your choosing.
To author a plugin, complete the following steps.