Google policies

There are four options to customize Citrix Workspace app for Chrome:

  • configuration.js
  • web.config
  • default.ica
  • Google Policy

The four options are available on the configuration utility, which is a UI-based configuration webpage. The configuration utility is compatible with Citrix Receiver.

Configuration Utility Tool

This article describes custom configurations through the Google Policy option. The Google Admin console is cloud-managed. It lets you push policies per device and per user. Before Citrix Workspace app for Chrome (formerly Citrix Receiver for Chrome) Version 2.1, only policies to configure StoreFront were available. Extra policies have been made available since then.

For more information about customizing Citrix Workspace app for Chrome, see Knowledge Center articles CTX141844, and CTX229141.

You can also refer to the blog https://www.citrix.com/blogs/2016/08/17/receiver-for-chrome-configuration-options/.

Google policy file

There are two ways to configure Google policies:

  • Use the UI-based configuration utility tool or
  • Edit the policy.txt JSON file

In the UI-based configuration utility tool, click Create New. Select Citrix Workspace app for Chrome > Google Policy and click Continue.

Google Policy

Enter the details under different tabs. For example, ui, features, store_settings, power_ settings and so on. Click Download on the utility page. The policy.txt file is created.

Different keys

To edit the policy.txt JSON file manually, and to add custom configurations, see the following sample policy text. Configurable items under each key are described later in this article.


    {
        "settings": {
            "Value": {
                "settings_version": "1.0",
                "power_settings": {
                         "keep_awake_level": "display"
                                  },
                "store_settings": {
                    "name": "SampleStore",
                    "gateways": [
                        {
                        "url": "https: //yourcompany.gateway.com",
                        "is_default": true
                        }
                               ],
                    "beacons": {
                        "internal": [
                            {
                            "url": "http://yourcompany.internalwebsite.net"
                            }
                                ],
                        "external": [
                            {
                            "url": "http: //www.yourcompany.externalwebsite.com"
                            }
                                    ]
                                    },
                    "rf_web": {
                            "url": "http://yourcompany.storefrontstoreweb.net"
                              }
                    },
            "engine_settings": {
                    "vc_channel": {
                        "CTXCAM ": false,
                        "CTXFILE": false
                                  },
                    "ceip": {
                        "enabled": true
                            },
                    "analytics": {
                        "enabled": true
                                 },
                    "ui": {
                        "toolbar": {
                            "menubar": true,
                            "usb": true,
                            "fileTransfer": true,
                            "about": true,
                            "lock": true,
                            "disconnect": true,
                            "logoff": true,
                            "fullscreen": true,
                            "multitouch": true,
                            "preferences": true,
                            "gestureGuide": true
                                    },
                        "sessionsize": {
                            "windowstate": "fullscreen",
                            "minwidth" : 240,
                            "minheigh" : 120,
                            "available": {
                                "default": "Fit_To_Window",
                                "values": ["Fit_To_Window", "Use_Device_Pixel_Ratio", "1280x800", "1440x900", "1600x1200"]
                                        }
                                        },
                        "netPromoters": true,
                        "appSwitcher": {
                            "showTaskbar": true,
                            "showIconsOnly": false,
                            "autoHide": false
                                        },
                        "splashScreen": true,
                        "assistiveCursor": false
                        },
                    "nacl": {
                        "supportNacl": true,
                            "graphics": {
                                "enable": true,
                                "config": {
                                    "acceleration": 2
                                          }
                                        },
                            "video": {
                                "enable": true
                                     },
                            "audio": {
                                "enable": true
                                    }
                            },
                    "uniqueID": {
                        "prefixKey": "CR-",
                        "restrictNameLength": false,
                        "useAssetID": false
                                },
                    "features": {
                        "graphics": {
                            "jpegSupport": true,
                            "h264Support": {
                                "enabled": true,
                                "losslessOverlays": true,
                                "dirtyRegions": true,
                                "yuv444Support": false
                                           }
                                },
                        "multiMonitor": true,
                        "kioskMultimonitor": true,
                            "dpiSetting": {
                                "scaleToDPI": true
                                          }
                                },
                        "filetransfer": {
                            "allowupload": true,
                            "allowdownload": true,
                            "maxuploadsize": 2147483647,
                            "maxdownloadsize": 2147483647
                                        }
                            },
                        "com": {
                            "portname": "COM5"
                                }
                            },
                    "transport": {
                        "cgpEnabled": true
                                },
                    "other": {
                        "h264nonworker": false
                            },
                    "customVC": [
                            {
                            "appId": "xyz",
                            "streamName": "abc"
                            }
                                ]
    }
}

Power setting

Citrix Workspace app for Chrome keeps managed Chromebook devices awake even when users are not active. The awake setting feature is disabled by default. To configure awake settings, use the Google admin policy by including the following:


{
 "settings": {
     "Value": {
         "settings_version": "1.0",
         "power_settings": {
             "keep_awake_level": "system"
                           }
              }
            }
}

List of power setting options with their descriptions:

  • “keep_awake_level”: Keeps devices awake even when users are not active. You can choose either of the two values:

    • “system”: Keeps the system awake, but allows the screen to be dimmed or turned off.
    • “display”: Keeps the system awake and active.

Note:

For Kiosk mode, make sure that the Allow app to manage power setting in the Google Admin console is disabled.

Store settings

To create a store, you identify and configure communications with the servers. You can provide the resources that you want to make available in the store. Then, optionally, you configure remote access to the store through Citrix Gateway. To configure store settings, edit the Google admin policy by including the following:


{
    "settings": {
        "Value": {
            "settings_version": "1.0",
            "store_settings": {
                "name": "SampleStore",
                "gateways": [{
                    "url": "https: //yourcompany.gateway.com",
                    "is_default": true
                }],
                "beacons": {
                    "internal": [{
                        "url": "http: //yourcompany.internalwebsite.net"
                    }],
                    "external": [{
                        "url": "http: //www.yourcompany.externalwebsite.com"
                    }]
                },
                "rf_web": {
                    "url": "http: //yourcompany.storefrontstoreweb.net"
                }
            }
        }
    }
}

List of store setting options and their descriptions:

  • “name”: Enter the Store name.
  • “gateways”: Gateway URLs.

    Add gateway URLs in the format https://gateway.domain.com or https://yourcompany.gateway.com and click Add on the utility page.

    You can set a default gateway if two or more gateway URLs are added.

    To make a gateway the default, set the “is_default” flag to true. Otherwise, set the flag to false.

    For example:

    
         {
             "settings": {
                 "Value": {
                 "settings_version": "1.0",
                 "store_settings": {
                     "name": "RTST",
                         "gateways": [{
                             "url": "https: //yourcompany.gateway.com",
                             "is_default": true
                     },
                     {
                             "url": "https://gateway2.domain.com",
                             "is_default": false
                     }]
                 }
            }
        }
     }
    
    
  • “internal”: Determines whether Citrix Workspace app connects to StoreFront directly or it connects through a gateway. For example, https://storefront.domain.com.
  • “external”: Determines whether the specified network interface is available and allows traffic. For example, https://citrix.com.
  • “rf_web”: Store URL.

Virtual channels

A virtual channel consists of a client-side virtual driver that communicates with a server-side application. Virtual channels are a necessary part of the remote computing experience with Citrix Virtual Apps and Desktops servers.

Virtual channels are used for:

  • Printing
  • Serial port mapping
  • Clipboard
  • Audio
  • Multimedia
  • Control channel
  • EUEM
  • USB
  • File transfer
  • Mobility
  • Multi-touch
  • Smart card.

All virtual channels are enabled by default. To disable a particular virtual channel, use the Google admin policy by including the following. Select the feature name under “vc_channel” and click Add on the utility page. For example:


{
    "settings": {
        "Value": {
            "settings_version": "1.0",
                "engine_settings": {
                        "vc_channel": {
                            "<vc_name1>": false,
                            "<vc_name2>": false,
                            "<vc_name3>": false,
                            "<vc_namen>": false
                                        }
                                  }
        }
    }
}

To enable a particular “vc_channel”, select the feature and click Remove on the utility page.

Note:

The names can be from 1 to n. The last name “n” cannot have a comma after setting it to true or false.


