Customise Logon Point Source Files

29 Aug 2006 in Citrix on Access-gateway

Customising Logon points in Advanced Access Control is a fairly easy process. Customisation allows you to add a corporate look and feel to the user interface. However, removing and redeploying the Logon Point will remove all customisations - the Logon Point is just a bunch of HTML and graphic files. Here’s how to customise the source files so that redeployed and new Logon Points will already have your customisations.

1. Navigate to C:\Program Files\Citrix\Access Gateway\WebServicesCabContent.
2. Make a backup copy of LogonAgentApp.CAB - allow for roll back if anything fails.
3. Extract LogonAgentApp.CAB to a folder. For this example I’m using as C:\Temp\LogonAgentApp
4. Make all customisation to the Logon Point files. See here and here for information on customising the Logon Point.
5. Download CABSDK.EXE from Microsoft Cabinet Software Development Kit (Surely there’s a better tool around..)
6. Extract CABSDK.EXE and copy the files from \BIN to C:\Temp.
7. Run the following command-line to pack the Logon Point source files back into a .CAB file: CABARC.EXE -p -r -P Temp\ -P LogonAgentApp\ N LogonAgentApp.CAB LogonAgentApp\*.*
8. Copy the new .CAB file to C:\Program Files\Citrix\Access Gateway\WebServicesCabContent.
9. Deploy your Logon Points with customisations intact.

The CABSDK is quite old but it does the trick. Documentation for CABARC.EXE in included in Word format in CABSDK.EXE. A breakdown of the command line is like this:

• -p CABARC will preserve the paths names for each file within the .CAB file
• -r CABARC will add all subfolders and files (recurse) to the .CAB file
• -P This command is used to script the \Temp and \LogonAgentApp folders from the paths. Otherwise the .CAB file will list the files with an additional path

This command tells CABARC to create a new .CAB file. In this instance LogonAgentApp.CAB

I doubt that this would be supported by Citrix, so make sure you keep a copy of the original .CAB file.