Citrix Gateway

为 VPN 用户自定义用户门户

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

您可以创建在允许 VPN 用户登录之前向其提供的自定义 EULA。最终用户许可协议功能支持特定于区域设置的 EULA 版本,这些版本根据用户的 Web 浏览器报告的区域设置向用户显示。

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

重要提示:

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

应用门户主题

默认情况下,从版本 13.0 版本 67.43 开始,VPN 门户配置为使用 RFWeBUI 主题。以前,这 Caxton theme 是默认主题。你也可以应用绿色气泡和 X1 主题。

RFWebui 主题

卡克斯顿主题

![Caxton 主题] (/en-us/citrix-gateway/media/caxton-theme.png)

绿色泡泡主题

绿色泡泡主题

X1 主题

X1 主题

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

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

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

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

在命令提示窗口中,键入:

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

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

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

如果要创建 VPN 虚拟服务器,则可以在 VPN 虚拟服务器编辑 窗格中执行从步骤 3 开始的上一过程中的步骤绑定门户主题。

将门户主题绑定到 VPN 全局

使用 CLI 将门户主题绑定到 VPN 全局

在命令提示符处键入;

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

使用 GUI 将门户主题绑定到 VPN 全局

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

提示:

进行更改后,请在命令行上使用 “save ns config” 命令或单击配置实用程序中的保存图标,以确保将更改保存到 Citrix ADC 配置文件中。

创建门户主题

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

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

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

使用 CLI 创建门户主题

在命令提示符处键入;

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

使用 GUI 创建门户主题

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

您可以继续使用首次视图自定义新门户主题。

创建新主题后,您可以将其绑定到 VPN 虚拟服务器或 VPN 全局。您可以在创建后或完成自定义后立即绑定新模版。

门户主题自定义

要自定义门户主题,请使用配置实用程序中的门户主题界面。为了获得最佳结果,您必须在使用此界面之前了解它的各种元素。

关于门户主题界面

要在 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 文件系统。

  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/登录/主题/
    • 如果要自定义绿色气泡主题,请输入cp-r C Greenbubble ustom 以复制绿色气泡主题。
    • 如果要自定义默认主题 (Caxton),请键入 cp-r 默认自定义。
    • 要自定义 X1 主题,请键入cp-r X1 自定义。
  5. 对**/var/netscaler/logon/主题/自定义下复制的文件进行需要的更改** 以手动自定义主题。
    • css/base.css进行必要的编辑。
    • 将任何自定义镜像复制到 /var/ns_ns_ns_gui/vpn/媒体 目录。
    • resources/ 目录中存在的文件中的标签进行更改。这些文件对应于门户支持的区域设置。
    • 如果还需要对 HTML 页面或 JavaScript 文件进行更改,则可以使其与 /var/ns_gui_custom/ns_gui/中的文件相关。
  6. 完成所有自定义更改后,在提示符下输入: tar —cvzf /var/ns_gui_custom/customtheme.tar.gz /var/ns_gui_custom/ns_gui/*

重要

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

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

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

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

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

要使用配置实用程序设置 UITHEME 参数,请使用以下步骤。

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

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

创建 EULA

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 管理控件仅在配置实用程序中可用。

使用 CLI 创建 EULA 实体

在命令提示窗口中,键入:

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

使用 GUI 创建 EULA 实体

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

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

使用 CLI 将 EULA 绑定到 VPN 全局

在命令提示符处键入;

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

使用 GUI 将最终用户许可协议绑定到 VPN 全局

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

使用 CLI 将 EULA 绑定到 VPN 虚拟服务器

在命令提示符处键入;

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

使用 GUI 将 EULA 绑定到 VPN 虚拟服务器

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