{
    "settings": {
        "Value": {
            "settings_version": "1.0",
                "engine_settings": {
                    "vc_channel": {
                        "CTXCPM ": false,
                        "CTXCAM ": false,
                        "CTXGUSB": false
                                    }
                                   }
        }
    }
}

List of virtual channel options with their descriptions:

  • “CTXCPM”: PDF printing.
  • “CTXCCM”: Client serial port mapping.
  • “CTXCLIP”: Clipboard operations from session to VDA and from VDA to session.
  • “CTXCAM”: Client audio mapping.
  • “CTXMM”: Citrix multimedia redirection.
  • “CTXCTL”: Citrix control virtual channel.
  • “CTXEUEM”: End user experience monitoring.
  • “CTXGUSB”: Redirect USB devices to session.
  • “CTXFILE”: Secure file transfer functionality between a user device and a Citrix Virtual Apps and Desktops session. You can upload and download files to and from a session and seamlessly access data.
  • “CTXMTCH”: Multi-touch remotes all gestures to the virtual session. The app behaves based on the gestures it supports.
  • “CTXSCRD”: Smart card support.

Analytics and CEIP

Gathers anonymous data from customer deployments of Citrix Workspace app. Collected information includes the following:

  • System information details such as:

    • the version of the operating system
    • installed version of Citrix Workspace
    • language
    • browser version
  • Usage tracking details such as:
    • statistics of application launches over the course of a week
    • monitor resolutions
    • graphics modes
    • decoders
    • renderers
  • Critical to quality details such as connection and launch failures, and statistics on session connection times.

  • Configuration tracking details such as data points tracking to check whether feature is enabled or disabled.

Note:

To disable analytics and CEIP, one requires administrator-level credentials.

To configure analytics and CEIP using the GUI, go to Device Management > Chrome > User Settings, and add the strings as shown in the policy.txt file.

For Citrix Workspace app 1907 for Chrome and earlier, to configure CEIP, enable the attribute under ceip on the utility page. To configure manually, set the attribute under ceip to true in Google admin policy by including the following:


{
    "settings": {
        "Value": {
            "settings_version": "1.0",
                "engine_settings": {
                    "ceip":{
                        "enabled":true
                            }
                            }
        }
    }
}

For Citrix Workspace app 1908 for Chrome and later, to configure analytics, enable the attribute under analytics on the utility page. To configure manually, set the attribute under analytics to true in Google admin policy by including the following.

Note:

The analytics key is backward compatible with the CEIP key.


{
    "settings": {
        "Value": {
            "settings_version": "1.0",
                "engine_settings": {
                    "analytics":{
                        "enabled":true
                            }
                            }
        }
    }
}

In-session toolbar and dialogs

The in-session toolbar is a floating toolbar that can be moved anywhere on the screen. The toolbar has Citrix Workspace app icon embedded on it. A customized toolbar improves the user experience. This enhancement provides new options that are accessible from the toolbar to facilitate common tasks, such as:

  • switching to full-screen mode
  • uploading or downloading files
  • accessing additional options

The toolbar is enabled by default. To hide or customize individual toolbar items, edit the Google admin policy by including the following:


{
    "settings": {
        "Value": {
            "settings_version": "1.0",
                "engine_settings": {
                "ui" : {
                    "toolbar" : {
                            "menubar" :true,
                            "usb": true,
                            "fileTransfer":true,
                            "about":true,
                            "lock":true,
                            "disconnect":true,
                            "logoff":true,
                            "fullscreen":true,
                            "multitouch":true,
                            "preferences":true,
                            "gestureGuide":true
                                 }
                     }
                }
        }
    }
}

