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.


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.


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


Default style definitions


Custom style definitions


Custom style definitions when using the OWA look and feel


Custom image files


Custom image files when using the OWA look and feel


Default content definitions


Custom content definitions


Custom content definitions when using the OWA look and feel


Default language definitions


Custom language definitions


Custom login and logoff pages when using the OWA look and feel


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 file) Save custom file in

Display a message when the site is opened as a popup (in a new window).


(1) ViewPopupMessage


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.


(2) MSHotfixURL


Specify default length limits for user authentication values.


(3) PasswordLimit; UserNameLimit; ChallengeLimit

Default values are as follows:

PasswordLimit = 20

UserNameLimit = 50

ChallengeLimit = 20


Modify the logo file.



Modify the position of the logo displayed in the top left corner of the page.

InternalSite\inc\ (for client endpoint handheld devices)


Modify the position of the text displayed at the bottom of the page

InternalSite\inc\ (for client endpoint computers)

InternalSite\inc\ (for client endpoint handheld devices). By default, this file is empty.


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)



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: