Browser Content Redirection (BCR) enhances the user experience of web browsing within Citrix Virtual Apps and Desktops environments. By offloading the rendering of web pages to the user’s local machine, BCR reduces server load and improves performance, especially for complex or resource-intensive websites.
How it worksBCR utilizes the Citrix Workspace app to create a secure browsing environment on the user’s device. When a user accesses an allowed web page, the viewport of the browser window is redirected to the client. The client side browser engine then leverages the local machine’s resources to render the page, resulting in faster loading times and smoother interaction.
Note that only the browser viewport is redirected. The viewport is the rectangular area in your browser where the content is displayed. The viewport doesn’t include things like the Address Bar, Favorites Toolbar, or Status Bar. Those items are in the user interface, which is still running on the browser in the VDA.
What’s New Browser Profile Sharing in Browser Content Redirection (Tech Preview)BCR now offers a streamlined user experience with the new Profile Sharing feature, enabling VDA-side authentication and cookie sharing. This enhancement eliminates redundant logins, boosting productivity by maintaining authentication and cookie persistence across BCR sessions, even after the BCR window is closed. This seamless experience further enhances security by ensuring authentication originates from the VDA, not the client.
Example:
Previous Experience: Previously, opening an authenticated page within BCR required users to re-enter their credentials each time, breaking SSO persistence. SSO was only maintained while the BCR window remained open. Closing and reopening the window forced users to repeat the login process.
New Experience: With Profile Sharing, users are no longer prompted for credentials. SSO is seamlessly preserved from the VDA browser, providing a significantly improved and uninterrupted experience.
Requirements for Tech PreviewNote:
The feature is not limited by a specific provider. Hence, it can work with other providers as well (Microsoft authentication, PingID etc.,). However, current validation is done for the providers specified above.
Before the introduction of this feature, Browser content redirection authentication sites policy was used to specify the URLs used for authentication by the website. By configuring authentication sites, the administrator is allowing the authentication (or) intermediary login pages to be redirected to the client. With the introduction of Profile sharing, BCR will leverage the authentication cookies on the VDA side browser and hence, the URLs in authentication sites policy now need to be configured in the Browser content redirection block list policy instead. This ensures that the authentication happens through the VDA.
Example 1:
Here’s an example with github.com. This method can be used for any website that you want to redirect with BCR and ensure that you have the the right configuration
Other non-login pages will go into the Browser Content redirection ACL policy
Example 2:
Here’s an example with meet.google.com and Okta. In this case, we’ve followed the previous example to figure out the URLs and then used wildcards to eliminate redundant configuration
Browser content redirection intelligently manages the web traffic, delivering a superior experience for your users while reducing strain on your infrastructure.
Here’s how they can benefit your organization:
Cost Savings: Offload resource-intensive web pages to user devices, freeing up valuable server resources and reducing bandwidth consumption. This translates to lower hardware and network costs.
Enhanced User Experience: Provide your users with a smoother, more responsive browsing experience, even with graphics-intensive websites. Deliver native-like performance, eliminating lag and improving productivity.
Improved Security: Maintain a secure environment while allowing access to both internal and external resources.
Increased Flexibility: Support a wide range of use cases, from basic web browsing to complex web applications that require proxy traversal or SSO authentication. Easily manage redirection settings with granular policy controls in Citrix Web Studio
Client side components WindowsNote:
To enable Browser Content Redirection or Bi-directional Content Redirection, ensure you have Virtual Delivery Agent (VDA) version 2503 if you intend to use the Browser redirection extension from the Microsoft Edge Add-ons store. For older VDA versions, you can achieve the same functionality by installing the extension from the Chrome Web Store within your Microsoft Edge browser.
Note:
Browser content redirection is not supported on Citrix Workspace App Windows LTSR releases 1912 and 2203.1
Client side browser engine needed for Browser content redirection is installed by default on Citrix Workspace App Current Releases
Client side browser engine needed for Browser content redirection is not installed by default on Citrix Workspace App 2402 LTSR release. Administrators can leverage the ADDLOCAL switch to install BCR browser components on top of Citrix Workspace App.
For more details, please refer to Citrix Workspace App Windows documentation.
LinuxSteps to ConfigureNote:
For MacOS, Browser content redirection package is independent of Citrix Workspace App and is always the latest version. Hence, the package will be compatible with multiple CWA versions above the specified minimum version
As the dependency on Citrix Workspace App Mac is not there, Browser Content Redirection version numbering will not match Citrix Workspace App Mac version
Client side browser engine is not packaged with Citrix Workspace App Mac. Download and install the client side for Mac on Citrix Downloads.
Intel and ARM packages are separate. Hence, you need to install the appropriate version that suits the MacOS endpoint
Configuration OptionsNote:
HTML5 video redirection and browser content redirection are independent features. The HTML5 video redirection policies aren’t needed for this feature to work. However, the Citrix HDX HTML5 Video Redirection Service is used for browser content redirection.
We recommend doing all the configurations through Web Studio and not with registry keys.
Browser content redirection provides various ways to configure in order to suit the use cases of various customer environments. For detailed information on policy settings, refer Browser content redirection policy settings.
Redirection mechanisms Client fetch client renderBy default, Browser content redirection operates in this mode i.e., the client side browser engine reaches out to the web page directly. This requires necessary access from the client network to the web page. Client fetch client render scenario offloads all the network, CPU and RAM usage from Citrix VDA to the client and is the most optimal way to configure Browser content redirection
Policy configuration optionsBrowser content redirection: Allowed
Browser content redirection ACL configuration
Browser content redirection block list configuration
In this case, the client side browser engine contacts and fetches content from the web server through the VDA using a virtual channel. This option is useful when the client doesn’t have internet access (for example, thin clients). Low CPU and RAM consumption on the VDA, but bandwidth is consumed on the ICA virtual channel.
There are three modes of operation in this scenario. The term proxy refers to a proxy device that the VDA accesses to gain Internet access.
Policy configuration optionsIn addition to the policies specified in the Client fetch client render section, configure the following
Browser content redirection proxy configuration
There might be times when client redirection fails. For example, if the client machine does not have direct internet access, an error response might go back to the VDA. In such cases, the browser on the VDA can then reload and render the page on the server.
You can suppress server rendering of video elements by using the existing Windows Media fallback prevention policy. Set this policy to Play all content only on client or Play only client-accessible content on client. These settings block video elements from playing on the server if there are failures in client redirection. This policy takes effect only when you enable browser content redirection and the Access Control List policy contains the URL that falls back. The URL can’t be in the block list policy.
Authentication handling Authentication sitesIn the current implementation of Browser Content Redirection, regardless of the redirection mechanism, authentication sites need to be configured in order for Browser content redirection to handle log in into websites.
Example:
When only https://www.youtube.com/* is configured in Browser content redirection ACL configuration and no authentication sites are configured, BCR will fall back to server side rendering when signing into the website and will continue there.
In this case, in order for BCR to handle authentication sites, configure https://www.accounts.google.com/* and any other auth sites such as IdP website as needed. Each website sign in works differently and hence ensure to list
When configured, BCR will handle the authentication. For example, with client fetch client render - the authentication will also happen from the client side browser engine for a seamless sign in experience.
Configure the Browser content redirection authentication sites policy in addition to the policies mentioned in the redirection mechanisms section
Integrated Windows AuthenticationNote:
BCR client side browser does not persist cookies (including authentication) after the redirected window is closed. This would manifest as the need to re-login into websites when BCR windows are completely closed and re-opened.
BCR client side browser does not read cookies from the VDA side browser. Hence, user personalization and preferences don’t synchronize with the VDA browser.
Browser content redirection can provide a seamless way to authenticate to websites when configured with Integrated Windows Authentation (IWA) within the same domain as the VDA.
Policy configuration optionsBefore enabling single sign-on, complete the following:
Configure the Kerberos infrastructure to issue tickets for service principal names (SPNs) constructed from the host name. For example, HTTP/serverhostname.com.
For server fetch client render: When you use browser content redirection in server fetch mode, ensure that DNS is configured properly on the VDA.
For client fetch client render: When you use browser content redirection in client fetch mode, ensure that DNS is configured properly on the client device and that you allow TCP connections from the overlay to the web server’s IP address.
Browser content redirection can provide a seamless way to authenticate to your web proxy when fetching content from the server. When enabled, Browser Content Redirection will automatically obtain and use a Kerberos service ticket to authenticate with the proxy
Policy configuration optionsBefore enabling the server fetch proxy auth policy, complete the following:
Browser Content Redirection (BCR) can be utilized for a wide range of websites, particularly those that are resource-intensive and frequently accessed by enterprises. This includes video streaming platforms like YouTube, which can significantly benefit from offloading rendering to endpoint devices, thereby reducing server load and saving costs. Additionally, BCR is ideal for unified communications applications, such as video conferencing and collaboration tools (Google meet, Teams web, Zoom web) and contact center applications (Genesys cloud), ensuring smooth performance and enhanced user experience. By leveraging BCR, enterprises can optimize their resources and improve efficiency across various web-based applications. Refer CTX238236 for information on how to configure specific websites.
Extension Deployment Deploy ManuallyBrowser redirection extension is published in Chrome and Edge web stores. The extension is needed only on the browser on the VDA and not on the client side. To install the extension, navigate to Chrome / Edge webstore, search for Browser redirection extension and Add to the respective browsers. This method works for individual users. To deploy the extension to a large group of users, deploy the extension using group policy
Deploy Using Group Policy PrerequisitesAccess: You’ll need administrator privileges on the machine or within your Active Directory environment where you’ll be configuring Group Policy.
ADMX Files: Download the Google Chrome ADMX files (administrative templates) for your version of Chrome. You can find these on the Google Chrome Enterprise Help page.
Edge Templates: Download the Microsoft Edge administrative templates (ADMX files) from the Microsoft Edge Enterprise landing page.
Extension ID and Update URL: The extension ID and update URL for the Citrix Browser Content Redirection extension.
For troubleshooting information, see the How to troubleshoot browser content redirection knowledge center article.
Browser Content Redirection Limitations Server side limitations (VDA)Browser content redirection cannot support the following use cases. In case an enhancement is required for any mentioned scenarios or new scenarios, please reach out to the Citrix product team.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.3