Citrix Workspace

Email based discovery

Email based discovery service allows end users to sign in automatically to the store on their Citrix Workspace app using their email addresses. Thus, users don’t need to enter their store URLs.

Setup email based discovery for cloud stores

To enable email based discovery 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.

Setup email-based discovery for on-premises stores

To enable email-based discovery for on-premises 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

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

Note:

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

Email based discovery