Configure settings for cloud stores

Overview

You can configure Citrix Workspace app settings for cloud stores using the Global App Configuration service (GACS). It helps admins configure and manage Citrix Workspace app for end users on both managed and unmanaged devices. This service is supported on Windows, Mac, Android, iOS, HTML5, and ChromeOS platforms.

Prerequisites

  • The addresses <https://discovery.cem.cloud.us>, <https://gacs-discovery.cloud.com>, and <https://gacs-config.cloud.com> must be contactable. It’s required for the functioning of email-based discovery and Global App Configuration services.

  • Verify that you have access to a Citrix Cloud account. If not, you can create an account from https://onboarding.cloud.com/. For more information, refer to Sign up for Citrix Cloud.

    Onboarding

  • Verify that you have a Workspace subscription.

Get started with configuration

You can sign in to your Citrix Cloud account and configure settings from Workspace Configuration > App Configuration. Before proceeding, verify if you have the following permissions.

  • Workspace subscription: The Workspace subscription is required to create a Workspace URL. If you don’t have a subscription, you can’t add and configure cloud stores. You’ll only be presented with an option to configure on-premises stores.

  • Workspace URL: If you have a Workspace subscription but haven’t added your URL yet, you are presented with the following screen. You can click Claim URL under the App Configuration section to claim your URL.

Claim URL

Configure settings

You can configure settings for Citrix Workspace app from the Citrix Cloud portal. If multiple stores have been configured for your organization, you can configure each of the stores separately.

  1. Sign in to Citrix Cloud.
  2. Navigate to Workspace Configuration > App Configuration.
  3. From the list of configured store URLs, select the store for which you want to map settings and then click Configure.

    URL list

  4. Modify the settings for your preferred platforms as per your requirement.
  5. Click Publish Drafts to save the settings.

Note:

It might take a few hours for the settings to be updated to the Citrix Workspace app clients. For more information, see Frequency of fetching updated settings.

Manage settings for user group using configuration profiles

This section explains how administrators can use the configuration profile feature in the Global App Configuration service (GACS) to configure settings for user groups who use cloud stores of Citrix Workspace app.

To get started with this feature, administrators need to verify that their Citrix Workspace app version is compatible, as shown in the following table:

Citrix Workspace app platform Minimum supported version
Windows 2405
Mac 2405.11

Configuration

For instructions on leveraging configuration profile to assign settings to a user group, see Manage settings for user group using configuration profile.

Setup email based discovery

Email based discovery service allows end users to sign in automatically using their email addresses. To enable this service for cloud stores, do the following steps:

  1. Claim a domain

  2. Create a domain to URL mapping

Claim a domain

To claim a domain:

  1. Sign in to Citrix Cloud.

  2. Navigate to Workspace Configuration > Email Discovery.

  3. Click Add Domain.

  4. Enter the domain that you want to claim (For example, ace.example.com).

    email-discovery

  5. Click Add.

    You can see the domain is added on the Email Discovery page.

    The domain claim status is shown as Not Started. You need to verify the domain as shown in the following steps:

  6. Click the ellipsis menu (), and then select Verify domain.

    Verify domain

  7. Copy the DNS token displayed on the screen, and click Start Check.

    Start verification check

The status of your domain changes to Pending.

Once the verification is completed, the status of your domain changes from Pending to Verified.

Note:

You can claim a maximum of 10 domains. If you want to claim more than 10 domains, contact Citrix Support and provide your Customer ID.

Create a domain to URL mapping

Once the domain is verified, you can map URLs as shown in the following steps:

  1. Navigate to Workspace Configuration > Email Discovery.
  2. Go to the domain that you have added and click the mapped store URL.

    Mapped store URL

  3. Select the claimed URLs from the dropdown menu.

    Select the verified URLs

  4. Click Save.

Alternatively, you can map a URL manually using the Enter a URL manually option. For that:

  1. Click the Enter a URL manually option.

    Enter a URL manually

  2. Enter the store URL that you want to map to this domain.
  3. Click Add.

Note:

It is mandatory to include port number 443 in the store URL. For example, https://example.cloud.com:443.

Configure settings for cloud stores