You can use WebRTC Media Helper in a Citrix environment through Citrix’s Browser Content Redirection feature. The Citrix Browser Content Redirection feature removes the need to log in to WebRTC Media Helper outside of VDI on a local device.

Note: Citrix’s Browser Content Redirection feature only supports Windows and Linux workstations; it does not support MacOS.

To allow WebRTC Media Helper to work in a Citrix environment, Citrix requires you to edit the Windows registry on your Citrix server to add two multi-string values: WebBrowserRedirectionAcl and WebBrowserRedirectionAuthenticationSites.

Warning: Editing the Windows registry can be dangerous to the stability of the operating system. Before you begin, best practice recommends that you back up the registry.
  1. Open the Registry Editor and navigate to the following folder:
    HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\HDXMediaStream
  2. Click Edit and select New | Multi-String Value.
  3. In the Value Name box, type WebBrowserRedirectionAcl and press Enter twice. The Edit Multi-String dialog opens.
  4. In the Value data panel:
    • Type the Genesys Cloud login URL for your region. Append /* to the URL.
    • Type the URL to the Genesys Cloud WebRTC Media Helper app for your region. Append /* to the URL.
  5. Click OK.
  6. Repeat steps 2 through 5 to create a second Multi-String Value named WebBrowserRedirectionAuthenticationSites.

For example, if you are in the US West (Oregon) region, your Edit Multi-String dialog boxes will look like this:

AWS region AWS region name Region in Genesys Cloud login Genesys Cloud login URL
US East (N. Virginia) us-east-1 Americas (US East) https://login.mypurecloud.com
US East 2 (Ohio)*
us-east-2 FedRAMP https://login.use2.us-gov-pure.cloud
US West (Oregon) us-west-2 Americas (US West) https://login.usw2.pure.cloud
Canada (Central) ca-central-1 Americas (Canada) https://login.cac1.pure.cloud 
South America (São Paulo) sa-east-1 Americas (São Paulo) https://login.sae1.pure.cloud
Europe (Frankfurt) eu-central-1 EMEA (Frankfurt) https://login.mypurecloud.de 
Europe (Ireland) eu-west-1 EMEA (Dublin) https://login.mypurecloud.ie
Europe (London) eu-west-2 EMEA (London) https://login.euw2.pure.cloud
Europe (Zurich) eu-central-2 EMEA (Zurich)
https://login.euc2.pure.cloud
Middle East  (UAE) me-central-1 EMEA (UAE) https://login.mec1.pure.cloud
Asia Pacific (Mumbai) ap-south-1 Asia Pacific (Mumbai) https://login.aps1.pure.cloud
Asia Pacific (Seoul) ap-northeast-2 Asia Pacific (Seoul) https://login.apne2.pure.cloud
Asia Pacific (Sydney) ap-southeast-2 Asia Pacific (Sydney) https://login.mypurecloud.com.au
Asia Pacific (Tokyo) ap-northeast-1 Asia Pacific (Tokyo) https://login.mypurecloud.jp
Asia Pacific (Osaka) ap-northeast-3
Asia Pacific (Osaka)
https://login.apne3.pure.cloud

* The US East 2 (Ohio)/FedRAMP region is an AWS region that is dedicated to U.S. Public Sector agencies and customers contracted to provide support for U.S. Public sector agencies.

Region Region-specific Genesys Cloud WebRTC Media Helper app
US East (N. Virginia) https://apps.mypurecloud.com/mediahelper
US East 2 (Ohio)* https://apps.use2.us-gov-pure.cloud/mediahelper 
US West (Oregon) https://apps.usw2.pure.cloud/mediahelper
Canada (Canada Central) https://apps.cac1.pure.cloud/mediahelper
South America (Sao Paulo) https://apps.sae1.pure.cloud/mediahelper 
EU (Frankfurt) https://apps.mypurecloud.de/mediahelper
EU (Ireland) https://apps.mypurecloud.ie/mediahelper
EU (London) https://apps.euw2.pure.cloud/mediahelper
Asia Pacific (Seoul) https://apps.apne2.pure.cloud/mediahelper
Asia Pacific (Sydney) https://apps.mypurecloud.com.au/mediahelper
Asia Pacific (Tokyo) https://apps.mypurecloud.jp/mediahelper
Asia Pacific (Mumbai) https://apps.aps1.pure.cloud/mediahelper 

* The US East 2 (Ohio)/FedRAMP region is an AWS region that is dedicated to US federal agencies.

Troubleshooting

Genesys provides a way to run Genesys Cloud in Citrix with WebRTC Media Helper but does not provide support for the Citrix Browser Content Redirection feature. If you encounter issues with the Citrix Browser Content Redirection feature, you can follow these steps:

  1. Contact your Citrix partner.
  2. Investigate the Citrix Browser Content Redirection documentation.
  3. Investigate the Citrix support document: How to Troubleshoot Browser Content Redirection.