Get started

Set up

Desktops and applications appear after logging in. You can search for resources and click an icon to start a desktop or application in a new window.

When you start an additional application, Citrix Workspace app for Chrome checks if the application can be launched in an existing session before creating a new session. This enables you to access multiple applications in a single session.

You can configure the features and functionalities of Citrix Workspace app for Chrome using any of the following methods:

  • Google Admin Policy
  • Web.config in StoreFront
  • default.ica
  • configuration.js

Note:

As of version 1901, the splash screen is no longer visible to users. The schema “splashScreen”: false” will no longer be supported in future releases. You must remove the schema, if present, from the Google Admin policy or the configuration.js file.

Using Google Admin policy

Note:

Citrix recommends using this method only when Citrix Workspace app for Chrome is repackaged for users.

Before Version 2.1, only store/beacon related configurations could be pushed through Google Admin Policy. For additional information about this policy, see the Knowledge Center articles CTX141844 and CTX229141.

With Citrix Workspace app for Chrome Version 2.1, other Chrome configurations can also be pushed through the Google Admin Policy.

For more information, see the sample policy text below:

    {
        "settings": {
          "Value": {
         "settings_version": "1.0",
          "store_settings": {
            "name": "RTST",
            "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":{
              "ui":{
              "sessionsize": {
              "windowstate": "fullscreen",
              "available" : {
               "default" : "Fit_To_Window",
             "values" : ["Fit_To_Window", "Use_Device_Pixel_Ratio","1280x800","1440x900","1600x1200"]
                }
                },
               "toolbar": {
               "menubar":true,
               "usb": true,
               "fileTransfer":true,
               "about":true,
                "lock":true,
                "disconnect":true,
                "logoff":true,
                "fullscreen":true,
                "multitouch":true,
                "preferences":true,
                "gestureGuide":true
                }
                }, “features”:{
                “com”:{
                “portname” :”COM5”
                 },
                 "graphics" : {
                "features" : {
                "graphics" : {
                 "jpegSupport" : true,
                 "h264Support" : {
                 "enabled" : true,
                 "losslessOverlays" : true,
                 "dirtyRegions" : true,
                 "yuv444Support" : false
                  }
                  },
                  "filetransfer" : {
                  "allowupload" : true,
                  "allowdownload" : true,
                  "maxuploadsize"               : 2147483647,
                  "maxdownloadsize" : 2147483647
                   }
                   },
                   "nacl" : {
                   "supportNacl" : true,
                   "graphics": {
                   "enable": true
                   },
                   "video": {
                   "enable": true
                    },
                    "audio": {
                   "enable": true
                    }
                    }
                    }
                    }
                    }  }

Using Web.config

Note:

Citrix recommends that you use the web.config file method for configuration purposes only when a store version of Citrix Workspace app for Chrome is being used.

To change the configuration using the Web.config file:

  1. Open the web.config file for the Citrix Workspace for Web site. This file is typically located in C:\inetpub\wwwroot\Citrix\storenameWeb, where storename is the name specified for the store when it was created.
  2. Locate the chromeAppPreferences field and set its value with the configuration as a JSON string.

For example:

chromeAppPreferences = ‘{“ui”: {“toolbar”: {“menubar”: false}}}’

Using the default.ica file

Note:

Citrix recommends that you use the default.ica file method for configuration purposes only for Web Interface users.

Citrix Workspace app for Chrome allows Custom .ica files without any initial program value.

To change the configuration using the default.ica file:

  1. Open the default.ica file typically located at C:\inetpub\wwwroot\Citrix\<site name>\conf\default.ica for Web interface customers, where sitename is the name specified for the site when it was created. In case of Storefront customers, default.ica file is typically located at C:\inetpub\wwwroot\Citrix\<Storename>\App_Data\default.ica, where storename is the name specified for the store when it was created.
  2. Add a new key at the end of the file, chromeAppPreferences with its value set to configuration as the JSON object.

For example:

chromeAppPreferences={“ui”:{“toolbar”: {“menubar”: false}}}

A sample default.ica file looks like below:

``` ;

; ICA Override File

;

; Add ICA file settings that you want to be sent to client devices

; to this file. Settings contained in this file override any

; settings generated by Delivery Services.

;


[WFClient]

Version=2

RemoveICAFile=yes

ProxyTimeout=30000

ProxyFavorIEConnectionSetting=Yes

ProxyUseFQDN=Off


[ApplicationServers]

Application=


[Application]

TransportDriver=TCP/IP

DoNotUseDefaultCSL=On

BrowserProtocol=HTTPonTCP

LocHttpBrowserAddress=!

WinStationDriver=ICA 3.0

ProxyTimeout=30000

AutologonAllowed=ON

;EncryptionLevelSession=RC5 (128 bit)


[EncRC5-0]

DriverNameWin16=pdc0w.dll

DriverNameWin32=pdc0n.dll


[EncRC5-40]

DriverNameWin16=pdc40w.dll

DriverNameWin32=pdc40n.dll


[EncRC5-56]

DriverNameWin16=pdc56w.dll

DriverNameWin32=pdc56n.dll


[EncRC5-128]

DriverNameWin16=pdc128w.dll

DriverNameWin32=pdc128n.dll


[Compress]

DriverNameWin16=pdcompw.dll

DriverNameWin32=pdcompn.dll

chromeAppPreferences={"ui" : {"toolbar" : { "menubar" : false}}}
```

Using the configuration.js file

The configuration.js file is located in the ChromeApp root folder. Access this file directly to make changes to Citrix Workspace app for Chrome.

Note:

  • Citrix recommends that you back up the configuration.js file before making any changes to it.
  • Administrator-level credentials are required to edit the configuration.js file; after editing the file, repackage the app to make additional modifications to toolbar elements.
  • In kiosk mode, the toolbar is hidden by default. When editing the configuration.js file to enable the toolbar, ensure that kiosk mode is disabled. Citrix recommends that you use one of the alternative methods (for example, the default.ica file) to enable the toolbar.