Sun Java System Access Manager 7 2005Q4 Developer's Guide

Creating Custom Organization Files

To customize the console for use by a specific organization, the AccessManager-base/SUNWam/web-src/applications/console directory should first be copied, renamed and placed on the same level as the default directory. The files in this new directory can then be modified as needed.

Note –

There is no standard to follow when naming the new directory. The new name can be any arbitrarily chosen value.

For example, customized console files for the organization dc=new_org, dc=com might be found in the AccessManager-base/SUNWam/web-src/applications/custom_directory directory.

ProcedureTo Create Custom Organization Files

  1. Change to the directory where the default templates are stored:

    cd AccessManager-base/SUNWam/web-src/applications

  2. Make a new directory at that level.

    The directory name can be any arbitrary value. For this example, it is named AccessManager-base/SUNWam/web-src/applications/custom_directory/.

  3. Copy all the JSP files from the console directory into the new directory.

    AccessManager-base/SUNWam/web-src/applications/console contains the default JSP for Access Manager. Ensure that any image files are also copied into the new directory.

  4. Customize the files in the new directory.

    Modify any of the files in the new directory to reflect the needs of the specific organization.

  5. Modify the AMBase.jsp file.

    In our example, this file is found in AccessManager-base/SUNWam/web-src/applications/custom_directory/base. The line String console = "../console"; needs to be changed to String console = "../new_directory_name ";. The String consoleImages tag also needs to be changed to reflect a new image directory, if applicable. The contents of this file are copied in Creating Custom Organization Files.

     Copyright © 2002 Sun Microsystems, Inc. All rights reserved.
     Use is subject to license terms.
    <% String console = "../console";
       String consoleUrl = console + "/";
       String consoleImages = consoleUrl + "images";
  6. Change the value of the JSP Directory Name attribute in the Administration Service to match that of the directory created in Creating Custom Organization Files.

    The JSP Directory Name attribute points the Authentication Service to the directory which contains an organization’s customized console interface. Using the console itself, display the services registered to the organization for which the console changes will be displayed. If the Administration Service is not visible, it will need to be registered. For information on registering services, see the Administration Guide.

    Once the new set of console files have been modified, the user would need to log into the organization where they were made in order to see any changes. Elaborating on our example, if changes are made to the JSP located in the AccessManager-base/SUNWam/web-src/applications/custom_directory directory, the user would need to login to that organization using the URL:

    http:// server_name.domain_name:port//