StoreFront

Email-based account discovery

July 22, 2024

Contributed by:

C S

Configure email-based account discovery to enable users who install Citrix Workspace app on a device for the first time to set up their accounts without needing to know the store URL by entering their email addresses.

During the initial configuration process, Citrix Workspace app prompts users to enter either an email address or a store URL. If the user enters an email address, Citrix Workspace app looks up the email domain in a number of locations to determine the StoreFront server. It then lists all visible stores for the user to choose from.

Citrix recommends using the Global App Config Service to configure email discovery. As an alternative you can configure email discovery using either DNS SVR records or a DNS alias.

Global App Config Service

To configure email discovery using the Global App Config Service, see Setup email based discovery.

DNS SVR records records

As an alternative to Global App Config Service, you can use DNS SVR records to configure which StoreFront server Citrix Workspace app should use for an email domain.

On your DNS server for your email domain add a SRV record with the following properties:

Property	Value
Service	_citrixreceiver
Proto	TCP
Target	The fully qualified domain name (FQDN) and port for your Citrix Gateway appliance (to support both local and remote users) or StoreFront server (to support local users only) in the form servername.domain:port.

If your environment includes both internal and external DNS servers, you can add a SRV record specifying the StoreFront server FQDN on your internal DNS server and another record on your external server specifying the Citrix Gateway FQDN. With this configuration, local users are provided with the StoreFront details, while remote users receive Citrix Gateway connection information.

DNS discoverReceiver record

As a fallback to the other methods, you can create an DNS alias to the StoreFront server discoverReceiver on the email domain. For example if your email domain is example.com, create a DNS alias called discoverReceiver.example.com. If no SRV record is found in the specified domain, Citrix Workspace app searches for a machine named “discoverReceiver” to identify a StoreFront server.

If you use this mechanism, ensure that discoverReceiver is included as a subject alternate name in the HTTPS certificate for your StoreFront server.

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

Email-based account discovery

July 22, 2024

Contributed by:

C S

July 22, 2024

Contributed by:

C S

Email-based account discovery

Global App Config Service

DNS SVR records records

DNS discoverReceiver record

In this article