Adding text to Access Gateway (AGEE) Enterprise Logon Page

Adding text to Access Gateway (AGEE) Enterprise Logon Page

Recently a customer requested the ability to direct Access Gateway Enterprise users towards an online help page that held answers to frequently asked questions.There is no native way to achieve this and limited information published out there, however Shaun Ritchie has completed an excellent article with some good information, I recommend reading it:http://www.shaunritchie.co.uk/customizing-citrix-access-gatewayMy customer’s requirements were a little different, so I am going to explain here exactly how I achieved it.**Before following this please note that this is not an official method listed by Citrix, so any work you complete is done so at your own risk**

Step 1 – Backing up the files

Before making any changes it is always a good idea to backup the file that you are about to modify, in this instance it is/netscaler/ns_gui/***/index.html – use WinSCP to copy this file elsewhere.

Step 2 – Download the file and modify it

Download the index.html via WinSCP and open the file in a text editor (Notepad++ is particularly good)Navigate to line 116 and you should see “</table>” – start a new line and then insert the following code:

*Change the URL to match the site and page that you want to direct users to.

Step 3 – Upload the modified file and ensure it is still available after a reboot

By default Access Gateway files are re-deployed when the unit is rebooted, this unforuntately means that customisations are lost, however NetScaler can use a file named “rc.netscaler” to process a list of tasks to be completed when booting. As such we will use this to deploy our customised logon page.Create a directory named “customizations” in the /var directory – this can either be done via WinSCP or by SSH(“mkdir /var/customizations”). Upload the modified “index.html” to this folder and also overwrite the current index.html (/netscaler/ns_gui/***/index.html) .Use SSH to connect to the NSIP of the NetScaler and then issue the following commands (without quotation marks):“shell” (launches the standard shell rather than NetScaler config)“touch /nsconfig/rc.netscaler” (creates the rc.netscaler file)“echo cp /var/customizations/index.html /netscaler/ns_gui/***/index.html >> /nsconfig/rc.netscaler” (writes the statement to the rc.netscaler file instructing it to overwrite the default index.html with the modified version)This will instruct the NetScaler to overwrite the default index.html with the modified file that is within /var/customizations, to ensure that the statement was correctly entered in to the rc.netscaler file execute the following command“cat /nsconfig/rc.netscaler”The output should look like:

The end result

Users will now be displayed with a modified logon page that looks like:Default black theme:

White theme: