Citrix Gateway

自定义用户门户

为 VPN 用户提供门户服务的 Citrix Gateway 安装包括选择门户主题的选项,以便为门户页面创建自定义外观和感觉。您可以从提供的一组主题中进行选择,也可以使用主题作为模板来构建自定义或品牌门户。使用配置实用程序,您可以通过添加新徽标、背景图像、自定义输入框标签和基于 CSS 的门户设计的各种其他属性来修改主题。内置门户主题包括五种语言的内容:英语、法语、西班牙语、德语和日语。不同的用户以不同的语言提供服务,具体取决于其 Web 浏览器报告的区域设置。

您可以选择创建自定义最终用户许可协议 (EULA),该协议在允许 VPN 用户登录之前提供给他们。EULA 功能支持特定于区域设置的 EULA 版本,这些版本基于 Web 浏览器报告的区域设置提供给用户。

门户主题和 EULA 配置都可以在 VPN 虚拟服务器和 VPN 全局级别独立绑定。

重要提示: Citrix 不支持需要修改代码的自定义,也不支持解决除恢复到默认主题之外的问题。

应用门户主题

默认情况下,VPN 门户配置为使用 Caxton 主题。卡克斯顿主题名为默认值。

卡克斯顿主题

卡克斯顿主题

Citrix Gateway 包括可应用于门户的两个附加主题:绿色泡沫主题和 X1 主题。

绿泡主题

绿泡主题

X1 主题

X1 主题

您可以将提供的任何主题直接应用到 VPN 虚拟服务器或作为全局 VPN 绑定。

将门户主题绑定到 VPN 虚拟服务器

您可以在现有虚拟服务器上或创建新虚拟服务器时绑定门户主题。

使用命令行将门户主题绑定到现有 VPN 虚拟服务器

在命令提示符下,键入;

bind vpn vserver <name> - portaltheme <name>
<!--NeedCopy-->

使用配置实用程序将门户主题绑定到现有 VPN 虚拟服务器

  1. 配置选项卡上,导航到 Citrix Gateway,然后单击虚拟服务器。
  2. 选择一个虚拟服务器,然后单击 编辑
  3. 如果门户主题尚未绑定到虚拟服务器,请在详细信息窗格中的“高级设置”下单击“门户主题”。否则,“门户主题”选项已在详细信息窗格中展开。
  4. 在详细信息窗格的 门户主题下,单击 无门户主题以展开门户主题绑定窗口。
  5. 单击“单击”以选择
  6. 门户主题 窗口中,单击主题名称,然后单击 选择
  7. 单击 Bind(绑定)。
  8. 单击完成

如果您正在创建 VPN 虚拟服务器,则可以在 VPN 虚拟服务器编辑窗格中按照上述步骤从步骤 3 开始绑定门户主题。

将门户主题绑定到 VPN 全局

使用命令行将门户主题绑定到 VPN 全局范围

在命令提示符下,键入;

bind vpn global portaltheme <name>
<!--NeedCopy-->

使用配置实用程序将门户主题绑定到 VPN 全局范围

  1. 在“配置”选项卡上,导航到 Citrix Gateway。
  2. 在主详细信息窗格中,单击 Citrix Gateway 策略管理器
  3. 点击“+”图标。
  4. 在“绑定点”列表中,选择“资源”。
  5. 在“连接类型”列表中,选择“门户主题”。
  6. 单击继续
  7. 在“绑定点”屏幕中,单击“添加绑 定”。
  8. 单击“单击”以选择
  9. 门户主题 窗口中,单击主题名称,然后单击 选择
  10. 单击 Bind(绑定)。
  11. 单击关闭
  12. 点击 完成。

提示: 完成一组更改后,请使用命令行上的“save ns config”命令,或单击配置实用程序中的保存图标,以确保您的更改保存到 Citrix ADC 配置文件中。

创建门户主题

要创建自定义门户设计,请使用提供的门户主题之一作为模板。系统使用您指定的名称创建所选模板主题的副本。