List of in-session toolbar options and their descriptions:

  • “menubar”: Toolbar appears when set to true, and is hidden when set to false.
  • “usb”: Opens the USB devices dialog box. Contains the list of devices that can be redirected into the session. To redirect a USB device, select an appropriate device and click Connect.
  • “fileTransfer”: Secure file transfer functionality between a user device and a Citrix Virtual Apps and Desktops session. You can upload and download files to and from a session and seamlessly access data.
  • “about”: Displays the third-party licenses page and provides the version number.
  • “lock”: Sends “Ctrl+Alt+Del” to the session.
  • “disconnect”: Disconnects the session.
  • “logoff”: Logs off from the session.
  • “fullscreen”: Adjusts the session to full-screen mode. If the session is connected with multiple monitors, the multi-monitor icon appears on the menu bar rather than a full-screen icon. A Restore icon appears on the menu bar while in full-screen mode. To restore maximized mode, click Restore in the toolbar UI.
  • “multitouch”: Remotes all gestures to the virtual session, and the app behaves based on the gestures it supports.
  • “preferences”: Provides options to customize CEIP and display resolution settings.
  • “gestureGuide”: Provides the guide for gestures in touch mode.

Window state on session launch

To open desktop sessions in full-screen mode, edit the Google admin policy by including the following. By default, desktop sessions open in maximized windows, where the “window state” value is set to “maximized”.


{
    "settings": {
        "Value": {
            "settings_version": "1.0",
            "engine_settings": {
            "ui": {
                "sessionsize": {
                    "windowstate": "fullscreen"
                    }
                }
            }
        }
    }
}

Session size

The session size setting lets you customize resolutions for a session. Edit the Google admin policy by including the following:


{
    "settings": {
      "Value": {
            "settings_version": "1.0",
            "engine_settings": {
            "ui": {
                "sessionsize" : {
                    "minwidth" : 240,
                    "minheigh" : 120,
                    "available" : {
                            "default" : "Fit_To_Window",
                            "values" : [
                                            "Fit_To_Window",
                                            "Use_Device_Pixel_Ratio",
                                            "1280x800",
                                            "1440x900",
                                            "1600x1200"
                                       ]
                        }
                    }
                }
            }
        }
    }
}

List of various resolution options and their descriptions:

  • “minwidth”: 240 : The minimum width for sessions.
  • “minheight”: 120 : The minimum height for sessions.
  • “available”: Options to set resolution preferences for sessions.
    • “default”: The value that you set applies to the default resolution. By default, the value is set to “Fit_To_Window”. You can change the default value as follows:

      • “values”: Other resolution values are:
        • “Fit_To_Window”: The default resolution value available. It matches the window size to emulate various screen resolutions.
        • “Use_Device_Pixel_Ratio”: Scales sessions to match the DPI of the device.
        • “1280x800”: Sets the session size to 1280 * 800 pixels.
        • “1440x900”: Sets the session size to 1440 * 900 pixels.
        • “1600x1200”: Sets the session size to 1600 * 1200 pixels.

Net promoter score

Citrix Workspace app for Chrome prompts you periodically for Net Promoter Score (NPS) feedback. The prompt asks you to rate your experience with Citrix Workspace app for Chrome. We use NPS feedback as a tool to measure customer satisfaction and to further improve the app.

You can rate your experience on a scale of 1 to 5, with 5 indicating that you are satisfied.

To configure NPS, use the Google admin policy by including the following. If the option is set to true, the user can provide rating.


{
    "settings": {
        "Value": {
            "settings_version": "1.0",
                "engine_settings": {
                    "ui": {
                        "netPromoters": true
                          }
                }
        }
    }
}

App switcher

Shows the apps that are launched inside a session.

Note:

This option is only for kiosk mode.

The app switcher enables users to switch between multiple apps running in the same session. The app that is in focus is highlighted. To configure app switcher, use the Google admin policy by including the following:


{
    "settings": {
        "Value": {
            "settings_version": "1.0",
                "engine_settings": {
                    "ui": {
                        "appSwitcher": {
                            "showTaskbar": true,
                            "showIconsOnly": false,
                            "autoHide": false
                                        }
                          }
                   }
        }
    }
}

List of appSwitcher options with their descriptions:

  • “showTaskbar”: If set to true, the taskbar appears at the bottom of the session. To hide the taskbar, set this option to false.
  • “showIconsOnly”: If set to true, the taskbar icons appear. By default, the option is set to false.
  • “autoHide”: If set to true, the taskbar is automatically hidden. By default, the option is set to false.

Assistive cursor

When a cursor is not visible inside a desktop session, you can enable an assistive cursor. Requires a session restart.

Assistive cursor

