Citrix Workspace app for Chrome HDX SDK

Citrix Workspace app for Chrome provides the HDX SDK as a JavaScript file that you can include in third-party Chrome apps. The HDX SDK provides an API to launch and interact with the XenApp and XenDesktop sessions from third-party Chrome apps.

The HDX SDK for Chrome provides the following capabilities:

• Launch an HDX SDK session in regular mode (opens the session in a new window) or in embedded mode inside third-party Chrome apps (using appview).
• Receive events from a session on connect, disconnect, and errors.
• Change the resolution of the launched session dynamically.
• Send special key combinations in an active session. For example, Ctrl+Alt+Del, Ctrl+Shift+Esc.
• Show or hide a launched session.
• Send Disconnect/Log off commands from a session.

For the latest HDX SDK APIs and examples, see the download page.

For HDX SDK API documentation for Chrome, see Capabilities.

Note:

Chrome extension or Chrome app with manifest V3 is supported by Citrix Workspace app for ChromeOS HDX SDK 2305 and later. For specific use case and assistance contact at chrome@citrix.com.

Prerequisites

Citrix Workspace app for Chrome supports only the whitelisted third-party Chrome apps. You can whitelist a third-party Chrome app by adding the policy file for Citrix Workspace app for Chrome using Chrome management settings.

To whitelist a third-party Chrome app, do the following:

1. Install the latest version of Citrix Workspace app for Chrome. See Citrix downloads page for details.

2. Whitelist the third-party Chrome app by adding the policy file for Citrix Workspace app for Chrome using Chrome management settings.

Here is an example of the policy.txt file that you can use to whitelist the third party Chrome app:

{
    "settings": {
         "Value": {
             "settings_version": "1.0",
             "store_settings": {
                    "externalApps": [“<3rdParty_App1_ExtnID>”,“<3rdParty_App2_ExtnID>”]
            }
        }
    }
}
<!--NeedCopy-->

Note:

Replace <3rdParty_App1_ExtnID> with your app ID that you can get from the chrome://extensions site. This variable can be used to send messages to Citrix Workspace app for Chrome.

Additional references

Citrix Workspace app for Chrome uses message communication provided by Chrome OS. For more details, see:

• appView tag
• onMessageExternal event
• sendMessage method
• Manage policies for ChromeOS devices

For information on whitelisting, see Allow or block apps and extensions.