ace00002.gif Modifying the Web Authentication Forms


During installation, the ACE/Agent setup program copied the following HTML templates into the Web server machine’s /netscape_home_directory/plugins/aceagent/templates directory.

error.html
The Web page that tokenholders see when a transmission error occurs during authentication.
flterror.html
The Web page that tokenholders see when a filter loading error occurs.
newpin.html
The Web page that appears when a tokenholder’s token is in New PIN mode; it allows a user to create his own PIN.
newpin1.html
The New PIN Web page that appears when a tokenholder is to receive a system-generated PIN.
newpin2.html
The New PIN Web page that appears when a tokenholder is allowed to decide whether she will create her own PIN or receive a system-generated PIN.
nextprn.html
The Web page that appears when a token is in “Next Tokencode” mode. A series of incorrect PASSCODEs during authentication puts a token into this mode. After a correct code is finally entered, the user will be prompted for another correct tokencode before being allowed access.
passcode.html
The WebID authentication prompt form, where the tokenholder enters his or her user name and PASSCODE.

All of these HTML templates can be edited to:

ace00006.gif
Editing the template files requires that you have a thorough understanding of the HTML markup language.

Also, when adding graphics files to the authentication prompt, make sure that the graphics are not loaded from a SecurID-protected directory. If these files are protected, the browser will not recognize them and will display them as “broken image” icons.


Do not alter the position of %s variables

All of the HTML templates (including the New PIN prompts and error pages) can be modified, so long as you do not alter the relative positions of the %s variables in the scripts. If you do, the authentication prompt will not be able to get information from the ACE/Server.


To change the text in a WebID authentication form:

  1. Using a text editor such as vi, open one of the template files in the netscape_home_directory/plugins/aceagent/templates directory.
  1. Delete the text in the <TITLE>, <HEAD>, <H1>, or <P> tags and enter your new heading or body text in its place.

    For instance, the tag
    <H1>Welcome to Widgets, Inc.</H1>

    when placed in the
    passcode.html file, changes the text of the first heading in that page from “SecurID PASSCODE Request” to "Welcome to Widgets, Inc.”

  2. Save and close the file. The form will now display the new greeting to Web users.


To add a custom graphic to a WebID authentication form:

  1. Using a text edior such as vi, open one of the template files in the netscape_home_directory/plugins/aceagent/templates directory.
  1. Decide where you want the image to be placed on the page, then insert an <IMG> tag in the HTML markup pointing to the image file.

For example, the line
<IMG src=“logo.gif” ALIGN=“left”>

places the logo.gif image to the left of the page’s text.

Again, be sure that the image file you point to in the src path is in an unprotected directory.

  1. Save and close the file. The Web authentication prompt will now display the new graphic.