Citrix Workspace app 1808 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 not supported by Citrix Workspace App for Chrome OS HDX SDK. For specific use case and assistance contact at [email protected].
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:
-
Install the latest version of Citrix Workspace app for Chrome. See Citrix downloads page for details.
-
Whitelist the third-party Chrome app by adding the policy file for Citrix Workspace app for Chrome using Chrome management settings.
The sample policy.txt file to whitelist the third-party Chrome app is as below:
{ "settings": { "Value": { "settings_version": "1.0", "store_settings": { "externalApps": [“<3rdParty_App1_ExtnID>”,“<3rdParty_App2_ExtnID>”] } } } }
Note
<3rdParty_App1_ExtnID> is used as an example for the name of externalApps and can send messages to Citrix Workspace app for Chrome. Get your appid from the chrome://extensions
site.
Additional references¶
Citrix Workspace app for Chrome uses message communication provided by Chrome OS. For more details, see the following links:
- https://developer.chrome.com/apps/tags/appview
- https://developer.chrome.com/extensions/runtime#event-onMessageExternal
- https://developer.chrome.com/extensions/runtime#method-sendMessage
- For more details, see Manage Chrome Apps by organizational unit on Google support.
- For more information on whitelisting, see https://support.google.com/chrome/a/answer/6177431?hl=en