Configure Citrix Receiver for Web sites

The tasks below enable you to modify settings for your Citrix Receiver for Web sites. Some advanced settings can only be changed by editing the site configuration files. For more information, see Configure Citrix Receiver for Web sites using the configuration files.

Important:

In multiple server deployments, use only one server at a time to make changes to the configuration of the server group. Ensure that the Citrix StoreFront management console is not running on any of the other servers in the deployment. Once complete, propagate your configuration changes to the server group so that the other servers in the deployment are updated.

Choose authentication methods

Use the Manage Authentication Methods task to assign authentication methods for users connecting to the Citrix Receiver for Web site. This action allows you to specify a subset of authentication methods for each Receiver for Web site.

  1. On the Windows Start screen or Apps screen, locate and click the Citrix StoreFront tile.

  2. Select the Stores node in the left pane of the Citrix StoreFront management console and select the relevant store that you want to modify from the Stores pane.

  3. In the Stores pane, click Manage Receiver for Web Sites, click Configure, and choose Authentication Methods to specify the access methods that you want to enable for your users.

    • Select User name and password to enable explicit authentication. Users enter their credentials when they access their stores.
    • Select SAML Authentication to enable integration with a SAML Identity Provider. Users authenticate to an Identity Provider and are automatically logged on when they access their stores. From the Settings drop-down menu:
      • Select Identity Provider to configure the trust to the Identity Provider.
      • Select Service Provider to configure the trust for the Service Provider. This information is required by the Identity Provider.
    • Select Domain pass-through to enable pass-through of Active Directory domain credentials from users’ devices. Users authenticate to their domain-joined Windows computers and are automatically logged on when they access their stores. In order to use this option, pass-through authentication must be enabled when Citrix Receiver for Windows or Citrix Workspace app for Windows is installed on users’ devices.

      Note:

      Domain pass-through for Citrix Receiver for Web is limited to Windows operating systems using Chrome, Firefox, and Internet Explorer.

    • Select Smart card to enable smart card authentication. Users authenticate using smart cards and PINs when they access their stores.
    • Select Pass-through from Citrix Gateway to enable pass-through authentication from Citrix Gateway. Users authenticate to Citrix Gateway and are automatically logged on when they access their stores.
  4. Once the authentication method has been selected, click OK.

    For more information about modifying settings for authentication methods, see Configure the authentication service.

Add resource shortcuts to other websites

Use the Add Shortcuts to Websites task to provide users with rapid access to desktops and applications from websites hosted on the internal network. You generate URLs for resources available through the Citrix Receiver for Web site and embed these links on your websites. Users click on a link and are redirected to the Citrix Receiver for Web site, where they log on if they have not already done so. The Citrix Receiver for Web site automatically starts the resource. In the case of applications, users are also subscribed to the application if they have not subscribed previously.

  1. On the Windows Start screen or Apps screen, locate and click the Citrix StoreFront tile.
  2. Select the Stores node in the left pane of the Citrix StoreFront management console and select the site from the results pane.
  3. In the Stores pane, click Manage Receiver for Web Sites, click Configure, and choose Website Shortcuts.
    1. Click Add to enter the URL for a website on which you plan to host shortcuts. URLs must be specified in the form http[s]://hostname[:port], where hostname is the fully qualified domain name of the website host and port is the port used for communication with the host if the default port for the protocol is not available. Paths to specific pages on the website are not required.
    2. Select the entry in the Websites list and click Edit to modify a URL.
    3. Select an entry in the list and click Remove to delete the URL for a website on which you no longer want to host shortcuts to resources available through the Citrix Receiver for Web site.
  4. Click Get shortcuts and then click Save when you are prompted to save your configuration changes.
  5. Log on to the Citrix Receiver for Web site and copy the URLs you require to your website.

Set session timeout

By default, user sessions on Citrix Receiver for Web sites time out after 20 minutes of inactivity. When a session times out, users can continue to use any desktops or applications that are already running but must log on again to access Citrix Receiver for Web site functions such as subscribing to applications.

Use the Session Timeout task in the Manage Receiver for Web Sites to change the session timeout value.

  1. On the Windows Start screen or Apps screen, locate and click the Citrix StoreFront tile.
  2. Select the Stores node in the left pane and in the Actions pane, click Manage Receiver for Web Sites, click Configure, choose Session Settings. You can specify minutes and hours for Session timeout. The minimum value for all time intervals is 1. The maximum equates to 1 year for each time interval.

Specify different views for applications and desktops

Use the Application and Desktops view on Receiver for Web task in the Manage Receiver for Web Sites to change the session timeout value.

  1. On the Windows Start screen or Apps screen, locate and click the Citrix StoreFront tile.
  2. Select the Stores node in the left pane and in the Actions pane, click Manage Receiver for Web Sites, click Configure, and choose Client Interface Settings.
  3. From the Select view and Default view drop-down menus, select the views you want displayed.

To enable folder view:

  1. On the Windows Start screen or Apps screen, locate and click the Citrix StoreFront tile.
  2. Select the Stores node in the left pane and in the Actions pane, click Manage Receiver for Web Sites and click Configure.
  3. Select Advanced Settings and check Enable folder view.

Stop offering provisioning files to users

By default, Citrix Receiver for Web sites offer provisioning files that enable users to configure Citrix Receiver or Citrix Workspace app automatically for the associated store. The provisioning files contain connection details for the store that provides the resources on the site, including details of any Citrix Gateway deployments and beacons configured for the store. In this article, mentions of “Citrix Workspace app” also represent the supported versions of Citrix Receiver unless otherwise noted.

Use the Enable Receiver configuration task in the Manage Receiver for Web Sites to change the session timeout value.

  1. On the Windows Start screen or Apps screen, locate and click the Citrix StoreFront tile.
  2. Select the Stores node in the left pane and in the Actions pane, click Manage Receiver for Web Sites, click Configure, and choose Client Interface Settings.
  3. Select Enable Receiver/Workspace app configuration.

Configure site behavior for users without Citrix Workspace app

Use the Deploy Citrix Receiver/Workspace app task to configure the behavior of a Citrix Receiver for Web site when a Windows or Mac OS X user without Citrix Workspace app installed accesses the site. By default, Citrix Receiver for Web sites automatically attempt to determine whether Citrix Workspace app is installed when accessed from computers running Windows or Mac OS X.

If Citrix Workspace app cannot be detected, the user is prompted to download and install it for their platform. The default download location is the Citrix website, but you can also copy the Citrix Workspace app installers to the StoreFront server and allow users to download copies of these directly from the StoreFront server instead.

For users who cannot install Citrix Workspace app, you can enable Citrix Workspace app for HTML5 (formerly Citrix Receiver for HTML5) on your Citrix Receiver for Web sites. Citrix Workspace app for HTML5 enables users to access desktops and applications directly within HTML5-compatible web browsers without needing to install Citrix Workspace app. Both internal network connections and connections through Citrix Gateway are supported. However, for connections from the internal network, Citrix Workspace app for HTML5 only enables access to resources provided by specific products. Additionally, specific versions of Citrix Gateway are required to enable connections from outside the corporate network. For more information, see Infrastructure requirements.

For local users on the internal network, access through Citrix Workspace app for HTML5 to resources provided by Citrix Virtual Apps and Desktops is disabled by default. To enable local access to desktops and applications using Citrix Workspace app for HTML5, you must enable the ICA WebSockets connections policy on your Citrix Virtual Apps and Desktops servers. Citrix Virtual Apps and Desktops uses port 8008 for Citrix Workspace app for HTML5 connections. Ensure your firewalls and other network devices permit access to this port. For more information, see WebSockets policy settings.

For Citrix Virtual Apps and Desktops resource launches to succeed using Citrix Workspace app for HTML5 when connecting directly to StoreFront, TLS connections to the VDAs that host apps and desktops must be configured. Remote connections through a Citrix Gateway can launch resources using Citrix Workspace app for HTML5 without configuring TLS connections to the VDA.

  1. On the Windows Start screen or Apps screen, locate and click the Citrix StoreFront tile.
  2. Select the Stores node in the left pane of the Citrix StoreFront management console and, in the results pane, select a site. In the Actions pane, click Manage Receiver for Web Sites and click Configure.
  3. Choose Deploy Citrix Receiver/Workspace app and specify a Deployment option.

    • select Always use Receiver for HTML5 if you want the site always to access resources through an HTML5-compatible browser without prompting the user to download and install Citrix Workspace app. With this option selected, users always access desktops and applications on the site through Citrix Workspace app for HTML5, provided they use an HTML5-compatible browser. Users without an HTML5-compatible browser cannot access resources. Access through any locally installed Citrix Workspace app is disabled.
    • select Use Receiver for HTML5 if local Receiver is unavailable if you want the site to prompt the user to download and install Citrix Workspace app, but fall back to Citrix Workspace app for HTML5 if Citrix Workspace app cannot be installed. Users without Citrix Workspace app are prompted to download and install it every time they log on to the site.
    • select Install locally if you want the site always to access resources through a locally installed Citrix Workspace app. Users are prompted to download and install the appropriate Citrix Workspace app for their platform. Access through HTML5-compatible browsers is disabled.
      • If you select Allow users to download HDX engine (plug in), the Citrix Receiver for Web allows the user to download and install Citrix Workspace app on the end user client if the Citrix Workspace app is not available.
      • If you select Upgrade plug-in at logon, the Citrix Receiver for Web offers users a choice to upgrade the Citrix Workspace app client when they log on. Users may choose to skip the upgrade and will not be prompted to upgrade again unless Citrix Receiver for Web browser cookies are cleared. To enable this feature, ensure the Citrix Workspace app files are available on the StoreFront server.
      • Select a source from the drop-down list.

Make Citrix Workspace app installation files available on the server

By default, when a user accesses a Citrix Receiver for Web site from a computer running Windows or Mac OS X, the site attempts to determine whether Citrix Workspace app is installed on the user’s device. If Citrix Workspace app cannot be detected, the user is prompted to download and install it for their platform from the Citrix website or by downloading the correct installer from the StoreFront server.

  1. On the Windows Start screen or Apps screen, locate and click the Citrix StoreFront tile.
  2. Select the Stores node in the left pane of the Citrix StoreFront management console and, in the results pane, select a site. In the Actions pane, click Manage Receiver for Web Sites and click Configure.
  3. Choose Deploy Citrix Receiver/Workspace app and Source for Receivers/Workspace app, and then browse to the installation files.

Run the prompt to install Citrix Workspace app after logon

Before logging on to StoreFront, Citrix Receiver for Web prompts a user to install the latest Citrix Workspace app if it is not already installed on the user’s computer. Depending on the configuration, the prompt may also display if the user’s installation of Citrix Workspace app can be upgraded.

You can configure Citrix Receiver for Web to display the prompt after logging on to StoreFront.

  1. On the Windows Start screen or Apps screen, locate and click the Citrix StoreFront tile.
  2. Select the Stores node in the left pane of the Citrix StoreFront management console and select the site from the results pane.
  3. In the Actions pane, click Manage Receiver for Web Sites, click Configure.
  4. Select Advanced Settings and check Prompt to install Citrix Receiver/Workspace app after logon.

Remove Citrix Receiver for Web sites

Use the Manage Receiver for Web Sites in the Actions pane to delete a Citrix Receiver for Web site. When you remove a site, users can no longer use that webpage to access the store.