Technical Note: Using Access Manager Distributed Authentication

Building the Distributed Authentication Web Application

The JES 4 Installation Utility installs the distributed authentication package in the AccessManager-base/SUNWcomm/SUNWam, however in order for distributed authentication to function properly, the packages must be located in AccessManager-base/SUNWam. Copy the following files to the AccessManager-base/SUNWam directory and proceed with the steps described in this document:

README.distAuthUI

Contains installation and package instructions.

amauthistui.war

The distributed authentication Web application.

Makefile.distAuthUI

The Makefile.distAuthUIis used to generate and build required web application. The makefile defines targets to build configuration properties and web application and jars

ProcedureTo Build the Distributed Authentication Web Application

Steps
  1. Edit the Makefile.distAuthUI to provide the following required parameters:

    • JAVA_HOME

    • SERVER_PROTOCOL

    • SERVER_HOSTNAME

    • SERVER_PORT

    • SERVER_DEPLOY_URI

    • APPLICATION_USERNAME

    • APPLICATION_PASSWORD

    • DISTAUTH_DEPLOY_URI

    • DISTAUTH_PROTOCOL

    • DISTAUTH_HOSTNAME

    • DISTAUTH_PORT

  2. Enter the following command to run the makefile:

    make -f Makefile.distAuthUI

    This command generates a deployable war file (amauthdistui_deploy.war) that can be deployed in any Servlet 2.3 compliant container. The targets defined in the Makefile.distAuthUI are:

    properties

    Generates AMConfig.properties in the temporary directory. This file is used as a template for setting Access Manager Distributed Authentication Web Application's properties

    webapp

    Generates amauthdistui_deploy.war that can be deployed on any Servlet 2.3–compliant web container