Chapter 2   Authentication Template Files


In order to authenticate the client, the Mobile Access Pack server uses the various pluggable authentication modules (such as UNIX, LDAP, etc.). Once the identity of the client is established, the server uses the client specific template files to display the appropriate menu to the client.

This chapter discusses the HTML, cHTML, and WML template files used by the authentication service. The HTML, cHTML, and WML templates discussed in this chapter facilitate the display of the appropriate authentication menu based on the type of client accessing the Mobile Access Pack server.

When customizing template files, do not edit the original files. Copy the files into a separate directory and make changes to the copies. This will facilitate upgrades and uninstalls.

Authentication Template Files

The following template files with a .html, .chtml, and .wml extension are located in the /etc/opt/SUNWips/auth/default/, /etc/opt/SUNWips/auth/default/chtml/, and in /etc/opt/SUNWips/auth/default/wml/ directories respectively. These files serve the same purpose across all clients.

Table 2-1    Authentication Template Files

Filename	Description
access_fail_admin	Indicates that the user has insufficient privileges or is not authorized to access the administration console although the user was able to log in to the Administration Console
invalidPassword	Indicates that the user's password is invalid
invalidPCookieUserid	Indicates that the user's persistent cookie is invalid
invalid_domain	Indicates that the domain is invalid, sometimes as a result of cached cookies
loginworker_if	Used to form input box
loginworker_loop	Used to form input box
loginworker_main	Used for text for title of page
loginworker_mainend	Used for Submit button or equivalent
login_denied	Indicates that the authentication failed or access is denied because the user does not have a user profile in the database
login_fail_admin	Indicates that access to the Administration Console is denied
login_fail_template	Indicates that the user's authentication attempt has failed
login_license_fail	Indicates that the user's license is invalid
login_menu	Displays all available authentication methods on the user's authentication page
login_menu_modules	This file is used to wrap each authentication module in specific tags on the authentication menu page
login_prompt	Displays the user's login prompt
login_reauth_admin	Indicates that the administrator's session has expired and that the administrator must re-authenticate to the Administration Console
login_success	Indicates that the user's authentication was successful, but the user has no default desktop page to display
login_template	Displays an error message as a result of restricted access to the server
login_timeout_admin	Indicates that the administrator's session on the Administration Console has timed out
login_timeout_template	Indicates that the user's session has timed out
login_trustProxy_warning	Warns the user that the user's mobile device does not support Java
logout	Used to display a logout message and provide a link back to the authentication menu
logout_admin	Used to display a logout message and provide a link back to console login
module_denied	Displays an authentication module denied error message
noLoginWorker	Indicates that no login worker is available
privilege_failure	Indicates that the user does not have sufficient privileges
session_invalid	Indicates that the session is invalid
session_timeout	Indicates that the session has timed out
userExists	Indicates that the user name already exists
userPasswordSame	Indicates that another user is using the same password
wrongPassword	Indicates that the user entered the password incorrectly