Citrix Workspace app deployment
By default, when a user first opens a store in their web browser on Windows, macOS, or Linux, StoreFront attempts to determine whether Citrix Workspace app is installed locally. If a locally deployed Citrix Workspace app cannot be detected, the user is prompted to download and install it. The default download location is the Citrix website, but you can also host the installers on the StoreFront server or elsewhere. Once it is installed, users can either open the locally installed Citrix Workspace app and connect it to the store, or continue in their browser but connect to virtual apps and desktops in their locally installed Citrix Workspace app HDX client.
Alternatively, users who cannot install Citrix Workspace app locally can use a web browser to both access the store and to connect to virtual apps and desktops.
To modify deployment options, go to Edit Receiver for web site and select the Deploy Citrix Receiver/Workspace app tab.
Deployment option
- Select Always use Receiver for HTML5 if you want the user to always to access resources through a web browser without prompting the user to download and install Citrix Workspace app locally. With this option selected, Workspace for HTML5 users always access resources directly through their browsers.
- Select Use Receiver for HTML5 if local Receiver is unavailable if you want the store web site to prompt the user to download and install Citrix Workspace app locally, but fall back to accessing resources through a browser 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. Users can continue to access the store through a web browser but when the launch a resource it opens in the locally installed Workspace app.
Launch applications in the same tab
If you have chosen Always use Receiver for HTML5 or Use Receiver for HTML5 if local Receiver is unavailable, by default, resources launched in the browser open a new browser tab. If you want your resources to open in the same tab, replacing Workspace app for HTML5, select Launch applications in the same tab as Receiver for Web.
Show the Already installed option on the client detection page
Note:
This setting is applicable only for Windows, MacOS, and Linux devices. If a user has installed Workspace web extensions, then the client detection and launch is handled by the web extensions. In such cases, this setting is not applicable.
When end users open a store in their browser for the first time on Windows, macOS, or Linux, the website attempts to detect the locally installed app using the Citrix Workspace launcher. Subsequently, when a user launches a resource, the Citrix Workspace launcher communicates with the locally installed Citrix Workspace app. If users click the Already installed option, the client detection process is skipped. As a result, when the user launches a resource, an .ica
file is downloaded that users can open with their locally installed Citrix Workspace app. This does not support features such as domain pass-through and app protection.
This downloaded .ica
file may pose a security risk. Citrix recommends that you clear the Show Already installed link on the client detection page checkbox to hide the already installed option.
Prevent Ica downloads on all platforms
This provides an additional level of protection by completely blocking .ica
downloads across all platforms. As Citrix Workspace launcher is not available on iOS, Android or Chrome, users must either select Use Light version if available, or they must add their store to their locally installed Citrix Workspace app.
Important:
This option should not be used in conjunction with the Show Already installed option on the client detection page.
Allow users to download Citrix Workspace app
If you select Allow users to download HDX engine (plug in), the first time a user logs on to a device on Windows or Mac, they are given the option to download the app.
Warning:
If you clear Allow users to download HDX engine (plug in) then this disables in-memory ICA launches, which causes users to download ICA files. Therefore it is recommended that you enable this setting even if you deploy Citrix Workspace app using other mechanisms.
This is not available if you have chosen Deployment option of Always use Receiver for HTML5.
Upgrade Workspace app on logon
If you select Upgrade plug-in at logon, Workspace app for HTML5 offers users a choice to upgrade the Citrix Workspace app locally installed client when they log on. Users may choose to skip the upgrade and will not be prompted to upgrade again unless their browser cookies are cleared. To enable this feature, ensure the Citrix Workspace app files are available on the StoreFront server.
Download source
When end users click the download button you can choose whether they are redirected to the Citrix website or to download files directly from the server. You can choose Citrix website, Local files on the StoreFront server or Files on remote server (through URL).
PowerShell SDK
To configure these settings using the Powershell SDK, use cmdlet Set-STFWebReceiverPluginAssistant.
To configure Prevent ICA Downloads, use cmdlet Set-STFWebReceiverUserInterface with parameter PreventIcaDownloads
.