The assistive cursor feature is disabled by default. To enable the assistive cursor feature, use the Google admin policy by including the following.


{
    "settings": {
        "Value": {
            "settings_version": "1.0",
            "engine_settings": {
                "ui": {
                    "assistiveCursor": true
                    }
                }
            }
        }
}

Note:

  • If an administrator enables the assistive cursor as described above, the corresponding check box on the client-side setting is selected by default. To disable the feature, clear the check box.

  • If an administrator disables the assistive cursor as described above, the check box is cleared and the feature is disabled.

Splash screen

Citrix Workspace app displays a splash screen on the first launch with the text “Citrix Workspace app extends the capabilities of Citrix Receiver.” To configure the display of splash screen, use the Google admin policy by including the following. It is enabled by default. To disable, set the enabled attribute under the splash screen to false.


{
    "settings": {
        "Value": {
            "settings_version": "1.0",
            "engine_settings": {
                "ui": {
                    "splashScreen": true
                    }
                }
            }
        }
}

List of splash screen options with their descriptions:

  • “splash screen”: If set to true, the splash screen appears.

Native client

Allows running native codes safely from a web browser that is independent of the user’s operating system. This functionality allows web apps to run at near-native speeds. To configure a native client, use the Google admin policy by including the following. By default, the native client option is enabled. To disable it, set the enabled attribute under the native client to false.


{
    "settings": {
        "Value": {
            "settings_version": "1.0",
                "engine_settings": {
                    "ui": {
                            "Nacl" : {
                                 "supportNacl" : true,
                                 "graphics": {
                                         "enable": true,
                                         "config": {
                                                "acceleration": 2
                                                    }
                                            },
                                 "video":    {
                                            "enable": true
                                             },
                                 "audio":    {
                                            "enable": true
                                             }
                            }
                    }
                }
        }
    }
}

List of native client options with their descriptions:

  • “supportNacl”: Supports native client.
  • “graphics”: Enables native client graphics module.
  • “config”: Selects h264 hardware or software decoder.
    • Software = 0
    • Hardware = 1
    • Hardware with fallback = 2
    • AutoDetect = 3
  • “video”: Enables webcam redirection.
  • “audio”: Enables audio input or microphone redirection.

Unique ID and Asset ID

A unique ID is applied as a prefix to the client name.

Citrix Workspace app uses an asset ID that administrators set through the Google Admin console as a client name for the sessions launched from enrolled Chromebooks.

To configure an asset ID using the GUI, go to Device Management > Chrome > Devices Console, and add the Asset ID for the device.

To configure an asset ID and a unique ID manually, use the Google admin policy by including the following:


{
    "settings": {
        "Value": {
            "settings_version": "1.0",
                "engine_settings": {
                        "uniqueID" : {
                                 "prefixKey" : "CR-",
                                 "restrictNameLength" : true,
                                 "useAssetID": false
                                     }
                                  }
        }
    }
}

List of uniqueID options and their descriptions:

  • “prefixKey”: The prefix to be used before the client name. The default value is CR.
  • “restrictNameLength”: Enables or disables the name length of the prefixKey.
  • “useAssetID”: Asset ID that is set as a client name for sessions that are launched from enrolled Chromebooks.

Limitations:

  • You must have a Google admin policy that can be pushed. Otherwise, the current method of generating a unique client ID for managed Chromebooks remains in use.

  • Do not enter a value that has more than 15 characters. Values longer than 15 characters are truncated to 15 characters.

Graphics and H.264

To configure graphics and H.264 protocol support, use the Google admin policy by including the following. By default, H.264 protocol support is enabled. To disable it, set the enabled attribute to false.


{
    "settings": {
        "Value": {
            "settings_version": "1.0",
                "engine_settings": {
                     "ui": {
                        "features": {
                            "graphics": {
                                "jpegSupport": true,
                                "h264Support" : {
                                     "enabled": true,
                                     "losslessOverlays": true,
                                     "dirtyRegions": true,
                                     "yuv444Support": false
                                }
                            }
                        }
                     }
                }
        }
   }
}

List of graphics options with their descriptions:

  • “jpegSupport”: JPEG capability in Graphics (Thinwire).
  • “h264Support”: H.264 protocol support.
  • “enabled”: H.264 support capability in Thinwire.
  • “losslessOverlays”: Loss less overlays capability in Thinwire.
  • “dirtyRegions”: Dirty regions capability in Thinwire.
  • “yuv444Support”: Yuv444 support capability in Thinwire.

Multi-monitor display

By default, the multi-monitor feature is set to enabled.

Note:

  • If you are using Citrix Workspace app running on XenApp 6.5, set the shadowing policy to Disabled to use the multi-monitor feature.

  • In a desktop session, when the window is set to full screen, the Display Resolution option in Preferences is deactivated.

  • UI dialogs and toolbars appear only on the primary monitor. However, USB and smart card authentication dialogs span across monitors.

To disable enhanced multi-monitor display in kiosk mode

Enhanced multi-monitor display in kiosk mode is enabled by default.

To disable the feature in kiosk mode, edit the configuration.js file or the Google Admin Console policy and set the value of kioskMultimonitor property to false.


{
    "settings": {
        "Value": {
            "settings_version": "1.0",
            "engine_settings": {
                "features": {
                    "graphics": {
                        "multiMonitor": true,
                        "kioskMultimonitor": true
                  }
              }
           }
       }
    }
 }

Note:

To be able to launch a session in kiosk mode, you must enable Unified Desktop mode.

  1. Launch a web browser and enter the following command: chrome://flags
  2. From the list of flags, search for UnifiedDesktopMode and set it to Enabled.

To configure Unified Desktop mode

  1. Log on to the Google Admin console.
  2. Go to Device management > Chrome Management > User Settings.
  3. Set the Unified Desktop policy to Make Unified Desktop mode available to user.
  4. Click Save.

Kiosk mode

The store URL is read-only in kiosk mode and cannot be edited using the Account settings screen. You can change this setting by repackaging the app with the .cr file or through Google Policy Management using the Google Admin Console.

If you are using the Google Admin Console, edit the policy.txt file containing the Citrix Workspace configuration. Replace the value of “url” under “rf_web” with a persistent URL.


    {
    "settings": {
    "Value": {
    "settings_version": "1.0",
    "store_settings": {
    "beacons": {
    "external": [
    {
    "url": "http://www.yourcompany.externalwebsite.com"
    }
    ],
    "internal": [
    {
    "url": "http://yourcompany.internalwebsite.net"
    }
    ]
    },
    "gateways": [
    {
    "is_default": true,
    "url": "https://yourcompany.gateway.com"
    }
    ],
    "name": "mystore",
    "rf_web": {
    "url": " http://your_RfWebURL_or_persistenturl "
    }
    }
    }
    }
    }

DPI scaling

You can configure the High DPI Scaling setting only using the Google admin policy. The DPI scaling feature Scale the session for monitors with high device pixel ratio is enabled by default.

To enable or disable the feature, edit the Google Admin Console policy and set the value of scaleToDPI property to true or false.

For example, to disable the feature, set scaleToDPI property to false.


{
    "settings": {
               "Value": {
                        "settings_version": "1.0",
                              "engine_settings": {
                                    "features" : {
                                    "graphics" : {
                                        "dpiSetting": {
                                                "scaleToDPI": false
                                                        }
                    }
                }
            }
        }
    }
}

File transfer

To configure file transfer, use the Google admin policy by including the following. By default, the file transfer feature is enabled. To disable it, set the enabled attribute to false.


{
    "settings": {
        "Value": {
            "settings_version": "1.0",
                "engine_settings": {
                    "ui": {
                         "features": {
                            "filetransfer" : {
                                    "allowupload": true,
                                    "allowdownload": true,
                                    "maxuploadsize": 2147483647,
                                    "maxdownloadsize": 2147483647
                            }
                        }
                    }
                }
        }
    }
}

List of file transfer options with their descriptions:

  • “allowupload”: Allows file uploads from device to remote session.
  • “allowdownload”: Allows downloads from device to remote session.
  • “maxuploadsize”: The maximum file size, in bytes, that can be uploaded. By default, set to 2,147,483,648 bytes (2GB).
  • “maxdownloadsize”: The maximum file size, in bytes, that can be downloaded. By default, set to 2,147,483,648 bytes (2GB).

