Citrix Workspace 应用程序

通过 StoreFront 进行混合启动的应用保护支持

Citrix Virtual Apps and Desktops 的混合启动是指您在本地浏览器中键入商店 URL 登录 StoreFront for Web,并通过本地 Citrix Workspace 应用程序及其 HDX 引擎启动虚拟应用程序和桌面。术语“混合”是使用 StoreFront for Web 和本地 Citrix Workspace 应用程序组合连接和使用资源的结果。

注意:

当端点上未安装任何本地 Citrix Workspace 应用程序组件时,这是一种零安装配置,其中 Citrix Workspace 商店和 HDX 引擎都位于浏览器中。此方案称为 Citrix Workspace app for HTML5,它托管在 Citrix Workspace 或 Citrix StoreFront 上。本文档不涉及此方案。

App Protection 对通过 StoreFront 进行混合启动的支持使启用了 App Protection 的资源能够从浏览器中显示和启动。

注意:

如果您选择“使用精简版”(使用 HTML5 客户端)或“已安装”选项,则启用了 App Protection 的会话将被阻止,因为浏览器中未成功检测到 Citrix Workspace 应用程序。

如果您使用的是 StoreFront 2308 或更高版本,则如果 StoreFront 配置得当且浏览器成功检测到本地 Citrix Workspace 应用程序,您可以使用 Web 浏览器访问启用了 App Protection 策略的应用程序和桌面。如果您使用的是 StoreFront 1912 到 2203 之间的版本,则必须按照 (/zh-cn/citrix-workspace-app/app-protection/app-protection-hybrid-launch-storefront#how-to-deploy) 部分中所述应用自定义。

限制:

StoreFront 在您首次登录网站时确定 Citrix Workspace 应用程序版本。如果您以后安装了不同版本的 Citrix Workspace 应用程序,StoreFront 不会知道此更改。因此,它可能会错误地允许或禁止启动启用了 App Protection 策略的虚拟应用程序和桌面。Citrix 建议配置 App Protection 姿态检查,该检查会阻止从不支持 App Protection 的早期版本 Citrix Workspace 应用程序启动虚拟应用程序和桌面。有关姿态检查的更多信息,请参阅 (/zh-cn/citrix-workspace-app/app-protection/features#posture-check)。

通过 StoreFront 2308 或更高版本进行混合启动

StoreFront 2308 版本包含对启用了 App Protection 策略的虚拟应用程序和桌面混合启动的支持,但此功能默认处于禁用状态。有关在 StoreFront 2308 或更高版本上为混合启动启用 App Protection 的更多信息,请参阅 (/zh-cn/storefront/current-release/manage-citrix-receiver-for-web-site/app-protection)。

通过 StoreFront 1912 到 2203 版本进行混合启动

StoreFront 1912 到 2203 版本支持通过以下自定义启用启用了 App Protection 策略的虚拟应用程序和桌面的混合启动:

Citrix 建议在升级到 StoreFront 2308 或更高版本时删除此自定义。

先决条件

有关 App Protection 所需的 Citrix 组件版本的信息,请参阅系统要求

如何部署

  1. 下载名为 stf-customization-AppP.zip 的 Zip 文件,其中包含您必须部署到 StoreFront 服务器计算机的所有必需文件。从 Citrix 下载 下载该文件。该文件包括以下内容:

    • 必须复制到商店 bin 文件夹的 DLL
    • 解决方案正常工作所需的 JavaScript 文件和其他文件
    • deploy-solution.ps1 PowerShell script, which the StoreFront admin uses to deploy the solution
  2. 解压缩 stf-customization-AppP.zip 文件,并在文件解压缩的目录中打开新的管理员 PowerShell。运行 deploy-solution.ps1 命令,该命令接受以下参数:

    • -Action:脚本执行的操作。允许的值如下:

      • Deploy 操作以无缝方式部署解决方案。它会创建此解决方案更改的文件的备份,复制解决方案文件,并重新启动服务。以下屏幕截图描述了在 StoreFront 服务器上部署解决方案的命令:

        部署

      • ApplyUICustomization 操作对商店 UI 应用自定义,以便您看不到 已安装使用精简版 选项。此操作强制在浏览器中检测本机 Citrix Workspace 应用程序,并确保您绕过被阻止或不支持的场景。

        UI 自定义

      • RemoveUICustomization 操作撤消 ApplyUICustomization 的操作,并且 已安装使用精简版 选项再次出现。

    • -StoreName:必须执行操作的商店名称。此参数是强制性的,并且必须与 Deploy 操作一起传递。
    • -BackupDir:可与 Deploy 操作一起传递的参数,用于在所需目录中创建备份。如果未传递,则在桌面创建备份。此参数是可选参数。

注意:

如果在 StoreCustomization_Input.dllStoreCustomization_Launch.dll 中存在任何已经存在的自定义设置,部署此解决方案将会覆盖掉这些自定义设置。

启用应用程序保护的应用程序和桌面仅在部署自定义项后显示。如果未部署,则应用程序和桌面不会显示。

如何还原 StoreFront 自定义项

执行以下步骤以还原上述 StoreFront 自定义项:

  1. 转到 \Desktop\StoreBackup<store name> 目录并将以下文件复制到相应的目录中:

    • StoreCustomization_Input.dll and StoreCustomization_Launch.dll files to the IISINETPub\Citrix<store name>\bin directory
    • web.config file to the IISINETPub\Citrix\StoreWeb directory
    • *.js and style.css files to the IISINETPub\Citrix\StoreWeb\Custom directory

      注意:

      如果 \Desktop\StoreBackup<store name> 目录中存在除上述文件之外的自定义文件,请根据需要将这些文件和目录复制到相关目录中。

  2. 打开 PowerShell 命令行管理程序。

  3. 请您按照以下说明运行命令,以停止 IISADMINCitrixSubscriptionsStore 这两个服务程序:

    sc stop IISADMIN
    sc stop CitrixSubscriptionsStore
    <!--NeedCopy-->
    
  4. 请执行以下命令,以再次启动 IISADMINCitrixSubscriptionsStore 这两个重要的服务实例:

    sc start IISADMIN
    sc start CitrixSubscriptionsStore
    <!--NeedCopy-->
    

受保护资源的混合启动最终用户体验

  1. 管理员在 StoreFront 服务器上部署解决方案后,在客户端登录您的应用商店,然后使用 Web 浏览器中的 URL 访问 StoreFront。

  2. 要查看 Citrix Workspace 应用程序是否在浏览器中成功检测到,请检查您的帐户设置中的当前状态

    当前状态

    检测到 Citrix Workspace 应用程序后,您可以查看并启动所有已启用应用程序保护的虚拟应用程序和桌面。

在 StoreFront 上启用跟踪功能

要在 StoreFront 中启用跟踪,请参阅 StoreFront 文档。此跟踪可用于验证配置的 NetScaler Gateway 会话策略标签是否正确传递到应用商店。

故障排除

启动已启用应用程序保护的会话时,有时可能会遇到以下错误:

错误

此错误的可能原因如下所示:

  • 应用程序和桌面配置为在浏览器中打开。

    故障排除 1

    如果您在 Citrix Workspace 应用程序检测期间单击了使用精简版本,则会出现此情况,如以下屏幕所示:

    选项

  • 浏览器未检测到 Citrix Workspace 应用程序。

    故障排除 2

    如果您在检测 Citrix Workspace 应用程序时点击了已安装,则会出现此情况,如下图所示:

    选项

解决方案:要纠正上述情况并启动启用了应用程序保护的会话,请在帐户设置中点击更改 Citrix Workspace 应用程序,然后等待 Citrix Workspace 应用程序被检测到。

优化方法

Citrix Workspace 应用程序检测是启动启用了应用程序保护的会话的强制要求。为避免在混合启动受保护会话时出现故障,StoreFront 管理员可以使用 deploy-solution.ps1 命令的 ApplyUICustomization 操作,并隐藏使用精简版已安装选项。

通过 StoreFront 进行混合启动的应用保护支持