Citrix Workspace For Html5



  • As opposed to existing as a separate process, Citrix Workspace App for HTML5 operates within the frame and process space of the browser itself. As such the browser has the ability to enforce certain security parameters.
  • Citrix StoreFront Gateway - HTML5 - No ESP: Handles Citrix Virtual Apps and Desktops traffic including Citrix StoreFront Gateway, HTTP redirect, and Connection Server Listeners (HTML5-8008 and Workspace-Receiver-2598). ESP Engine Disabled. Citrix StoreFront Internal: This template handles internal StoreFront connections. No rewriting of the ICA.
  • Applications or published desktops launched with the HTML5 client fail to start. Users see 'Error: Citrix Workspace app cannot launch app' The user may briefly see the 'Connection Interrupted' message displayed immediately at the beginning of the session. Applications or published desktops launched with Citrix Workspace App are successful.
downloadWhy can't I download this file? If the preceding configuration is consistent with the security policy of your organization, an administrator can enable launching applications or desktop using the following steps:
  1. Open a new tab in the Firefox browser.

  2. Type about:config in the address bar.

  3. Double-click network.websocket.allowInsecureFromHTTPS and set the value to true.

Note: This Firefox option might not be supported in Citrix Receiver for HTML5 future versions.

WARNING! This option on Firefox affects the operation of entire Firefox, not just Citrix Receiver for HTML5.

Important Note

As of version 9, Safari browser allows insecure web socket connections. Internet Explorer never allowed non SSL/TLS web socket connections from HTTPS websites. Chrome used to allow it behind a flag, but after the Chrome 44 update, this is no longer supported. Firefox allows it behind a flag (as explained earlier in this article), but it is not recommended. Going forward, only secure (SSL/TLS) web socket connections can be made from Receiver for HTML5.

Html5

Problem Cause

Html5

When Workspace App for HTML5 is hosted on a https site (default and recommended), non SSL/TLS websocket connections are prohibited by browsers.
In explaining the technical reason behind this it is important to understand the following two principles:
1. As opposed to existing as a separate process, Citrix Workspace App for HTML5 operates within the frame and process space of the browser itself. As such the browser has the ability to enforce certain security parameters.

For 2. Additionally, when any Workspace App for Windows makes a connection to a VDA for either a published desktop or app, the underlying connection is made to the VDA and not the Storefront server as any kind of intermediate proxy.


This second point is less obvious in the case of Citrix Workspace App for HTML5 because the published desktop or application displays within the browser frame and “appears” to be connected via the Storefront server. Despite this appearance though, the underlying TCP/UDP connection is still between the client and the VDA. If the Storefront base URL is SSL enabled (where it begins with https as is best practice) and the VDA is not SSL enabled (which it is not by default) the browser in this case will prevent the connection due to what it sees as an underlying inconsistency. The inconsistency is that while the URL shown in the browser frame is prefixed with https, the actual underlying connection is not https even though it is not obvious to the user.
There are two solutions for this.
Solution 1 is to enable SSL on the VDA using the following guide:

https://docs.citrix.com/en-us/citrix-virtual-apps-desktops/secure/tls.html
This will ensure that the connection path is SSL enabled between the internal client and the VDA.
Solution 2 is to have your connections from the clients first go through a Citrix Gateway. Citrix Gateway will proxy the connections and perform a SSL handshake between the client and the Citrix Gateway. In this scenario there is no inconsistency and connections via HTML5 Receiver will succeed.

Additional Resources

You can now use the Application probing feature to proactively monitor the health of applications enabling you to fix issues before the user actually experiences them. For more information refer to Citrix Documentation - Application probing.

receiver¶

citrix.receiver

Members¶

(readonly) apiVersion

Properties:¶

Microphone
NameTypeDescription
apiVersionStringWorkspace app for HTML5 API version.

Citrix Workspace For Windows 8

Methods¶

(static) createSession(idopt, connectionParams, onSessionCreated)

Creates a new session and returns session instance through callback. Use session instance to start the session, register and handle events and to disconnect the session.

Parameters¶

NameTypeAttributesDescription
idstring<optional>ID that is assigned when the session is created
connectionParamsconnectionParamsConfiguration options to create the session
onSessionCreatedonSessionCreatedCallback containing the session object created. Signature sample below:
function <function_name>(session_object){...}

Throws:¶

Unable to create session object.

Type
ReceiverError

Example¶

Methods¶

(static) setPath(pathopt, fallbackPathopt)

Sets the preference to use the latest HTML5 workspace app build from CDN or use the location of HTML5 Workspace app build hosted by customer to launch app/desktop sessions.

Parameters:¶

NameTypeAttributesDescription
pathstring<optional>Passing 'CDN' would consume the latest HTML5 Workspace app build from Citrix CDN.
However, this can be overridden by setting path with the location of HTML5 Workspace app build hosted by customer.
Defaults to CDN.
fallbackPathstring<optional>If CDN is not reachable then the HTML5 Workspace app build is picked from the location set using fallbackPath.

Throws:¶

HTML5 Engine Path or fallback path is invalid.

Type
ReceiverError

Example¶

(static) viewLog()

Citrix Workspace App For Html5 Download

Opens the logging page in a new tab.HTML5Engine Path should be setbefore calling this API.

Throws:¶

HTML5 Engine Path is invalid.

Citrix Workspace App For Html5 Microphone

Type
ReceiverError





Comments are closed.