Recommended solution: Update the certificates.
- Citrix Workspace Extension Chrome
- Citrix Workspace App For Chromebook
- Download Citrix Receiver For Chrome
- Citrix Workspace Chrome Web Store
A list containing the majority of Citrix Workspace app for Chrome (formerly Receiver for Chrome) support articles collated to make this page a one stop place for you to search for and find information regarding any issues you have with the product and its related dependencies. The page is updated daily with new support articles and information. Citrix Workspace gives you the tools needed to be productive while providing a seamless experience. Citrix adapts to your specific needs, giving you direct access to everything in one single.
Alternatively, you can try this workaround:
Close the Citrix Workspace app for Chrome / Citrix Receiver for Chrome.
Open Chrome browser in your Chromebook.
Visit your site.
It will show some error as below.
Now, open the Citrix Workspace app for Chrome or Citrix Receiver for Chrome and it might allow you to access your StoreFront/VDA.
Other possible workaround for specific certificate error:
NET::ERR_CERT_WEAK_SIGNATURE_ALGORITHM error
Latest Firefox and Chrome browsers do not support SHA-1 certificate and StoreFront connection fails with error: NET::ERR_CERT_WEAK_SIGNATURE_ALGORITHM
Citrix Receiver for Chrome/HTML5 or Citrix Workspace app for Chrome/HTML5 cannot establish secure connection and session launch will failNET::ERR_CERT_COMMON_NAME_INVALID error
Chrome requires Subject Alternative Name for SHA-2 certificate, without SAN (Subject Alternative Name) in the SHA-2 certificate, the connection will fail with error NET::ERR_CERT_COMMON_NAME_INVALID
Session launch fails with CERT_COMMON_NAME_INVALID(-200) error dialog
Workaround for NET::ERR_CERT_WEAK_SIGNATURE_ALGORITHM and
NET::ERR_CERT_COMMON_NAME_INVALID:Mozilla:
Enable network.websocket.allowInsecureFormHTTPS from about:config
Chrome:
Chrome by default requires SHA2 Certificate with Subject Alternative Names (SAN)
Add the following registry keys at : SoftwarePoliciesGoogleChromeEnableCommonNameFallbackForLocalAnchors – true
(Note: Chrome need SAN by default)EnableSha1ForLocalAnchors – true
(Note: SHA1 is not supported)
Recommended Solution: Use SHA2 certificates with Subject Alternative Names (SAN).Problem Cause:
CTX134123 - Receiver for HTML5 - Unable to Launch Apps Using HTTPS URL
CTX217352 - How to Collect Logs in Receiver for Chrome and Receiver for HTML5
NET::ERR_CERT_SYMANTEC_LEGACY
From Chrome OS version 66 onwards the SSL certificate from Symantec is distrusted. You can go through https://security.googleblog.com/2018/03/distrust-of-symantec-pki-immediate.html to know more about it.
Workaround: Try general workaround mention above.
Recommended Solution: Update SSL certificates.
Session¶
new Session()
Members¶
(readonly) receiverId¶
Properties¶
| Name | Type | Description |
|---|---|---|
receiverId | String | Workspace app for Chrome ID. |
(readonly) sessionId¶
Properties¶
| Name | Type | Description |
|---|---|---|
sessionId | String | ID of the session. |
Methods¶
(inner) addListener(eventType, eventListener)¶
Registers the eventListener on the eventType.
Parameters¶
| Name | Type | Description |
|---|---|---|
eventType | String | Type of the event for which the listener needs to be attached. Supported event types: - onConnection - onConnectionClosed - onURLRedirection - onError |
eventListener | eventListener | Listener to handle the event |
Example¶
(inner) changeResolution(bounds, responseCallback)¶
Citrix Workspace Extension Chrome
Changes the resolution of the session.
Parameters¶
| Name | Type | Description |
|---|---|---|
bounds | Object | Contain session resolution settings. |
responseCallback | responseCallback | Callback that handles the response. |
Properties¶
| Name | Type | Description |
|---|---|---|
bounds.autoresize | boolean | Should be set to false to give fixed width and height to session. By default, this value is set to true in which case the session is resized to match the size of appView element inside third party Chrome app or the new window. |
bounds.width | Number | Width of the session specified in pixels. This value will be set only when autoresize is set to false. |
bounds.height | Number | Height of the session specified in pixels. This value will be set only when autoresize is set to false. |
Examples¶
Example 1: To change resolution to fixed width and height.
Example 2: To change the session resolution to match the size of appview element inside third party Chrome app or the window size.
(inner) hide(responseCallback)¶
Hides the session.
Parameters¶
| Name | Type | Description |
|---|---|---|
responseCallback | responseCallback | Callback that handles the response. |
(inner) logoff(responseCallback)¶
Sends logoff to the session.
Parameters¶
| Name | Type | Description |
|---|---|---|
responseCallback | responseCallback | Callback that handles the response. |
(inner) removeListener(eventType, eventListener)¶
Removes the eventListener on the eventType.
Parameters¶
| Name | Type | Description |
|---|---|---|
eventType | String | Type of the event for which the listener needs to be attached. Supported event types: - onConnection - onConnectionClosed - onURLRedirection - onError |
eventListener | eventListener | Listener to handle the event |
Example¶
(inner) sendSpecialKeys(keys, responseCallback)¶
Sends a key combination to the session.
Parameters¶
| Name | Type | Description |
|---|---|---|
keys | Array | Array of strings with each one representing a key. Supported keys Alt, Control, Shift, ArrowDown, ArrowLeft, ArrowRight, ArrowUp, Home, End, PageUp, PageDown, Backspace, Delete, F5, PrintScreen,Insert, Escape, Tab. |
responseCallback | responseCallback | Callback that handles the response. |
Examples¶
Example 1: Sends Ctrl+alt+delete to the session.
Example 2: To preview different apps running inside session, Ctrl+alt+tab can be sent.
(inner) show(responseCallback)¶
Shows the session.
Parameters¶
| Name | Type | Description |
|---|---|---|
responseCallback | responseCallback | Callback that handles the response. |
(inner) start(launchData, responseCallback)¶
Starts the session.
Parameters¶
| Name | Type | Description |
|---|---|---|
launchData | Object | Contains the type and value of the ICA |
responseCallback | responseCallback | Callback that handles the response. |
Properties¶
Citrix Workspace App For Chromebook
| Name | Type | Description |
|---|---|---|
launchData.type | String | Specifies the data type of ICA data. Allowed values are 'json' or 'ini'. |
launchData.value | String | ICA data to start the session. It should be a JSON object when type is 'json' or a string read from a .ini file when type is 'ini'. |
Download Citrix Receiver For Chrome
Examples¶
Example 1: When ICA data is in JSON format
Citrix Workspace Chrome Web Store
Example 2: When ICA data is in INI format.