Customizing IAG user authentication pages
Applies To: Intelligent Application Gateway (IAG)
You can customize content and graphics in general Whale Communications Intelligent Application Gateway (IAG) 2007 user interaction pages, such as login and logout pages. Customization settings include the following:
Visual and standard text attributes. Modifications affect all of the relevant parameters in the pages. You cannot assign different parameters to each page in the group. For example, if you change the logo graphic and text, the change is applied uniformly on all pages. For portal trunks, changes also apply to the System Information window if it is enabled to appear in the portal.
Style sheets that affect styles such as fonts and colors. Modifying style sheets requires a working knowledge of cascading style sheets.
The files located in the \Whale-Com\e-Gap\Von\InternalSite folder affect changes you make to these pages. The following table summarizes the folders located under the InternalSite folder and their uses.
| Folder | Contents |
|---|---|
InternalSite/css |
Default style definitions |
InternalSite/css/CustomUpdate |
Custom style definitions |
InternalSite/Images/CustomUpdate |
Custom image files |
InternalSite/inc |
Default content definitions |
InternalSite/inc/CustomUpdate |
Custom content definitions |
InternalSite/Languages |
Default language definitions |
InternalSite/Languages/CustomUpdate |
Custom language definitions |
InternalSite/Samples |
Sample content definitions |
Modifying user authentication pages
Modify pages as follows.
To customize user authentication pages
Either open the relevant sample .inc file (located in the \Whale-Com\e-Gap\Von\InternalSite\samples folder), or create a new .inc file.
Customize files and parameters by modifying the relevant .inc file. Files are described in the section "Customizable files and parameters".
Save customized.inc files in the relevant CustomUpdate folders.
Notes
If you create your own files, ensure you use the same parameter names as those used in the supplied .inc files. If names are not identical, definitions may not be effective.
When you modify a graphic (.gif) file, the name of the file must correlate with the name defined in the relevant .inc file. Graphics for the Submit, Reset, and Go buttons are defined in the customDefault.inc file. The logo is defined in the logo.inc file. Change the path of the .gif file in the relevant .inc file to point to the Images\CustomUpdate folder. Ensure that you make changes in the .inc files located in the inc\CustomUpdate folder.
Customizable files and parameters
The following are the customizable files and parameters.
| Usage | File | (ID) and Parameter (ID correlates with that used in the sample customDefault.inc file) | Save custom file in |
|---|---|---|---|
URL users access when clicking the address defined in logo.inc |
Whale-Com\e-Gap\von\InternalSite\inc\customDefault |
(1) logoLink |
Whale-Com\e-Gap\von\InternalSite\inc\CustomUpdate |
Contact e-mail address |
Whale-Com\e-Gap\von\InternalSite\inc\customDefault |
(2) administratorMailAddress |
Whale-Com\e-Gap\von\InternalSite\inc\CustomUpdate |
Specify whether graphics defined in waves.inc should be displayed |
Whale-Com\e-Gap\von\InternalSite\inc\customDefault |
(3) viewWaves |
Whale-Com\e-Gap\von\InternalSite\inc\CustomUpdate |
Define an image for the submit button (the location of the button on the page is defined in waves.inc) |
Whale-Com\e-Gap\von\InternalSite\inc\customDefault |
(4) submitButton; submitButtonMouseOver; resetButton; resetButtonMouseOver |
Whale-Com\e-Gap\von\InternalSite\inc\CustomUpdate |
Define images displayed on the "Browse additional internal application" page |
Whale-Com\e-Gap\von\InternalSite\inc\customDefault |
(5) goButton; goButtonMouseOver |
Whale-Com\e-Gap\von\InternalSite\inc\CustomUpdate |
Display message when site is opened as a popup (in a new window) |
Whale-Com\e-Gap\von\InternalSite\inc\customDefault |
(6)ViewPopupMessage |
Whale-Com\e-Gap\von\InternalSite\inc\CustomUpdate |
URL of the link where client endpoints running Windows XP SP2 can download the SP2 hotfix if it is not installed |
Whale-Com\e-Gap\von\InternalSite\inc\customDefault |
(7) MSHotfixURL |
Whale-Com\e-Gap\von\InternalSite\inc\CustomUpdate |
Specify default length limits for user authentication values |
Whale-Com\e-Gap\von\InternalSite\inc\customDefault |
(8) PasswordLimit; UserNameLimit; ChallengeLimit Default values are as follows: PasswordLimit = 20 UserNameLimit = 50 ChallengeLimit = 20 |
Whale-Com\e-Gap\von\InternalSite\inc\CustomUpdate |
Modify the logo file |
Whale-Com\e-Gap\von\InternalSite\inc\Logo.inc |
Whale-Com\e-Gap\von\InternalSite\Images\CustomUpdate |
|
Modify the position of the logo displayed in the top left hand corner of the page |
Whale-Com\e-Gap\von\InternalSite\inc\PDA_logo.inc (for client endpoint handheld devices) |
Whale-Com\e-Gap\von\InternalSite\Images\CustomUpdate |
|
Modify the position of the Submit, Reset and Go buttons on the page |
Waves.inc (for client endpoint computers) PDA_waves.inc (for client endpoint handheld devices) |
Whale-Com\e-Gap\von\InternalSite\Images\CustomUpdate |
|
Modify the position of the text displayed at the bottom of the page |
bottomText.inc (for client endpoint computers) PDA_bottomText.inc (for client endpoint handheld devices). By default, this file is empty. |
Whale-Com\e-Gap\von\InternalSite\Images\CustomUpdate |
|
Modify style definitions such as fonts and colors |
Whale-Com\e-Gap\von\InternalSite\css\customDefault\template.css (for client endpoint computers) Whale-Com\e-Gap\von\InternalSite\css\customDefault\PDA_template.css (for client endpoint handheld devices) |
Whale-Com\e-Gap\von\InternalSite\css\CustomUpdate |