使用股票门户主题作为自定义门户主题的模板

要创建门户主题,可以使用配置实用程序或命令行创建主题实体。但是,详细的自定义控件仅在配置实用程序中可用。

使用命令行创建门户主题

在命令提示符下,键入;

add portaltheme <name> basetheme <name>
<!--NeedCopy-->

使用配置实用程序创建门户主题

  1. 配置选项卡上,导航到 Citrix Gateway,然后单击门户主题
  2. 在主详细信息窗格中,单击 添加
  3. 输入主题的名称,然后从模板列表中选择一个模板,然后单 击确定
  4. 此时,您将看到门户主题编辑窗口的首次视图。点击 确定 退出。

您可以继续使用首次视图自定义新门户主题。但是,在继续编辑门户主题之前,您应该阅读以下有关界面的门户主题定制部分以及界面内自定义门户属性的弹出说明。

创建新主题后,您可以按照将门户主题绑定到 VPN 虚拟服务器或中的描述绑定它将门户主题绑定到 VPN 全局。您可以在创建后或完成自定义项后立即绑定新主题。

门户主题定制

要自定义门户主题,请使用配置实用程序中的门户主题界面。为了获得最佳效果,您应该先了解此界面的各种元素,然后再使用它。

关于门户主题界面

要在 Citrix Gateway 配置实用程序中打开门户主题界面,请在配置选项卡上,导航到 Citrix Gateway,然后单击门户主题。您可以按照“创建 门户主题”中的描述创建主题 ,也可以在主详细信息窗格中选择现有主题,然后单击“编辑”。

门户主题自定义页面包含四个用于修改门户设计的主要组件窗格:“门户主题”窗格、“外观和感觉”窗格、“高级设置”窗格和“语言”窗格。

门户主题界面

门户主题界面

页面顶部的“门户主题”窗格报告要加载的主题以及它所基于的模板主题。此处的查看选项允许您查看自定义项,而无需使用用户连接访问 VPN。使用查看选项需要将主题绑定到 VPN 虚拟服务器,并且绑定在查看窗口关闭后仍然有效。

使用页面中心的“查看和感觉”窗格,您可以配置主题的常规属性,例如标题、背景颜色和图像、字体属性和徽标。当此窗格处于编辑模式时,属性图例可用于指导门户页面上使用“外观和感觉”属性的位置。

高级设置”窗格包含各个门户页面的屏幕内容控件。要加载页面内容以进行编辑,请单击列出的页面之一。然后,页面控件将在其他中心窗格下方打开。只要页面尚未修改,页面会在“高级设置”窗格中跨门户主题编辑内容保持折叠状态。

在“语言”窗格中,可以选择从“高级设置”窗格中选择要编辑的页面时将加载哪些语言。默认情况下会加载英文页面。

可自定义页面属性的类型

自定义门户主题时,您可以在门户主题界面中修改一系列属性。除了可以编辑的文本和支持的语言外,门户布局的所有图形元素都可以根据您的需求量身定制。每个页面元素类型都有参数或建议,在修改它们之前需要考虑。

颜色

门户设计指定属性的颜色,例如页面背景、高亮、标题和正文内容的文本、按钮控件和悬停响应。要自定义颜色属性,可以直接为选定项目输入颜色值,也可以使用提供的颜色选择器生成颜色值。该界面支持以 RGBA 格式、HTML 十六进制三重格式和 X11 颜色名称输入有效的 HTML 颜色值。通过单击属性输入字段旁边的颜色框,可以访问任何适用颜色属性的颜色选择器。

拾色器

拾色器

字体

除了字体颜色外,您还可以修改某些页面属性的字体大小。对于这些属性中的每个属性,菜单提供每个属性的可用大小,具体取决于入口设计。

影像

对于图像,可用于每个控件的弹出描述提供尺寸建议和其他要求。描述根据属性在页面上的位置及其功能而有所不同。您可以使用 PNG 或 JPEG 图像文件格式。您可以选择要上传的图像,方法是选中项目文件名下方的复选框,然后浏览到图像位于本地计算机驱动器上的位置。

