通过 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 组件版本的信息,请参阅系统要求。
如何部署
-
下载名为 stf-customization-AppP.zip 的 Zip 文件,其中包含您必须部署到 StoreFront 服务器计算机的所有必需文件。从 Citrix 下载 下载该文件。该文件包括以下内容:
- 必须复制到商店 bin 文件夹的 DLL
- 解决方案正常工作所需的 JavaScript 文件和其他文件
- deploy-solution.ps1 PowerShell script, which the StoreFront admin uses to deploy the solution
-
解压缩 stf-customization-AppP.zip 文件,并在文件解压缩的目录中打开新的管理员 PowerShell。运行
deploy-solution.ps1命令,该命令接受以下参数:-
-Action:脚本执行的操作。允许的值如下:-
Deploy操作以无缝方式部署解决方案。它会创建此解决方案更改的文件的备份,复制解决方案文件,并重新启动服务。以下屏幕截图描述了在 StoreFront 服务器上部署解决方案的命令:
-
ApplyUICustomization操作对商店 UI 应用自定义,以便您看不到 已安装 和 使用精简版 选项。此操作强制在浏览器中检测本机 Citrix Workspace 应用程序,并确保您绕过被阻止或不支持的场景。
-
RemoveUICustomization操作撤消ApplyUICustomization的操作,并且 已安装 和 使用精简版 选项再次出现。
-
-
-StoreName:必须执行操作的商店名称。此参数是强制性的,并且必须与Deploy操作一起传递。 -
-BackupDir:可与Deploy操作一起传递的参数,用于在所需目录中创建备份。如果未传递,则在桌面创建备份。此参数是可选参数。
-
注意:
如果在 StoreCustomization_Input.dll 或 StoreCustomization_Launch.dll 中存在任何已经存在的自定义设置,部署此解决方案将会覆盖掉这些自定义设置。
启用应用程序保护的应用程序和桌面仅在部署自定义项后显示。如果未部署,则应用程序和桌面不会显示。
如何还原 StoreFront 自定义项
执行以下步骤以还原上述 StoreFront 自定义项:
-
转到 \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> 目录中存在除上述文件之外的自定义文件,请根据需要将这些文件和目录复制到相关目录中。
-
打开 PowerShell 命令行管理程序。
-
请您按照以下说明运行命令,以停止 IISADMIN 和 CitrixSubscriptionsStore 这两个服务程序:
sc stop IISADMIN sc stop CitrixSubscriptionsStore <!--NeedCopy--> -
请执行以下命令,以再次启动 IISADMIN 和 CitrixSubscriptionsStore 这两个重要的服务实例:
sc start IISADMIN sc start CitrixSubscriptionsStore <!--NeedCopy-->
受保护资源的混合启动最终用户体验
-
管理员在 StoreFront 服务器上部署解决方案后,在客户端登录您的应用商店,然后使用 Web 浏览器中的 URL 访问 StoreFront。
-
要查看 Citrix Workspace 应用程序是否在浏览器中成功检测到,请检查您的帐户设置中的当前状态。

检测到 Citrix Workspace 应用程序后,您可以查看并启动所有已启用应用程序保护的虚拟应用程序和桌面。
在 StoreFront 上启用跟踪功能
要在 StoreFront 中启用跟踪,请参阅 StoreFront 文档。此跟踪可用于验证配置的 NetScaler Gateway 会话策略标签是否正确传递到应用商店。
故障排除
启动已启用应用程序保护的会话时,有时可能会遇到以下错误:

此错误的可能原因如下所示:
-
应用程序和桌面配置为在浏览器中打开。

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

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

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

解决方案:要纠正上述情况并启动启用了应用程序保护的会话,请在帐户设置中点击更改 Citrix Workspace 应用程序,然后等待 Citrix Workspace 应用程序被检测到。
优化方法
Citrix Workspace 应用程序检测是启动启用了应用程序保护的会话的强制要求。为避免在混合启动受保护会话时出现故障,StoreFront 管理员可以使用 deploy-solution.ps1 命令的 ApplyUICustomization 操作,并隐藏使用精简版和已安装选项。