Citrix NetScaler Gateway 11.1 and StoreFront 3.6 Customization

Datetime:2016-08-23 01:36:03          Topic:          Share

My last post on the topic Citrix NetScaler Gateway and X1 StoreFront Customization is one of my most popular posts so I decided to do an update.

The plan was to write a post on How To Customize Your Internal Web Resources including Netscaler, StoreFront, Director, Microsoft ADFS, VMware vSphere and more. But during my research there’s still so much stuff to cover for Netscaler 11.1 and StoreFront 3.6 that it needs a post for itself.

The new Netscaler Portal Theme is a really great new feature, but it still lacks some key elements that I’ll summaries at the end so the Citrix Product teams can take action.

Customize Netscaler Admin Page

Wouldn’t it be great if we could change the Netscaler admin page background? Customize your image at 2650x1600px and name it citrix_white_bg.png . Upload the image to /var/citrix_white_bg.png . Create the file /flash/nsconfig/rc.netscaler with the following details:

cp /var/citrix_white_bg.png /netscaler/ns_gui/admin_ui/rdx/core/css/citrix_white_bg.png

This will make sure that the background image is retained after reboot. I’ve decide to not change the logo on the login page simply because when all the portals look the same, how do I know where I am?

Customize Netscaler Gateway

This is straight forward with the Portal Theme Wizard. Use the same customized image as above and prepare your logo. The logo has max height of 60px and I would recommend using a transparent image which means no white background (PNG)

As you can see below, Citrix has finally fixed the font problem when using 2 factor authentication, though the button size and logo are off compared to above.

Customize StoreFront

Now after the authentication through Netscaler is completed you’ll be redirect to your internal StoreFront site. Therefore, the rest of the customization has to be done on your StoreFront Server(s). I have two Stores for my environment, one internal (StoreWeb) and one external (UGWeb). To get a consistent user experience I highly recommend you customize them both.

The customization wizard in StoreFront 3.6 has been pretty well hidden. Right click your Store and navigate to Manage Receiver for Web Sites – Configure – Customize  Appearance .

Even though the wizard says the max heigh of the logo is 120px I didn’t have any problem using 250px which make it look even better.

Repeat the process for all your Stores. When your happy with the branding you’ll need to Propagate the settings so they’re replicated to all your StoreFront Servers.

Now the problem with the wizard is that it doesn’t allow you to change the background image used when accessing the internal Store. Even worse, the logout page used through Netscaler will use the default X1 background provided by StoreFront. Luckily this is easy to fix.

Use the same customized image and save it as ReceiverFullScreenBackground_46E559C0E6B5A27B.jpg (this is JPG not PNG). Copy the image to the folder [StoreName]Web\Receiver\Images\Common on All Stores and StoreFront Servers . Be aware that this is NOT Propagated by StoreFront.

And now the logout page is correct for Netscaler Gateway as well.

Product Feeback

Both the Netscaler Portal Theme and StoreFront Customization Wizards are getting better and better, but there’s still room for improvements. Here’s my thoughts:

// Netscaler Gateway alignment problem with 2 factor authentication

// StoreFront background through wizard and propagate changes

// Make it possible to set other background for the Unified Gateway Portal

// Show Feature Apps when going through Netscaler Gateway

Get Inspired

If you want to share your custom Netscaler Gateway, please put it on Twitter and mark @xenappblog.