标签

在“高级设置”部分,您可以选择要修改的特定门户页面文本。如果您修改页面的默认英文文本,则不会重新翻译其他语言的文本。为方便起见,提供替代语言页面内容,但需要手动更新任何自定义设置。要编辑页面的其他语言版本,请先折叠窗口(如果窗口处于打开状态),方法是单击打开的门户页面的 X 图标。然后在“语言”窗格中选择 语言 ,然后单击“确定”。然后,从“高级设置”窗格打开的所有门户页面都将使用该语言,直到您选择另一个门户页面为止。

重要

在高可用性或群集部署中,门户主题只有分别在主要或配置协调器 Citrix ADC 实体上进行门户主题设置时,才会在共享配置中分发。

关于旧门户自定义的注意事项

对于使用在 11.0 之前的 Citrix Gateway 或 Access Gateway 版本中创建的手动修改的自定义门户设计的安装,Citrix 强烈建议在自定义界面中使用新的门户主题开始。如果你不能这样做,你可以手动应用自定义,但不提供直接支持。

使用手动自定义门户时,必须将自定义门户设置为全局门户配置。但这样做意味着 不能 使用 VPN 虚拟服务器级门户主题绑定覆盖应用的全局门户配置。在这种情况下,尝试使用配置实用程序或命令行创建 VPN 虚拟服务器绑定将返回错误。

此外,在高可用性和群集配置的情况下,必须在部署中的每个节点上执行任何手动自定义,因为 Citrix ADC 文件系统上的基础文件不会在自动共享的配置中分发。

手动创建自定义门户配置

要在升级到 Citrix Gateway 11.0 后手动应用较旧的自定义门户配置,您需要修改现有门户页面的副本,将自定义门户文件放入 Citrix ADC 文件系统中,然后选择“自定义”作为 UIVEM Y 参数。

