为最终用户配置 Omnissa Horizon 8 Web 门户页面

**注意：**Omnissa Horizon Web Client 在 Horizon 8 版本 2412 及更高版本中可用。在 Horizon 8 版本 2406 及更低版本中，Horizon Web Client 名为“HTML Access”。本文档页面使用名称“Horizon Web Client”来表示 Horizon Web Client 和 HTML Access。

您可以将 Horizon 8 Web 门户页面配置为显示或隐藏用于下载 Omnissa Horizon Client 的图标、用于通过 Horizon Web Client 连接远程桌面的图标及其他链接。

默认情况下，Horizon 8 Web 门户页面会显示用于下载和安装 Horizon Client 的图标、通过 Horizon Web Client 进行连接的图标，以及指向 Omnissa 网站上的客户端下载页面的链接。您可以通过修改 portal-links-web-client.properties 文件中的值，从 Horizon 8 Web 门户页面中移除一个或两个图标。

有时，您可能希望 Horizon 8 Web 门户页面上的链接指向内部 Web 服务器，或者您也可能希望在自己的服务器上使用特定的客户端版本。您可以通过修改 portal-links-web-client.properties 文件的内容来重新配置 Horizon 8 Web 门户页面，使其指向其他下载 URL。如果该文件不可用或为空，并且存在 oslinks.properties 文件，则 oslinks.properties 文件将确定安装程序文件的链接值。

您可以在 portal-links-web-client.properties 文件或 oslinks.properties 文件中定义适用于特定客户端操作系统的安装程序链接。例如，如果从 macOS 系统浏览到 Horizon 8 Web 门户页面，则会显示适用于 Mac 的 Horizon Client 安装程序的链接。对于 Linux 客户端，您可以为 32 位和 64 位安装程序创建单独的链接。对于 Chrome 客户端，您可以替换 Chrome 网上应用商店中适用于 Chrome 的 Horizon Client 的链接。

步骤

1. 在 Omnissa Horizon Connection Server 主机上，使用文本编辑器打开 CommonAppDataFolder\Omnissa\Horizon\portal\portal-links-web-client.properties 目录中的 portal-links-web-client.properties 文件。

   CommonAppDataFolder 目录通常位于 C:\ProgramData 目录中。要在 Windows 资源管理器中查看 C:\ProgramData 文件夹，需使用“文件夹选项”对话框显示隐藏的文件夹。

   **注意：**如果 portal-links-web-client.properties 文件不存在，您可以使用 oslinks.properties 文件修改用于下载特定安装程序文件的 URL。请参阅此过程的下一步。

2. 编辑配置属性。

   默认情况下，将启用安装程序图标和 Horizon Web Client 图标，并提供指向 Omnissa 网站上客户端下载页面的链接。要停用某个图标（该操作会从网页中移除图标），需将其属性设置为 false。

   选项	属性设置
   禁用 Horizon Web Client	enable.webclient=false 将此选项设置为 false 可从 Horizon 8 Web 门户页面中移除 Horizon Web Client 图标。 如果此选项设置为 false，而 enable.download 选项设置为 true，用户会被转到用于下载本机 Horizon Client 安装程序的网页。 如果这两个选项均设置为 false，用户将看到以下消息："Contact your local administrator for instructions on accessing this Horizon Connection Server."
   禁止下载 Horizon Client	enable.download=false 将此选项设置为 false 可从 Horizon Web 门户页面中移除 Horizon Client 下载图标。 如果此选项设置为 false，而 enable.webclient 选项设置为 true，用户会被转到 Horizon Web Client 登录网页。 如果这两个选项均设置为 false，用户将看到以下消息："Contact your local administrator for instructions on accessing this Horizon Connection Server."
   更改用于下载 Horizon Client 的网页的 URL	link.download=https://url-of-web-server 如果您打算创建自己的网页，则可使用此属性。
   创建特定安装程序的链接	以下示例显示了完整的 URL。如果将安装程序文件放在 downloads 目录（位于 Horizon Connection Server 主机上的 C:\Program Files\Omnissa\Horizon\Server\broker\webapps\ 目录下）中，您可以使用此过程后面步骤中所述的相对 URL。 用于下载安装程序的常规链接： link.download=https://server/downloads 64 位 Windows 安装程序： link.win64=https://server/downloads/Omnissa-Horizon-Client-x86_64-build#.exe 64 位 Linux 安装程序： link.linux64=https://server/downloads/Omnissa-Horizon-Client-build#.x64.bundle macOS 安装程序： link.mac=https://server/downloads/Omnissa-Horizon-Client-build#.dmg iOS 安装程序： link.ios=https://server/downloads/Omnissa-Horizon-Client-iPhoneOS-build#.ipa Android 安装程序： link.android=https://server/downloads/Omnissa-Horizon-Client-AndroidOS-build#.apk
   更改登录页面中“帮助”链接的 URL	link.help 默认情况下，此链接指向 Omnissa 网站上托管的帮助系统。“帮助”链接显示在登录页面底部。

