Browser content redirection
Chromium Embedded Framework (CEF) for Browser Content Redirection
In releases earlier to Version 1912, BCR used a WebkitGTK+ based overlay to render the content. However, on thin clients, there were performance issues. Starting with Version 1912, BCR uses a CEF-based overlay. This functionality enriches the user experience for BCR. It helps offload network usage, page processing, and graphics rendering to the endpoint.
Starting with Version 2106, CEF-based browser content redirection is fully functional. The feature is enabled by default.
If needed, you can replace the libffmpeg.so file provided in the Workspace app package with a suitable libffmpeg.so file that has the required codecs, in the $ICAROOT/bcr/libffmpeg.so path.
Note:
This feature isn’t supported on the ARMHF platform.
Starting with the 2402 version, the version of the Chromium Embedded Framework (CEF) is upgraded to 120. This upgraded version includes fixes for known security vulnerabilities.
Enabling CEF-based BCR
To enable CEF-based BCR:
- Navigate to the
$ICAROOT/config/All_Regions.inifile where, $ICAROOT is the default installation directory of Citrix Workspace app. -
Go to the
[Client Engine\WebPageRedirection]section and set the following entry:UseCefBrowser=True
Limitation:
- Web apps that use pop-ups might not work when BCR is used.
Known issues:
-
When you set the
UseCefBrowseroption to True in the~/.ICAClient/All_Regions.ini, the Japanese, Chinese (Simplified), and Korean IME might not work in the input fields. Citrix Workspace app for Linux does not support the Japanese, Chinese (Simplified), and Korean IME when using Secure SaaS with Citrix Embedded Browser. -
When you attempt to access a SharePoint URL using CEF-based BCR, you might receive an unknown certificate error. You can resolve this issue by verifying that the external client trusts the proxy’s SSL certificate. [CVADHELP-24141]
-
When you attempt to launch a webpage redirection using CEF-based BCR, you might receive an unknown certificate error. The issue occurs on Citrix Workspace app version 2106 and later. You can resolve this issue by ensuring that the root certificate trust for the website is imported to the linux
pkistore. For more information, see How to import self-signed certificate intonssdb?.
For information about BCR, see Browser content redirection in the Citrix Virtual Apps and Desktops documentation.
Configure path for Browser Content Redirection overlay Browser temp data storage
Starting with the Citrix Workspace app 2303 version, configure the temp data storage path for the CEF based browser. To configure the path, do the following:
- Navigate to the
$ICAROOT/config/All_Regions.inifile where,$ICAROOTis the default installation directory of Citrix Workspace app. -
Go to the
[Client Engline\WebPageRedirection]section and add the following entry:CefCachePath=<folder for CEF based BCR tmp files> <!--NeedCopy-->