Configure settings for on-premises stores

Overview

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

Prerequisite

  • 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 the email-based discovery and Global App Configuration service.

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

  • In an on-premises environment, you must claim a URL before you can configure settings. For more information, see Claim a URL.

Get started

To configure settings for an on-premises store, sign in to your Citrix Cloud account and navigate to Workspace Configuration > App Configuration. If you have claimed ownership for your StoreFront URL, you’re presented with the following screen where you can start configuring settings. For more information, see the Configure settings section.

URL ownership screen

If you have not yet claimed ownership for your StoreFront URL, you are presented with the following screen that prompts you to secure your URL before proceeding. For more information, refer to Claim a URL for on-premises stores.

 Pending claims

Claim a URL for on-premises stores

It’s mandatory to establish a claim to your URL before you start configuring the settings for it.

To claim a URL:

  1. Go to <https://adsui.cloud.com/url> and sign in with your Citrix Cloud credentials.
  2. Navigate to Claims > URLs > Add URL.
  3. Enter the URL that you want to claim.
  4. Click Confirm. The verification pop-up appears.

    Note:

    If the on-premises environment does not have a NetScaler Gateway installed, you won’t be able to perform the verification process (from Step 5 onwards). In this case, perform Steps 1 through 4 as described in the preceding procedure and contact our Support team with your Customer Id and the URL that you want to claim.

  5. If you have a NetScaler Gateway installed in your on-premises setup, you can verify your URL using the following steps.

    1. Copy the token that appears on the pop-up.
    2. Create and configure a responder action and responder policy within your Citrix ADC.
    3. Bind your responder policy globally.
    4. Go to https://<customergatewayurl>/vpn/CitrixClaims to verify if your responder policy is configured correctly.
    5. Navigate back to Claims > URLs, and locate the URL that you added.
    6. Click the ellipsis menu icon for the added URL.
    7. Select Verify URL.
    8. Click Start Claim Check to start the verification process.

    Once the configuration is completed, the status of your domain changes from pending to verified.

Configure settings

You can configure settings for Citrix Workspace app, once you’ve claimed the URL. If multiple stores have been configured for your company, you can configure the settings for each of them separately.

  1. Go to the Citrix Cloud portal and sign in using your credentials.
  2. Navigate to Workspace Configuration > App Configuration.
  3. Click Switch URL to select the store for which you want to configure settings.

    Switch url

  4. From the list of configured store URLs, select the one for which you want to map settings and then click Save. URL list

  5. Modify the settings for your preferred platforms as per your requirement.
  6. 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.

Setup email-based discovery

Email based discovery service allows end users to sign in automatically using their email addresses. They aren’t required to furnish their store URLs. To enable this service for cloud stores, you need to perform the following steps.

  1. Claim a domain

  2. Create a domain to URL mapping

Claim a domain

To claim a domain:

  1. Go to the AutoDiscovery service.

  2. Navigate to Claims > Domains > Add Domain.

  3. Enter the domain that you want to claim (for example, ace.example.com).

  4. Click Confirm.

  5. Copy the DNS token that appears on the screen to the clipboard.

  6. To create a DNS TXT record, go to the service-provider portal and add the DNS token.

  7. To start the verification process:

    1. Navigate to Claims > Domains.
    2. Go to the domain that you added and click the ellipsis menu.
    3. Select Verify Domain.
    4. Click Start DNS Check.

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 and URL.

Create a domain to URL mapping

  1. Navigate to Claims > Domains.
  2. Go to the domain that you added and click the ellipsis menu.
  3. Click Add Another Server URL.
  4. Enter the store URL that you want to map to this domain and save.
Configure settings for on-premises stores