3. 如果 portal-links-web-client.properties 文件不存在，请使用 oslinks.properties 文件修改用于下载特定安装程序文件的 URL。

   **注意：**只能使用 oslinks.properties 文件配置指向特定安装程序文件的链接。如果在 Horizon Web Client 会话期间缺少该文件，下载链接默认将用户定向到 https://customerconnect.omnissa.com/downloads/info/slug/desktop_end_user_computing/omnissa_horizon_clients/horizon_8。

   1. 在 Horizon Connection Server 主机上，使用文本编辑器打开 <installation-directory>\Omnissa\Horizon\Server\broker\webapps\portal\WEB-INF 目录中的 oslinks.properties 文件。

   2. 配置用于下载特定安装程序文件的 URL。

      如果将安装程序文件放在 downloads 目录（位于 Horizon Connection Server 主机上的 C:\Program Files\Omnissa\Horizon\Server\broker\webapps\portal 目录内）中，您可以使用此过程后面步骤中所述的相对 URL。

      oslinks.properties 文件包含以下默认值。

      
      link.download=https://customerconnect.omnissa.com/downloads/info/slug/desktop_end_user_computing/omnissa_horizon_clients/horizon_8
      # download Links for particular platforms
      link.win64=https://customerconnect.omnissa.com/downloads/info/slug/desktop_end_user_computing/omnissa_horizon_clients/horizon_8#win64
      link.linux64=https://customerconnect.omnissa.com/downloads/info/slug/desktop_end_user_computing/omnissa_horizon_clients/horizon_8#linux64
      link.mac=https://customerconnect.omnissa.com/downloads/info/slug/desktop_end_user_computing/omnissa_horizon_clients/horizon_8#mac
      link.ios={Horizon Client for iOS installer page in the Apple Apps Store}
      link.android={Horizon Client for Android installer page in Google Play}
      

4. 要让用户从 Omnissa 网站之外的其他位置下载安装程序，请将安装程序文件放在该文件所在的 HTTP 服务器上。

   该位置必须对应于您在之前的步骤中在 portal-links-web-client.properties 文件或 oslinks.properties 文件中指定的 URL。

   例如，在版本 2412 及更高版本的部署中，要将文件放在 Horizon Connection Server 主机上的 downloads 目录中，请使用以下路径。

   C:\Program Files\Omnissa\Horizon\Server\broker\webapps\portal\downloads
   

   指向安装程序文件的链接随后可使用采用 /downloads/client-installer-file-name 格式的相对 URL。

5. 重新启动 Horizon Web 组件服务。

内容安全策略

内容安全策略 (Content Security Policy, CSP) 是一种万维网联盟 (World Wide Web Consortium, W3C) 标准，通过向合规浏览器下达策略指令，可减少各类内容注入漏洞，如跨站点脚本 (XSS)。默认情况下，将激活该标准。

可以通过编辑 portal-links-web-client.properties 停用或自定义门户响应中发送的 CSP 标头。（在 2412 之前的版本中，您可以通过编辑 locked.properties 来执行同样的操作，并且还可以在这里自定义其他组件的 CSP 标头。有关详细信息，请参阅《Horizon 安全指南》中的内容安全策略。）

Horizon 2412 及更高版本的 CSP 属性

示例 CSP 属性

您可以将 CSP 属性添加到 portal-links-web-client.properties 文件中，例如：

enableCSP = true
content-security-policy = default-src 'none';base-uri 'self';child-src 'self' blob:;connect-src 'self' wss:;font-src 'self';form-action
'none';frame-ancestors 'self';frame-src 'self' blob:;img-src 'self' data: blob:;manifest-src 'none';media-src 'self' blob:;object-src 'self'
blob:;script-src 'self' 'wasm-unsafe-eval';style-src 'self' 'unsafe-inline';worker-src 'self'