Serial COM port redirection

To configure serial COM port redirection, enable the feature by applying Citrix Virtual Apps and Desktops port redirection policy settings. For more information about port redirection, see Port redirection policy settings in the Citrix Virtual Apps and Desktops product documentation.

Note:

By default, Citrix Workspace app maps COM5 as the preferred serial COM port for redirection.

After enabling serial COM port redirection policy settings on the VDA, configure the Workspace app using the Google admin policy by including the following:


{
      "settings": {
               "Value": {
                "settings_version": "1.0",
                "store_settings": {
                "rf_web": {
                "url": "<http://YourStoreWebURL>"
                 }
                 },
                 "engine_settings":{
                 "features" : {
                 "com" : {
                        "portname" : "<COM5>"
                        }
                          }
                        }
                      }
                   }
}

List of serial COM port name options and their descriptions:

  • “portname”: Port number for the COM (serial) virtual channel. By default, the value is COM5.

Transport

Adaptive transport maintains high server scalability and efficient use of bandwidth. By using adaptive transport, ICA virtual channels automatically respond to changing network conditions. They intelligently switch the underlying protocol between the Citrix protocol called Enlightened Data Transport (EDT) and TCP to deliver the best performance.

By default, the transport option is disabled. To disable it, set the enabled attribute under transport to false.


{
    "settings": {
        "Value": {
            "settings_version": "1.0",
                "engine_settings": {
                    "transport" : {
                        "cgpEnabled" : true
                                 }
                              }
               }
    }
}

List of transport options with their descriptions:

  • “cgpEnabled”: The Common Gateway Protocol (CGP).

Other

To configure H.264, use the Google admin policy by including the following. By default, the option under the other section is disabled. To enable it, set the disabled attribute h264nonworker to true.

{
    "settings": {
        "Value": {
            "settings_version": "1.0",
                "engine_settings": {
                    "other": {
                        "h264nonworker" : false
                        }
                }
        }
    }
}

List of options with their descriptions:

  • “h264nonworker”: Enable the option to decode H.264 frame in main thread.

CustomVC

Virtual Channel SDK for Chrome enables third-party Chrome apps to write custom virtual channels. These channels are initialized with the app and desktop sessions launched using Citrix Workspace app or using the HDX SDK for Chrome.

In addition, the virtual channel SDK gives an easy way to write and receive data from the third-party Chrome app and the app and desktop.

To configure custom virtual channels, use the Google admin policy by including the following.


{
    "settings": {
        "Value": {
            "settings_version": "1.0",
                "engine_settings": {
                    "customVC": [
                        {
                    "appId": "xyz",
                    "streamName": "abc"
                        }
                    ]
                }
        }
    }
}

List of CustomVC options with their descriptions:

  • “appId”: ID of the chrome app that is implementing custom virtual channels.
  • “streamName”: The virtual channel name.

Taskbar icons

Applications and desktops configured using Citrix Virtual Apps and Desktops in an active session are displayed as separate apps in the taskbar (shelf) on a Chrome device. This feature applies to published applications and desktops. The functionality and behavior of this feature are similar to the taskbar experience provided by the Windows Operating system.

By default, this feature is enabled.

To configure taskbar icons

  1. Log on to the Google Admin Console.

  2. Go to Device management > Chrome Management > User Settings.

  3. Add the following strings to the policy.txt file.

    Show in shelf image

  4. Click Save and close the file.

Verifying the configuration of policies

To verify that policies are pushed correctly, do the following:

  1. Navigate to chrome://policy/.

  2. Click Reload policies.

  3. Search for the Citrix Workspace app for Chrome Web Store ID, which is haiffjcadagjlijoggckpgfnoeiflnem.

    • If policies are pushed successfully from the Google Admin Console, they appear under the Web Store ID: haiffjcadagjlijoggckpgfnoeiflnem. If not, verify that the policies are configured correctly. To create or edit the policy, make sure to use the Configuration Utility Tool.

    • If the policies appear under the Web Store ID but do not take effect in the session, contact Citrix Technical support.