Customizing the InternalSite
Updated: February 22, 2012
Applies To: Unified Access Gateway
Forefront Unified Access Gateway (UAG) uses an ASP-based Web application, called InternalSite, to provide authentication services for portal trunks, to install client endpoint components, and to automatically detect the user language. When end users log in to Forefront UAG, a login page is provided by InternalSite, in which the user can select the language to be used by the portal. When using Forefront UAG, you can customize text strings for each language, and for each trunk that is published through Forefront UAG.
Note
Changes made to the InternalSite also apply to the System Information window in the portal.
Forefront UAG supports several types of endpoint devices. The different versions of the InternalSite Web application correspond to the following groups of endpoint devices:
Computer—Home or office computers running Windows, Macintosh, or Linux operating systems.
Premium mobile—Mobile devices running Windows Phone, Windows Mobile, Android devices, or the Apple iPhone and iPad.
Non-premium mobile—Other mobile devices.
Note
An additional version of the InternalSite Web application provides an Outlook Web Access (OWA) look and feel for the end user.
Using the CustomUpdate mechanism (described in About the CustomUpdate mechanism), you can customize:
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.
Style sheets that affect styles such as fonts and colors—Modifying style sheets requires a working knowledge of cascading style sheets.
The default items and values for the elements that make up the InternalSite are located under the ...\Microsoft Forefront Unified Access Gateway\von\InternalSite directory.
The following table lists the directory structure and location of the customizable elements.
| Folder | Contents |
|---|---|
InternalSite/css |
Default style definitions |
InternalSite/css/CustomUpdate |
Custom style definitions |
InternalSite/css/OWA |
Custom style definitions when using the OWA look and feel |
InternalSite/Images/CustomUpdate |
Custom image files |
InternalSite/Images/OWA |
Custom image files when using the OWA look and feel |
InternalSite/inc |
Default content definitions |
InternalSite/inc/CustomUpdate |
Custom content definitions |
InternalSite/inc/OWA |
Custom content definitions when using the OWA look and feel |
InternalSite/Languages |
Default language definitions |
InternalSite/Languages/CustomUpdate |
Custom language definitions |
InternalSite/OWA |
Custom login and logoff pages when using the OWA look and feel |
InternalSite/Samples |
Sample content definitions |
The following table lists the customizable files and parameters in those files.
| Action | File | (ID) and Parameter (ID correlates with that used in the sample customDefault.inc file) | Save custom file in |
|---|---|---|---|
Display a message when the site is opened as a popup (in a new window). |
InternalSite\inc\customDefault.inc |
(1) ViewPopupMessage |
InternalSite\inc\CustomUpdate |
Specify the URL of the link where client endpoints running Windows XP with Service Pack 2 can download the SP2 hotfix if it is not installed. |
InternalSite\inc\customDefault.inc |
(2) MSHotfixURL |
InternalSite\inc\CustomUpdate |
Specify default length limits for user authentication values. |
InternalSite\inc\customDefault.inc |
(3) PasswordLimit; UserNameLimit; ChallengeLimit Default values are as follows: PasswordLimit = 20 UserNameLimit = 50 ChallengeLimit = 20 |
InternalSite\inc\CustomUpdate |
Modify the logo file. |
InternalSite\inc\Logo.inc |
InternalSite\Images\CustomUpdate |
|
Modify the position of the logo displayed in the top left corner of the page. |
InternalSite\inc\PDA_logo.inc (for client endpoint handheld devices) |
InternalSite\Images\CustomUpdate |
|
Modify the position of the text displayed at the bottom of the page |
InternalSite\inc\bottomText.inc (for client endpoint computers) InternalSite\inc\PDA_bottomText.inc (for client endpoint handheld devices). By default, this file is empty. |
InternalSite\Images\CustomUpdate |
|
Modify style definitions such as fonts and colors. |
InternalSite\css\template.css (for client endpoint computers) InternalSite\css\PDA_template.css (for client endpoint handheld devices) |
InternalSite\css\CustomUpdate |
Note
Although customizations are not deleted when you update Forefront UAG, they may not work after applying an update or hotfix.
The following topics describe the customizations in detail: