Customize the user portal for VPN users
Citrix Gateway installations that serve the portal to VPN users include an option to select a portal theme to create a customized look and feel for the portal pages. You can select from a supplied set of themes, or you can use a theme as a template to build a customized or branded portal. Using the configuration utility, you can modify a theme by adding new logos, background images, custom input box labels, and various other attributes of the CSS based portal design. The built-in portal themes include content for five languages: English, French, Spanish, German, and Japanese. Different users are served in different languages, depending on the locales reported by their web browsers.
You can create a custom EULA that is presented to VPN users before they are allowed to sign in. The EULA feature supports locale-specific versions of a EULA, which are presented to users based on their web browsers reported locales.
Both portal themes and EULA configurations can be bound independently at the VPN virtual server and VPN global levels.
Important:
Citrix does not support customization that requires code modifications and does not offer support to resolve issues beyond reverting to a default theme.
Apply a portal theme
Starting from release 13.0 build 67.43, the VPN portal is configured to use the RfWebUI theme, by default. Previously, theCaxton theme
was the default theme. You can also apply the Green bubble and X1 themes.
Caxton theme
Green bubble theme
X1 theme
You can apply any of the supplied themes directly to a VPN virtual server or as a global VPN binding.
Bind a portal theme to a VPN virtual server
You can bind a portal theme on an existing virtual server or when creating a new virtual server.
Bind a portal theme to a VPN virtual server by using the CLI
At the command prompt, type;
bind vpn vserver - portaltheme
Bind a portal theme to a VPN virtual server by using the GUI
- On theConfigurationtab, Navigate toCitrix Gatewayand clickVirtual Servers.
- Select a virtual server, and then clickEdit.
- If a portal theme has not yet been bound to the virtual server, clickPortal ThemeunderAdvanced Settingsin the details pane. Otherwise, thePortal Themeoption is already expanded in the details pane.
- In the details pane, underPortal Themes, clickNo Portal Themeto expand the Portal Theme binding window.
Click
Click to select.- In thePortal Themeswindow, click a theme name, and then clickSelect.
- ClickBind.
- ClickDone.
If you are creating a VPN virtual server, you can follow the steps in the previous procedure starting with step 3 while in theVPN virtual server editpane to bind a Portal Theme.
Bind a portal theme to VPN global
Bind a portal theme to VPN global by using the CLI
At the command prompt, type;
bind vpn global portaltheme
Bind a portal theme to VPN global by using the GUI
- On theConfigurationtab, Navigate toCitrix Gateway.
- In the main details pane, clickCitrix Gateway Policy Manager.
- Click the ‘+’ icon.
- In theBind Pointlist, selectResources.
- In theConnection Typelist, selectPortal Theme.
- ClickContinue.
- In theBind Pointscreen, clickAdd Binding.
- ClickClick to select.
- In thePortal Themeswindow, click a theme name, and then clickSelect.
- ClickBind.
- ClickClose.
- ClickDone.
Tip:
After making the changes, use the ‘save ns config’ command on the command line or click the save icon in the configuration utility to ensure your changes are saved to the Citrix ADC configuration file.
Create a portal theme
To create a custom portal design, you use one of the supplied portal themes as a template. The system makes a copy of the selected template theme with a name that you specify.
Use a stock portal theme as a template for a custom portal theme
To create a Portal Theme, you can use the configuration utility or the command line to create the theme entity. However, the detailed customization controls are available only within the configuration utility.
Create a portal theme by using the CLI
At the command prompt, type;
add portaltheme basetheme
Create a portal theme by using the GUI
- On theConfigurationtab, Navigate toCitrix Gatewayand clickPortal Themes.
- In the main details pane, clickAdd.
- Enter a name for the theme and select a template from the template list, and then clickOK.
- At this point, you are presented with the first-time view of the portal theme editing window. ClickOKto exit.
You can proceed to customize the new portal theme with the first-time view.
Once a new theme is created, you can bind it to a VPN virtual server or to VPN global. You can bind a new theme immediately after creation or after completing your customizations.
Portal theme customization
To customize a Portal Theme, use the Portal Theme interface in the configuration utility. To get the best results, you must understand the various elements of this interface before you use it.
About the portal theme interface
To open thePortal Theme interfacein the Citrix Gateway configuration utility, on theConfigurationtab, Navigate toCitrix Gatewayand clickPortal Themes. You can either create a theme as described inCreating a Portal Themeor select an existing theme in the main details pane and clickEdit.
The portal theme customization page has four primary component panes for modifying a portal design: thePortal Themepane, the Look & Feel pane, theAdvanced Settingspane, and theLanguagepane.
ThePortal Themepane at the top of the page reports what theme is loaded for editing and what template theme it is based on. The viewing option here allows you to view your customizations without accessing the VPN with a user connection. Using the viewing option requires binding the theme to a VPN virtual server and the binding remains in effect after the viewing window is closed.
With theLook & Feelpane in the center of the page, you configure a theme’s general properties, such as headers, background colors and images, font properties, and logos. When this pane is in edit mode, attribute legends are available for guidance on where the Look & Feel attributes are used on portal pages.
TheAdvanced Settingspane contains the onscreen content controls for the individual portal pages. To load a page’s content for editing, click one of the pages listed. The page controls then open below the other center panes. A page remains collapsed in theAdvanced Settingspane across Portal Theme edits as long as the page has not been modified.
In theLanguagepane, you can select which of the languages is loaded when a page is selected for edit from theAdvanced Settingspane. The English language pages are loaded by default.
Types of customizable page attributes
When customizing a Portal Theme, you can modify a range of attributes in the Portal Theme interface. Along with the text and the supported languages that can be edited, the graphical elements of the portal’s layout can be tailored to suit your needs. Each of the page element types has parameters or recommendations to consider before modifying them.
Colors
The portal design specifies the colors for attributes such as page backgrounds, highlights, text for titles and body content, button controls, and hover responses. To customize a color attribute, you can enter a color value directly for a selected item, or you can use the supplied color picker to generate a color value. The interface supports entering valid HTML color values in RGBA format, HTML hexadecimal triplet format, and X11 color names. The color picker can be accessed for any applicable color attribute by clicking the color box next to the attribute’s input field.
Fonts
Along with font colors, you can modify font sizes for some page attributes. For each of these attributes, a menu offers the sizes available for each attribute, as determined by the portal’s design.
Images
For images, a pop-up description available for each control provides size recommendations and other requirements. The descriptions vary according to an attribute’s location on the page and its function. You can use PNG or JPEG image file formats. You can select an image to upload by selecting the check box beneath an item’s file name and then browsing to where the image resides on your local computer’s drive.
Labels
In theAdvanced Settingssection, you can select a specific portal page’s text to modify. If you modify the default English text for a page, the text for other languages is not retranslated. The alternative language page content is provided as a convenience but requires manual updates for any customizations. To edit another language version for a page, first collapse the window, if it is open, by clicking theXicon for the open portal page. Then select the language in theLanguagepane and clickOK. All the portal pages opened from theAdvanced Settingspane is in that language until you select a different one.
Important
In high availability or clustered deployments, Portal Themes are distributed across the shared configuration only when Portal Theme settings are made on the primary or configuration coordinator Citrix ADC entities respectively.
Older portal customizations
For installations with manually modified custom portal design created in Citrix Gateway or Access Gateway releases earlier than 11.0, Citrix strongly recommends starting with a new portal theme in the customization interface. If you can’t do that, you can apply a customization manually, but direct support for that is not provided.
When using a manually customized portal, you must set the customized portal as a global portal configuration. Doing so though means that an applied global portal configurationcannotbe overridden with VPN virtual server level portal theme bindings. Attempting to create a VPN virtual server binding in this case with the configuration utility or the command line returns an error.
同时,对于高可用性和集群configurations, any manual customizations must be performed on every node in the deployment as the underlying files on the Citrix ADC file system are not distributed in the automatically shared configuration.
Create a custom portal configuration manually
To manually apply an older customized portal configuration after upgrading to Citrix Gateway 11.0, you need to modify a copy of an existing portal page, put the customized portal files into the Citrix ADC file system, and selectCUSTOMas theUITHEMEparameter.
You can use WinSCP or any other secure copy program to transfer files to the Citrix ADC file system.
- Log on to the Citrix Gateway command line.
- At the command prompt, typeshell
- At the command prompt, typemkdir /var/ns_gui_custom; cd /netscaler; tar -cvzf /var/ns_gui_custom/customtheme.tar.gz ns_gui/*.
- At command prompt, typecd /var/netscaler/logon/themes/
- If you want to customize the Green bubble theme, entercp -r
Greenbubble
Customto make a copy of the Green bubble theme. - If you want to customize the Default theme (
Caxton
), typecp -r Default Custom. - To customize the X1 theme, typecp -r X1 Custom.
- If you want to customize the Green bubble theme, entercp -r
- Make the needed changes to the copied files under/var/netscaler/logon/themes/Customto customize the theme manually.
- Make the necessary edits tocss/base.css.
- Copy any custom images to the/var/ns_gui_custom/ns_gui/vpn/mediadirectory.
- Make changes to labels in the files present in theresources/directory. These files correspond to the portal supported locales.
- If changes to HTML pages or javascript files are also needed, you can make the relevant to the files in/var/ns_gui_custom/ns_gui/.
- After all customization changes are complete, at the prompt enter:tar –cvzf /var/ns_gui_custom/customtheme.tar.gz /var/ns_gui_custom/ns_gui/*
Important
When copying a theme directory in the preceding steps, the copied folder name must be entered exactly as ‘Custom’ since directory names are case-sensitive within the Citrix ADC shell interface. If the directory name is not entered precisely, the folder is not recognized when theUITHEMEsetting is configured toCUSTOM.
Select the customized theme as a VPN global parameter
Once the manually customized portal configuration is complete and copied to the Citrix ADC file system, it needs to be applied to the Citrix Gateway configuration. This is done by setting the UITHEME parameter to CUSTOM and can be completed with the command line or the configuration utility.
使用命令行,输入以下逗号nd to set theUITHEMEparameter.
set vpn parameter UITHEME CUSTOM
To set the UITHEME parameter using the configuration utility, use the following procedure.
- On theConfigurationtab, Navigate toCitrix Gateway > Global Settings.
- ClickChange Global Settings.
- Click theClient Experiencetab.
- Scroll to the bottom of the screen then selectCUSTOMfrom theUI Themelist menu.
- ClickOK.
Your manually customized portal is now the portal design presented to VPN users.
Create an EULA
The VPN portal system provides the option to apply an EULA to a portal configuration. Once a EULA is bound to the Citrix Gateway configuration, either at the VPN global scope or to a relevant VPN virtual server, VPN users must agree to the EULA as Terms and Conditions before they are allowed to authenticate into the VPN.
与门户主题,用户一郎uage specific EULA based on the locale reported by their web browser. In cases of a locale that doesn’t match to any of the supported languages, the default language served is English. For each EULA, you can enter a custom message in each of the supported languages. Pre-translated content is not provided for EULA configurations as it is for the portal themes. If a user’s reported locale matches for a language where no EULA content is entered, the user is returned a blank page when they click the “Terms & Conditions” link in on the VPN login page.
To create a EULA, you can use either of the controls in the configuration utility on theConfigurationtab atCitrix Gateway > Global Settings > EULAorCitrix Gateway > Resources > EULA. The controls in theGlobal Settingspane are used to manage VPN global EULA bindings while the control on theResources > EULAnode is for general operations on EULA configurations. You can manage VPN virtual server EULA bindings by editing a VPN virtual server atCitrix Gateway > Virtual Servers. Some commands are also available with the command line for managing EULA entities. However, the full EULA management controls are available only in the configuration utility.
Create a EULA entity by using the CLI
At the command prompt, type;
add vpn eula
Create a EULA entity by using the GUI
- Navigate toCitrix Gateway > Resources > EULA.
- ClickAddto create an entity.
- Enter a name for the entity.
- For each of the languages, paste in the content under the relevant tabs. You can use plain text or HTML tags to format the content, including a
tag to add line breaks. - ClickCreate.
Once a EULA entity has been created, it can be globally bound to the VPN configuration, or can be bound to a VPN virtual server.
Bind a EULA to VPN global by using the CLI
At the command prompt, type;
bind vpn global eula
Bind a EULA to VPN global by using the GUI
- On theConfigurationtab, Navigate toCitrix Gateway > Global Settings.
- In the main details pane, clickConfigure an End User License Agreement.
- ClickAdd Binding.
- ClickClick to select.
- Select a EULA entity then clickSelect.
- ClickBind.
- ClickClose.
Bind a EULA to a VPN virtual server by using the CLI
At the command prompt, type;
bind vpn vserver eula
Bind a EULA to a VPN virtual server by using the GUI
- At theConfigurationtab browse toCitrix Gateway > Virtual Servers.
- In the main details pane, select a VPN virtual server and clickEdit.
- From theAdvanced Settingspane on the right side of the page, clickEULA.
- In the newly added EULA pane, clickNo EULA.
Click
Click to select.- Select a EULA entity and clickSelect.
- ClickBind.
- ClickDone.