Licensing

Asset ID

About this feature

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

How to configure

By default, Citrix Workspace app continues to generate a unique client ID for enrolled Chromebooks, which is similar to earlier versions. To use this feature, you must set a policy for Citrix Workspace app.

The data value that you enter can’t have more than 15 characters. Values longer than 15 characters are truncated to 15 characters.

Configuring Asset ID

  1. Log on to the Google Admin Console.

  2. Go to Device Management > Chrome > Devices Console and add Asset ID for the device.

  3. Edit the Google Admin Console policy and set the value of useAssetID to true. By default, the useAssetID is set to false.

    { "settings": { "Value": { "settings_version": "1.0", "engine_settings": { "uniqueID": { "useAssetID": true } } } } }

Known limitations in the feature

  • 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 more than 15 characters. Values longer than 15 characters are truncated to 15 characters.

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.

How to configure

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 is 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.

Known limitations in the feature

  • 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.

Asset ID character limit increase

Previously, the current asset ID feature had a maximum limit of 15 characters.

Starting with the 2502 version, the asset ID feature supports up to 20 characters.

Note:

This feature is disabled by default.

How to configure

For managed devices and users, administrators can enable the feature using the Google Admin Policy as follows:

  1. Sign in to the Google Admin Policy.
  2. Go to Device management > Chrome Management > User Settings.
  3. Add the following strings to the policy.txt file under the engine_settings key. You can apply this configuration to the following:

    Notes:

    You can apply this configuration on the following as well:

    • Device > Chrome > Apps and extensions > Users and browsers > Search for the extension > Policy for extensions.
    • Device > Chrome > Apps and extensions > Kiosks > Search for the extension > Policy for extensions.
    • Device > Chrome > Apps and extensions > Managed guest sessions > Search for the extension > Policy for extensions.
  4. Make sure you set the attribute useMaxAssetIDLimit to true.

    Note:

    The useMaxAssetIDLimit configuration applies only when useAssetID is set to true.

    The following is an example of JSON data for useMaxAssetIDLimit:

    { "settings": { "Value": { "settings_version": "1.0", "engine_settings": { "uniqueID": { "useMaxAssetIDLimit": true } } } } }
  5. Save the changes.
Licensing