您可以使用 WinSCP 或任何其他安全复制程序将文件传输到 Citrix ADC 文件系统。

  1. 登录到 Citrix Gateway 命令行。
  2. 在命令提示符下,键入 shell
  3. 在命令提示符下,键入 mkdir /var/ns_gui_custom; cd /netscaler; tar -cvzf /var/ns_gui_custom/customtheme.tar.gz ns_gui/*。
  4. 在命令提示符下,键入 cd /var/netscaler/logon/themes/
    • 如果要自定义绿泡主题,请输入 cp-r 绿泡自定义 以复制绿泡主题。
    • 如果要自定义默认主题(卡克斯顿),请键入 cp-r 默认自定义。
    • 若要自定义 X1 主题,请键入 cp-r X1 自定义。
  5. 对 **/var/netscaler/logon/themes/Custom** 下的复制的文件进行必要的更改以手动自定义主题。
    • css/base.css进行必要的编辑。
    • 将任何自定义图像复 制到 /var/ns_gui_自定义/ns_gui/vpn/媒体目 录。
    • 资源/ 目录中存在的文件中的标签进行更改。这些文件对应于门户支持的区域设置。
    • 如果还需要更改 HTML 页面或 JavaScript 文件,您可以使与 /var/ns_gui_定义/ns_ns_gui/中的文件相关。
  6. 完成所有自定义更改后,在提示符处输入: tar —cvzf /var/ns_gui_定制/自定义.tar.gz /var/ns_gui_定制/ns_gui/*

重要

在上述步骤中复制主题目录时,复制的文件夹名称必须完全按照“自定义”输入,因为目录名称在 Citrix ADC 外壳界面中区分大小写。如果目录名称未精确输入,则当 UIVEME 设置配置为 **自定义 时,无法识别** 该文件夹。

选择自定义主题作为 VPN 全局参数

手动自定义的门户配置完成并复制到 Citrix ADC 文件系统后,需要将其应用于 Citrix Gateway 配置。这可以通过将 UIVEMY 参数设置为自定义来完成,并且可以使用命令行或配置实用程序完成。

要使用命令行,请输入以下命令来设置 UIVEMY 参数。

set vpn parameter UITHEME CUSTOM
<!--NeedCopy-->

要使用配置实用程序设置 UIVEME 参数,请使用以下过程。

  1. 配置选项卡上,导航到 Citrix Gateway > 全局设置
  2. 点击 更改全局设置
  3. 单击 客户体验 选项卡。
  4. 滚动到屏幕底部,然后从 **UI 主题 列表菜单中选择自定义** 。
  5. 单击确定

您的手动自定义门户现在是向 VPN 用户提供的门户设计。

创建最终用户许可协议

VPN 门户系统提供了将最终用户许可协议 (EULA) 应用于门户配置的选项。一旦 EULA 绑定到 Citrix Gateway 配置(无论是在 VPN 全局范围内还是绑定到相关 VPN 虚拟服务器),VPN 用户必须同意 EULA 作为条款和条件,然后才能允许他们对 VPN 进行身份验证。

与门户主题一样,根据 Web 浏览器报告的区域设置,为用户提供特定语言的 EULA 服务。如果区域设置与任何支持的语言不匹配,则默认提供的语言为英语。对于每个 EULA,您可以使用每种支持的语言输入自定义消息。预翻译的内容不适用于 EULA 配置,因为它是针对门户主题的。如果用户报告的区域设置与未输入 EULA 内容的语言匹配,则当用户单击 VPN 登录页面上的“条款和条件”链接时,将返回一个空白页面。

要创建 EULA,可以在 Citrix Gateway > 全局设置 > EULACitrix Gateway > 资源 > EULA配置选项卡上使用配置实用程序中的任一控件。“全局设置”窗格中的控件用于管理 VPN 全局 EULA 绑定,而“资源”>“EULA”节点上的控件用于对 EULA 配置进行常规操作。您可以通过在 Citrix Gateway > 虚拟服务器上编辑 VPN 虚拟服务器来管理 VPN 虚拟服务器 EULA 绑定。某些命令还可以随命令行一起使用,用于管理 EULA 实体。但是,完整的 EULA 管理控件仅在配置实用程序中可用。

使用命令行创建 EULA 实体

在命令提示符下,键入;

add vpn eula <name>
<!--NeedCopy-->

使用配置实用程序创建 EULA 实体

  1. 导航到 Citrix Gateway > 资源 > EULA
  2. 单击“添加”以创建实体。
  3. 输入实体的名称。
  4. 对于每种语言,粘贴相关选项卡下的内容。您可以使用纯文本或 HTML 标签来设置内容的格式,包括用于添加换行符的标 <br> 签。
  5. 单击创建

创建 EULA 实体后,可以全局绑定到 VPN 配置,也可以绑定到 VPN 虚拟服务器。

使用命令行将 EULA 绑定到 VPN 全局

在命令提示符下,键入;

bind vpn global eula <name>
<!--NeedCopy-->

使用配置实用程序进行全局 EULA VPN 绑定

  1. 配置选项卡上,导航到 Citrix Gateway > 全局设置
  2. 在主详细信息窗格中,单击 配置最终用户许可协议
  3. 单击添加绑定
  4. 单击“单击”以选择
  5. 选择一个 EULA 实体,然后单击 选择
  6. 单击 Bind(绑定)。
  7. 单击关闭

使用命令行将 EULA 绑定到 VPN 虚拟服务器

在命令提示符下,键入;

bind vpn vserver <name> eula <name>
<!--NeedCopy-->

使用配置实用程序将 EULA 绑定到 VPN 虚拟服务器

  1. 配置选项卡上,浏览至 Citrix Gateway > 虚拟服务器。
  2. 在主详细信息窗格中,选择 VPN 虚拟服务器,然后单击 编辑
  3. 从页面右侧的“高级设置”窗格中,单击 EULA
  4. 在新添加的 EULA 窗格中,单击 无 EULA
  5. 单击“单击”以选择
  6. 选择一个 EULA 实体,然后单击 选择
  7. 单击 Bind(绑定)。
  8. 单击完成