12 November 2010

Customise TMG Exchange forms authentication page

When publishing Exchange web access through TMG or ISA the supported method for authentication is forms based authentication.

Be default you have two choices.  You can go for the standard TMG template (still called ISA) or you can use the Exchange template.

These templates are located in c:\program files\Program Files\Microsoft Forefront Threat Management Gateway\Templates\CookieAuthTemplates\

  • HTML—Intended for standard browsers. 
  • cHTML—Intended for browsers that support cHTML, such as i-mode mobile devices.
  • xHTML—Intended for browsers that support xhtml-mp, such as Microsoft Windows Mobile® and other mobile devices.

We are going to be looking at the HTML version.  There are many different pages that can be changed if you really want to but all you need to do to change the look and feel of the page it to edit a few images and change a few text strings.

The key images you will probably want to change are the following:

  • lngtopl.gif
  • lngtopr.gif
  • lngbotl.gif
  • lngbotr.gif
I my case I would like to keep the general Office 2010 theme going. I would just like to insert my company logo and change some of the text. I also want to change the color to something more inline with my corporate image.

All the text on the pages are dynamically retrieved from the strings.txt file. here is a small part of it so you can get the idea.

;Strings used in login page

L_LoginButton_Text="Log On"
L_WindowTitle_Text="Microsoft Forefront TMG"
L_ShowDetail_Text="show explanation"
L_HideDetail_Text="hide explanation"
L_ShowSimpleUI_Text="I have a slow Internet connection. If you select this option, the Web applications you use may offer fewer features, but will provide a better experience in some situations."
L_UIBasicDescription_Text="The basic client provides fewer features than the full-featured client but offers faster performance. Use the basic client if you are on a slow connection."

You can open the individual html pages and look for the variable string values or you can look at the rendered page and search the file for the text string you want to change.

There are also two style sheets, one for the fonts owafont.css and another for styles logon_styles.css.  I use SharePoint designer to edit these so that the colours are inline with my corporate ones.

Editing the Logon_styles.css I change the following styles that contain yellow / orange definitions.
  • select,text
  • input.btn
  • .btnOnFcs
  • .btnonmseover
  • .btnonmsedwn
  • a
  • .wrng
Last but not least, I also want to change favicon (the little icon in the address bar) I created an .ico file or the corporate logo and replaced the original one.

Now to put this all together.  Copy your edited files to all the nodes in the array. And restart.

If it was not for writing this blog while I was doing the changes you are looking at about 15mins worth of effort, not bad considering the corporate gratitude and salary increase you will be receiving...

The official guide is here; http://technet.microsoft.com/en-us/library/ee914625.aspx But they don't have pictures :)

Okay, you got me - I don't work for apple - Just trying to get an I-Pad to work so it was top of mind when looking for an alternative logo...

1 comment:

Anonymous said...

Nice guide, thx

Post a Comment