為使用者設定 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。如果您將安裝程式檔案放置在 Horizon Connection Server 主機上 C:\Program Files\Omnissa\Horizon\Server\broker\webapps\ 目錄下的 downloads 子目錄中，即可如本程序後續步驟所述，使用相對 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。

      如果您將安裝程式檔案放置在 Horizon Connection Server 主機上 C:\Program Files\Omnissa\Horizon\Server\broker\webapps\portal 內的 downloads 目錄中，即可如本程序下一個步驟所述，使用相對 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
   

   安裝程式檔案的連結即可使用相對 URL，格式為 /downloads/client-installer-file-name。

5. 重新啟動 Horizon Web 元件服務。

內容安全性原則

內容安全性原則 (CSP) 是由全球資訊網協會 (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'