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 2408 version, the version of the Chromium Embedded Framework (CEF) is upgraded to 128.0.6613.120. This upgraded version includes fixes for known security vulnerabilities.

Enabling CEF-based BCR

To enable CEF-based BCR:

  1. Navigate to the $ICAROOT/config/All_Regions.ini file where, $ICAROOT is the default installation directory of Citrix Workspace app.
  2. 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 UseCefBrowser option 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 pki store. For more information, see How to import self-signed certificate into nssdb?.

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:

  1. Navigate to the $ICAROOT/config/All_Regions.ini file where, $ICAROOT is the default installation directory of Citrix Workspace app.
  2. Go to the [Client Engline\WebPageRedirection] section and add the following entry:

    CefCachePath=<folder for CEF based BCR tmp files>
    <!--NeedCopy-->
    
Browser content redirection