自定义用户门户
为 VPN 用户提供门户服务的 Citrix Gateway 安装包括一个选项，用于选择门户主题以创建门户页面的自定义外观。您可以从提供的一组主题中进行选择，也可以使用模板作为模板来构建自定义或品牌门户。使用配置实用程序，您可以通过添加新徽标、背景图像、自定义输入框标签以及基于 CSS 的门户设计的各种其他属性来修改主题。内置门户主题包括五种语言的内容：英语、法语、西班牙语、德语和日语。不同的用户以不同的语言提供服务，具体取决于他们的 Web 浏览器报告的区域设置。
您可以选择创建自定义的最终用户许可协议 (EULA)，该协议在允许 VPN 用户登录之前提供给他们。最终用户许可协议功能支持特定于区域设置的 EULA 版本，这些版本根据用户的 Web 浏览器报告的区域设置向用户显示。
门户主题和 EULA 配置都可以在 VPN 虚拟服务器和 VPN 全局级别独立绑定。
重要： Citrix 不支持需要修改代码的自定义，也不支持解决除恢复为默认主题之外的问题。
应用门户主题
默认情况下，VPN 门户配置为使用 Caxton 主题。Caxton 主题被命名为默认。
Caxton 主题
Citrix Gateway 还包括两个可以应用于门户的主题：Greenbubble 和 X1 主题。
Greenbubble 主题
X1 主题
您可以将提供的任何主题直接应用于 VPN 虚拟服务器或作为全局 VPN 绑定。
将门户主题绑定到 VPN 虚拟服务器
您可以在现有虚拟服务器上或在创建新的虚拟服务器时绑定门户主题。
使用命令行将门户主题绑定到现有 VPN 虚拟服务器
在命令提示符下，键入：
bind vpn vserver <name> -portaltheme <name>
<!--NeedCopy-->
使用配置实用程序将门户主题绑定到现有 VPN 虚拟服务器
- 在 配置 选项卡上，导航到 Citrix Gateway ，然后单击 虚拟服务器。
- 选择虚拟服务器，然后单击 编辑。
- 如果门户主题尚未绑定到虚拟服务器，请单击详细信息窗格中 高级设置 下的 门户主题 。否则， 门户主题选项已在详细信息窗格中展开。
- 在详细信息窗格中的 门户主题下，单击 无门户主题以展开门户主题绑定窗口。
- 单击 单击以选择。
- 在“门户主题”窗口中，单击主题名称，然后单击“选择”。
- 单击绑定。
- 单击 Done（完成）。
如果您正在创建 VPN 虚拟服务器，则可以在 VPN 虚拟服务器编辑窗格中按照上述步骤从步骤 3 开始绑定门户主题。
将门户主题绑定到 VPN Global
使用命令行将门户主题绑定到 VPN 全球范围
在命令提示符下，键入：
bind vpn global portaltheme <name>
<!--NeedCopy-->
使用配置实用程序将门户主题绑定到 VPN 全局范围
- 在“配置”选项卡上，导航到 Citrix Gateway。
- 在主详细信息窗格中，单击 Citrix Gateway 策略管理器。
- 单击“+”图标。
- 在 绑定点 列表中，选择 资源。
- 在“连接类型”列表中，选择“门户主题”。
- 单击继续。
- 在 绑定点屏幕中，单击 添加绑定。
- 单击 单击以选择。
- 在“门户主题”窗口中，单击主题名称，然后单击“选择”。
- 单击绑定。
- 单击关闭。
- 单击“完成”。
提示： 完成一组更改后，使用命令行上的“保存 ns 配置”命令或单击配置实用程序中的保存图标，以确保所做的更改保存到 Citrix ADC 配置文件中。
创建门户主题
要创建自定义门户设计，请使用提供的门户主题之一作为模板。系统使用您指定的名称创建所选模板主题的副本。
使用常用门户主题作为自定义门户主题的模板
要创建门户主题，可以使用配置实用程序或命令行创建主题实体。但是，详细的自定义控件仅在配置实用程序中可用。
使用命令行创建门户主题
在命令提示符下，键入：
add portaltheme <name> basetheme <name>
<!--NeedCopy-->
使用配置实用程序创建门户主题
- 在 配置 选项卡上，导航到 Citrix Gateway ，然后单击 门户主题。
- 在主详细信息窗格中，单击 添加。
- 输入主题的名称并从“模板”菜单中选择一个模板，然后单击“**确定”。
- 此时，您将看到门户主题编辑窗口的首次视图。单击确定以退出。
您可以继续使用首次视图自定义新门户主题。但是，在继续编辑 门户主题之前，您应该阅读以下有关界面的门户主题自定义 部分，以及界面中可自定义门户属性的弹出式描述。
创建新主题后，您可以按照将门户主题绑定到 VPN 虚拟服务器或将门户主题绑定到 VPN Global 中所述将其绑定。您可以在创建后或完成自定义后立即绑定新模版。
门户主题自定义
要自定义门户主题，请使用配置实用程序中的门户主题界面。为了获得最佳结果，您应该在使用这个界面之前了解它的各种元素。
关于门户主题界面
要在 Citrix Gateway 配置实用程序中打开门户主题界面，请在 配置 选项卡上导航到 Citrix Gateway 并单击 门户主题。您可以按照创建 门户主题中的描述创建主题， 也可以在主详细信息窗格中选择现有主题并单击 编辑。
门户主题自定义页面有四个用于修改门户设计的主要组件窗格：门户主题窗格、外观窗格、高级设置窗格和语言窗格。
门户主题界面
页面顶部的“门户主题”窗格会报告加载哪个主题进行编辑以及它所基于的模板主题。此处的查看选项允许您查看自定义设置，而无需通过用户连接访问 VPN。使用查看选项需要将主题绑定到 VPN 虚拟服务器，并且绑定在查看窗口关闭后仍然有效。
在页面中央的“外观和感觉”窗格中，您可以配置主题的常规属性，例如标题、背景颜色和图像、字体属性和徽标。当此窗格处于编辑模式时，属性图例可用于指导门户页面上使用“外观和感觉”属性的位置。
“高级设置”窗格包含各个门户页面的屏幕内容控件。要加载页面内容进行编辑，请单击列出的其中一个页面。然后，页面控件会在其他中心窗格的下方打开。只要尚未修改页面，在对 Portal Theme 进行编辑的 高级设置 窗格中，页面就会保持折叠状态。
在“语言”窗格中，您可以选择从“高级设置”窗格中选择要编辑的页面时将加载哪些语言。默认情况下会加载英语页面。
可自定义页面属性的类型
自定义门户主题时，可以在门户主题界面中修改一系列属性。除了可以编辑的文本和支持的语言外，门户布局的所有图形元素都可以根据您的需求进行自定义。每个页面元素类型都有参数或建议，在修改它们之前需要考虑。
颜色
门户设计指定属性的颜色，例如页面背景、突出显示、标题和正文内容的文本、按钮控件和悬停响应。要自定义颜色属性，可以直接为选定项目输入颜色值，也可以使用提供的拾色器生成颜色值。该界面支持以 RGBA 格式、HTML 十六进制三重格式和 X11 颜色名称输入有效的 HTML 颜色值。通过单击属性输入字段旁边的颜色框，可以访问任何适用的颜色属性的颜色选择器。
颜色选择器
字体
除了字体颜色之外，您还可以修改某些页面属性的字体大小。对于每个属性，列表菜单提供了每个属性的可用大小，具体取决于门户的设计。
图像
对于图像，每个控件的弹出式描述提供了尺寸建议和其他要求。描述根据属性在页面上的位置及其功能而有所不同。您可以使用 PNG 或 JPEG 图像文件格式。您可以选择要上载的图像，方法是选中项目文件名下方的复选框，然后浏览到图像在本地计算机驱动器上的驻留位置。
標籤
在“高级设置”部分中，您可以选择要修改的特定门户页面的文本。如果修改页面的默认英文文本，则不会重新翻译其他语言的文本。提供替代语言页面内容是为了方便起见，但需要手动更新任何自定义项。要编辑页面的其他语言版本，请首先通过单击打开的门户页面的 X 图标来折叠窗口（如果窗口处于打开状态）。然后在“语言”窗格中选择 语言 ，然后单击“确定”。然后，从“高级设置”窗格打开的所有门户页面都将使用该语言，直到您选择其他语言为止。
重要
在高可用性或群集部署中，仅当分别在主协调器或配置协调器 Citrix ADC 实体上进行门户主题设置时，门户主题才会在共享配置中分布。
关于旧版门户自定义的注意事项
对于在 Citrix Gateway 或 Access Gateway 11.0 之前的版本中创建的具有手动修改的自定义门户设计的安装，Citrix 强烈建议从自定义界面中的新门户主题开始。如果无法执行此操作，则可以手动应用自定义项，但不提供直接支持。
使用手动自定义门户时，必须将自定义门户设置为全局门户配置。但是，这样做意味着应用的全局门户配置 不能 被 VPN 虚拟服务器级门户主题绑定覆盖。在这种情况下，尝试使用配置实用程序或命令行创建 VPN 虚拟服务器绑定会返回错误。
此外，在高可用性和群集配置的情况下，必须在部署中的每个节点上执行任何手动自定义，因为 Citrix ADC 文件系统上的基础文件不会在自动共享配置中分发。
手动创建自定义门户配置
要在升级到 Citrix Gateway 11.0 后手动应用较旧的自定义门户配置，您需要修改现有门户页面的副本，将自定义门户文件放入 Citrix ADC 文件系统中，然后选择 自定义 作为 UITHEME 参数。
您可以使用 WinSCP 或任何其他安全复制程序将文件传输到 Citrix ADC 文件系统。
- 登录 Citrix Gateway 命令行。
- 在命令提示符处，键入shell
- 在命令提示符处，键入 mkdir /var/ns_gui_custom; cd /netscaler; tar-cvzf /var/ns_gui_custom/customtheme.tar.gz ns_gui/*。
- 在命令提示符处，键入 cd /var/netscaler/登录/主题/
- 如果您想自定义 Greenbubble 主题，请输入 cp-r Greenbubble Custom 来复制 Greenbubble 主题。
- 如果要自定义默认主题 (Caxton)，请键入 cp -r Default Custom。
- 要自定义 X1 主题，请键入cp-r X1 自定义。
- 在 /var/netscaler/logon/themes/Custom 下对复制的文件进行必要的更改，以手动自定义主题。
- 对 css/base.css进行必要的编辑。
- 将任何自定义镜像复制到 /var/ns_ns_ns_gui/vpn/媒体 目录。
- 对 resources/ 目录中存在的文件中的标签进行更改。这些文件对应于门户支持的区域设置。
- 如果还需要对 HTML 页面或 JavaScript 文件进行更改，则可以使其与 /var/ns_gui_custom/ns_gui/中的文件相关。
- 完成所有自定义更改后，在提示符下输入： tar —cvzf /var/ns_gui_custom/customtheme.tar.gz /var/ns_gui_custom/ns_gui/*
重要
在上述步骤中复制主题目录时，必须完全按照“自定义”输入复制的文件夹名称，因为目录名称在 Citrix ADC shell 界面中区分大小写。如果未精确输入目录名称，则当 UITHEME 设置配置为 CUSTOM 时，将无法识别该文件夹。
选择自定义主题作为 VPN 全局参数
手动自定义的门户配置完成并复制到 Citrix ADC 文件系统后，需要将其应用于 Citrix Gateway 配置。这可以通过将 UITHEME 参数设置为 CUSTOM 来完成，可以使用命令行或配置实用程序来完成。
要使用命令行，请输入以下命令来设置 UITHEME 参数。
set vpn parameter UITHEME CUSTOM
<!--NeedCopy-->
要使用配置实用程序设置 UITHEME 参数，请使用以下步骤。
- 在配置选项卡上，导航到 Citrix Gateway > 全局设置。
- 单击“更改全局设置”。
- 单击“客户端体验”选项卡。
- 滚动到屏幕底部，然后从“用户界面主题”列表中选择“**自定义”。
- 单击确定。
您的手动自定义门户现在是提供给 VPN 用户的门户设计。
创建最终用户许可协议
VPN 门户系统提供了将最终用户许可协议 (EULA) 应用于门户配置的选项。将 EULA 绑定到 Citrix Gateway 配置后，无论是在 VPN 全局范围内还是在相关的 VPN 虚拟服务器上，VPN 用户必须同意 EULA 作为条款和条件，然后才能在 VPN 中进行身份验证。
与门户主题一样，根据用户的 Web 浏览器报告的区域设置，为用户提供特定语言的最终用户许可协议。如果语言环境与任何受支持的语言都不匹配，则默认提供的语言为英语。对于每个 EULA，您可以使用每种支持的语言输入自定义消息。EULA 配置不提供预翻译的内容，因为它是针对门户主题的内容。如果用户报告的区域设置与未输入 EULA 内容的语言匹配，则当用户单击 VPN 登录页面上的“条款和条件”链接时，将返回空白页。
要创建最终用户许可协议，您可以使用配置实用程序中的任一控件，位于 Citrix Gateway > 全局设置 > EULA 或 Citrix Gateway **资源 > 最终用户 许可协议的配置选项卡上。“全局设置”窗格中的控件用于管理 VPN 全局 EULA 绑定，而“资源”>“EULA”节点上的控件用于对 EULA 配置进行常规操作。您可以通过在Citrix Gateway > 虚拟服务器上编辑 VPN 虚拟服务器来管理 VPN 虚拟服务器**EULA 绑定。一些命令也可用于管理 EULA 实体的命令行。但是，完整的 EULA 管理控件仅在配置实用程序中可用。
使用命令行创建 EULA 实体
在命令提示符下，键入：
add vpn eula <name>
<!--NeedCopy-->
使用配置实用程序创建 EULA 实体
- 导航到 Citrix Gateway > 资源 > 最终用户许可协议。
- 单击 添加 以创建实体。
- 输入实体的名称。
- 对于每种语言，粘贴相关选项卡下的内容。您可以使用纯文本或 HTML 标记来设置内容的格式，包括添加换行符的
<br>标记。 - 单击创建。
创建 EULA 实体后，它可以全局绑定到 VPN 配置，也可以绑定到 VPN 虚拟服务器。
使用命令行将 EULA 绑定到 VPN Global
在命令提示符下，键入：
bind vpn global eula <name>
<!--NeedCopy-->
使用配置实用程序进行全局 EULA VPN 绑定
- 在配置选项卡上，导航到 Citrix Gateway > 全局设置。
- 在主详细信息窗格中，单击 配置最终用户许可协议。
- 单击 Add Binding（添加绑定）。
- 单击 单击以选择。
- 选择一个 EULA 实体，然后单击 选择。
- 单击绑定。
- 单击关闭。
使用命令行将 EULA 绑定到 VPN 虚拟服务器
在命令提示符下，键入：
bind vpn vserver <name> eula <name>
<!--NeedCopy-->
使用配置实用程序将 EULA 绑定到 VPN 虚拟服务器
- 在“配置”选项卡上，浏览至 Citrix Gateway > 虚拟服务器。
- 在主详细信息窗格中，选择一个 VPN 虚拟服务器，然后单击 编辑。
- 在页面右侧的“高级设置”窗格中，单击 EULA。
- 在新添加的最终用户许可协议窗格中，单击 No EULA。
- 单击 单击以选择。
- 选择一个 EULA 实体，然后单击 选择。
- 单击绑定。
- 单击 Done（完成）。