Configure Citrix Workspace app using Unified Endpoint Management solutions

Support for store configuration using unified endpoint management solutions

Citrix Workspace app for Android now supports remote configuration of your Workspace Store URL using unified endpoint management solutions. As an administrator, you can manage store URLs remotely using the AppConfig-based key-value pairs using unified endpoint management solutions.

To configure your Workspace Store URL using unified endpoint management solutions, follow these steps:

Configure your store using unified endpoint management solutions

Citrix Workspace app for Android supports remote configuration of your Workspace Store URL using unified endpoint management solutions.

To remotely configure your Workspace Store URL using existing unified endpoint management solutions, follow these steps:

  1. Sign in to your unified endpoint management solutions provider.
  2. Create an app configuration policy for your app.
  3. Add the key-value pair to the JSON property list and fill in the following values:

    • key: url
    • value type: String
    • value: your store URL (for example, prodcwa.cloud.com)

    Note:

    • For demonstrative purposes, Microsoft Intune is used as the unified endpoint management solution in this example. The UI shown differs depending on your unified endpoint management solutions provider.

    Intune

Limitations

  • If a cloud store is already set up and the administrator configures a new cloud store, your existing cloud store and any associated data or settings are deleted. You receive a notification to inform you of the deletion in Citrix Workspace. You must then sign in again so that the new cloud store is added to Citrix Workspace.
  • To apply new configurations, you must close and open Citrix Workspace app.

Support to configure store type

Starting with the 23.6.0 release, Citrix Workspace app for Android supports configuring store type using the AppConfig-based key-value pair to configure the Citrix Workspace app. Now, administrators can control how the app appears.

The following is the key-value pair:

  • key: storeType
  • value type: Integer
  • value:

    ◈ If set to 1 (default), users can view the native or the default store loading. ◈ If set to 2, users can view the store inside a web interface.

Note:

This feature doesn’t require enablement.

Control store configurations using unified endpoint management solutions

The Citrix Workspace app for Android started supporting remote configuration of the Workspace Store URL using unified endpoint management solutions from the 23.4.5 version. As an administrator, you can manage store URLs remotely using AppConfig-based key-value pairs using unified endpoint management solutions.

For more information, see Support for store configuration using unified endpoint management solutions.

Starting with the 23.7.5 version, administrators can configure if end users can modify store URLs using an AppConfig-based key-value pair:

  • key: restrict_user_store_modification
  • value type: Boolean
  • value:

    ◈ If set to true, end users can’t modify the store (add or delete or edit).

    ◈ If set to false, end users can modify the store.

Note:

If the flag restrict_user_store_modification is set to true, all the existing stores are deleted before adding a new unified endpoint management-configured store.

Screenshot detection and prevention through Unified Endpoint Management solutions

Starting with the 23.10.0 version, administrators can prevent end users from taking screenshots at the Citrix Workspace app level. This feature prevents sensitive or private information leaks. Administrators can configure this feature using an AppConfig-based key-value pair:

  • key: restrictScreenshot
  • value type: Boolean
  • value:

    ◈ If set to true, end users can’t take screenshots.

    ◈ If set to false, end users can take screenshots.

Push Citrix Workspace app settings through UEM

Previously, you could configure the store URL in the Citrix Workspace app.

Starting with this release, you can configure the Citrix Workspace app settings on the managed devices through any unified endpoint management (UEM) solutions tool that is deployed in your infrastructure.

Note:

As an administrator, if you have an option of configuring the Citrix Workspace app settings using UEM and the Global App Configuration service (GACS) where, UEM always takes a higher preference over GACS.

Configurations

The following JSON data is a sample from MS Intune that displays how to configure this feature.

{
    "kind": "androidenterprise#managedConfiguration",
    "productId": "app:com.citrix.Receiver",
    "managedProperty": [
        {
            "key": "stores",
            "valueBundleArray": [
                {
                    "managedProperty": [
                        {
                            "key": "url",
                            "valueString": ""
                        },
                        {
                            "key": "storeType",
                            "valueInteger": 1
                        },
                        {
                            "key": "displayName",
                            "valueString": ""
                        }
                    ]
                }
            ]
        },
        {
            "key": "url",
            "valueString": "prodcwa.cloud.com"
        },
        {
            "key": "storeType",
            "valueInteger": 1
        },
        {
            "key": "displayName",
            "valueString": ""
        },
        {
            "key": "restrict_user_store_modification",
            "valueBool": false
        },
        {
            "key": "restrictScreenshot",
            "valueBool": true
        },
        {
            "key": "appSettings",
            "valueBundleArray": [
                {
                    "managedProperty": [
                        {
                            "key": "name",
                            "valueString": ""
                        },
                        {
                            "key": "value",
                            "valueString": ""
                        },
                        {
                            "key": "userOverride",
                            "valueBool": false
                        }
                    ]
                }
            ]
        }
    ]
}

<!--NeedCopy-->

Key value pair table

The following table provides the key value pair information:

Setting Description Key Value Value type Default Value
Audio Allows users to control the audio and microphone connection within the app or desktop. audioRecordingSettingsKey Play and record String Play and record
Predictive text Enables text suggestions while the user is typing. predictiveText FALSE Boolean FALSE
Extended keyboard Enables support for the Extended keyboard in a session. showExtendedKeyboard TRUE Boolean TRUE
Generic USB Redirection Enables automatic redirection of arbitrary USB devices from the client device to the VDA. autoUSB TRUE Boolean FALSE
Session Disconnect User Confirmation (Ask before exiting) Prompts a confirmation dialog that allows the user to confirm before disconnecting any session. askBeforeExiting TRUE Boolean TRUE
Clipboard Redirection (Clipboard) Allows the user to use clipboard operations, such as, Cut, Copy, and Paste in a session. clipboardAccess TRUE Boolean FALSE
Adaptive Transport (EDT) Enables Enlightened Data Transport as a preferred protocol over TCP to optimize data transport. edtSetting TRUE Boolean TRUE
Display Orientation Allows users to select the display orientation based on the device position. displayOrientationKey Landscape mode String Automatic
Keep Display On Keeps the display active and the screen on. keepscreenOnKey TRUE Boolean FALSE
Strict Certificate Validation Enforces stricter control on the server certificate validation. strictcertificatevalidation TRUE Boolean FALSE
Legacy Store Access Allows users to access earlier versions of the store. allowlegacystoreaccess TRUE Boolean FALSE
RealTime Media Engine Enables support for high definition audio and video calls. RTMEAccess TRUE Boolean FALSE
Auto USB Redirection Enables automatic redirection of arbitrary USB devices from the client device to the VDA. autoUSB TRUE Boolean FALSE
Network Monitoring Messages Disables alert messages that provide details on the network performance. DisableChannelMonitoringWarnings FALSE Boolean FALSE
Extended Keys Shortcuts to be used for the session keyboard. key_map [“strAltTab”, “strAlt”, “strBackspace”, “strAltF4”] MultiList null
LaunchDarkly Enables the LaunchDarkly flag on the Citrix Workspace app features. enableLaunchDarkly TRUE Boolean TRUE

The following is an example JSON data. Here the example displays different setting values such as:

  • Boolean
  • Integer
  • String
  • List of strings
{
    "kind": "androidenterprise#managedConfiguration",
    "productId": "app:com.citrix.Receiver",
    "managedProperty": [
        {
            "key": "stores",
            "valueBundleArray": [
                {
                    "managedProperty": [
                        {
                            "key": "url",
                            "valueString": ""
                        },
                        {
                            "key": "storeType",
                            "valueInteger": 1
                        },
                        {
                            "key": "displayName",
                            "valueString": ""
                        }
                    ]
                }
            ]
        },
        {
            "key": "url",
            "valueString": "your_store_url"
        },
        {
            "key": "storeType",
            "valueInteger": 1
        },
        {
            "key": "displayName",
            "valueString": ""
        },
        {
            "key": "restrict_user_store_modification",
            "valueBool": false
        },
        {
            "key": "restrictScreenshot",
            "valueBool": true
        },
        {
            "key": "appSettings",
            "valueBundleArray": [
                {
                    "managedProperty": [
                        {
                            "key": "name",
                            "valueString": "showExtendedKeyboard"
                        },
                        {
                            "key": "value",
                            "valueString": "false"
                        },
                        {
                            "key": "userOverride",
                            "valueBool": false
                        }
                    ]
                },
                {
                    "managedProperty": [
                        {
                            "key": "name",
                            "valueString": "enterRegion"
                        },
                        {
                            "key": "value",
                            "valueString": "-40"
                        },
                        {
                            "key": "userOverride",
                            "valueBool": false
                        }
                    ]
                },
                {
                    "managedProperty": [
                        {
                            "key": "name",
                            "valueString": "displayOrientationKey"
                        },
                        {
                            "key": "value",
                            "valueString": "Landscape mode"
                        },
                        {
                            "key": "userOverride",
                            "valueBool": false
                        }
                    ]
                },
                {
                    "managedProperty": [
                        {
                            "key": "name",
                            "valueString": "askBeforeExiting"
                        },
                        {
                            "key": "value",
                            "valueString": "true"
                        },
                        {
                            "key": "userOverride",
                            "valueBool": false
                        }
                    ]
                },
                {
                    "managedProperty": [
                        {
                            "key": "name",
                            "valueString": "key_map"
                        },
                        {
                            "key": "value",
                            "valueString": "['strAltTab','strAlt','strBackspace','strAltF4']"
                        },
                        {
                            "key": "userOverride",
                            "valueBool": true
                        }
                    ]
                }
            ]
        }
    ]
}
<!--NeedCopy-->

Add many stores using UEM

Administrators can now use Unified Endpoint Management (UEM) solutions to configure many stores for managed Android devices.

The details for each store can be added to a JSON file. This JSON file can then be uploaded while configuring the app configuration policy. The details include:

  • store URL
  • store type (optional)

    Note:

    If the store type isn’t provided, then the default interface is considered as native.

  • store name (optional)

Note:

UEM supports one cloud store and many on-premises stores.

The JSON file must be in a key-value format. For more information, refer to the following sample JSON data:

Note:

The sample JSON data is related to Microsoft Intune. The JSON data might vary for other UEM solutions.

{
    "kind": "androidenterprise#managedConfiguration",
    "productId": "app:com.citrix.Receiver",
    "managedProperty": [
        {
            "key": "stores",
            "valueBundleArray": [
                {
                    "managedProperty": [
                        {
                            "key": "url",
                            "valueString": "test.cloud.com"
                        },
                        {
                            "key": "storeType",
                            "valueInteger": 1
                        },
                        {
                            "key": "displayName",
                            "valueString": "1"
                        }
                    ]
                },
                {
                    "managedProperty": [
                        {
                            "key": "url",
                            "valueString": "test2.cloud.com"
                        },
                        {
                            "key": "storeType",
                            "valueInteger": 2
                        },
                        {
                            "key": "displayName",
                            "valueString": "2"
                        }
                    ]
                }
            ]
        },
        {
            "key": "restrict_user_store_modification",
            "valueBool": false
        }
    ]
}
<!--NeedCopy-->

Note:

  • (default) If the integer is set to 1, users can view the native or the default store loading.

  • If the integer is set to 2, users can view the store inside a web interface.

To upload the JSON file that contains store configurations, select Enter JSON data from the Configuration settings format drop-down list.

Create app configuration policy