Citrix Virtual Apps and Desktops

面向 StoreFront 的混合启动的应用程序保护

January 19, 2023

投稿者:

Citrix Virtual Apps and Desktops 的混合启动是指您登录适用于 Web 的 StoreFront（通过在本机浏览器中键入应用商店 URL），然后通过本机 Citrix Workspace 应用程序及其 HDX 引擎启动虚拟应用程序和桌面。“混合”一词是结合使用适用于 Web 的 StoreFront 与本机 Citrix Workspace 应用程序来连接和使用资源的结果。

注意：

如果没有在端点上安装本机 Citrix Workspace 应用程序组件，则为零安装配置，其中 Citrix Workspace 应用商店和 HDX 引擎都位于浏览器中。这称为适用于 HTML5 的 Citrix Workspace 应用程序，托管在 Citrix Workspace 或 Citrix StoreFront 上。本文档未涉及这种情况。

面向 StoreFront 的混合启动的应用程序保护允许枚举启用了应用程序保护的资源并从浏览器启动这些资源。

注意：

如果您选择 Use light version（使用简易版本）（使用 HTML5 客户端）或 Already installed（已安装）选项，则启用了应用程序保护的会话将被阻止，因为未在浏览器中成功检测到 Citrix Workspace 应用程序。

如果部署了 StoreFront 自定义设置，并且在浏览器中成功检测到本机 Citrix Workspace 应用程序，则可以使用 Web 浏览器访问启用了应用程序保护的应用程序和桌面。请参阅部署方法部分。

必备条件

请确保您使用的是 Citrix Workspace 应用程序版本 1912 LTSR 或更高版本，以及 StoreFront 版本 3.12 或更高版本。有关应用程序保护所需的 Citrix 组件版本的详细信息，请参阅系统要求。

部署方法

下载名为 stf-customization-AppP.zip 的 Zip 文件，其中包含必须部署到 StoreFront 服务器计算机的所有必需文件。从 Citrix 下载中下载该文件。该文件包括以下内容：
- 必须复制到应用商店的 bin 文件夹的 DLL
- 解决方案正常运行所需的 JavaScript 文件和其他文件
- deploy-solution.ps1 PowerShell 脚本，StoreFront 管理员使用该脚本来部署解决方案
解压缩 stf-customization-AppP.zip 文件并打开一个新的管理员 PowerShell，在该位置解压相关文件。运行 deploy-solution.ps1 命令，该命令采用以下参数：
- -Action：脚本采取的操作。允许使用的值如下：
  - Deploy 操作以无缝方式部署解决方案。它会创建此解决方案变更的文件的备份，复制解决方案文件，然后重新启动服务。以下屏幕截图描述了在 StoreFront 服务器上部署解决方案的命令：
  - ApplyUICustomization 操作对应用商店 UI 应用自定义设置，因此您看不到 Already installed（已安装）和 Use light version（使用简易版本）选项。此操作强制检测浏览器中的本机 Citrix Workspace 应用程序，并确保您绕过被阻止或不支持的情况。
  - RemoveUICustomization 操作会撤消 ApplyUICustomization 操作，并再次显示 Already Installed（已安装）和 Use light version（使用简易版本）选项。
- -StoreName：必须对其采取操作的应用商店的名称。此参数是强制性的，必须与 Deploy 操作一起传递。
- -BackupDir：可以在所需目录下创建备份的 Deploy 操作中传递的参数。如果未通过，则在桌面上创建备份。这是可选参数。

注意：

如果 StoreCustomization_Input.dll 或 StoreCustomization_Launch.dll 中有任何现有的自定义设置，则部署此解决方案会覆盖这些自定义设置。

启用了应用程序保护的应用程序和桌面只有在部署自定义设置后才会枚举。如果未部署，应用程序和桌面就无法枚举。

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

管理员在 StoreFront 服务器上部署解决方案后，请在客户端登录您的应用商店。然后在 Web 浏览器中使用 URL 访问 StoreFront。
要查看浏览器中是否成功检测到 Citrix Workspace 应用程序，请检查帐户设置中的当前状态。
成功检测到 Citrix Workspace 应用程序后，您可以查看并启动启用了应用程序保护的所有虚拟应用程序和桌面。

在 StoreFront 上启用跟踪

可以在 StoreFront 上启用跟踪来收集日志。跟踪功能将详细信息写入跟踪中。此跟踪可用于验证配置的 NetScaler Gateway 会话策略标签是否已正确传递到应用商店。StoreFront 服务器上的跟踪转储的默认位置为 C:\Program Files\Citrix\Receiver StoreFront\Admin\trace。

要启用跟踪并设置跟踪级别，请使用 PowerShell 脚本 SetDSStoreCustomizationTraceLevel.ps1。此脚本随此处的公共 StoreFront 自定义 SDK 一起提供。该脚本采用以下参数：

SiteId：部署了应用商店的 IIS 站点 ID
VirtualPath：应用商店的虚拟路径
TraceLevel：设置跟踪级别，即“错误”、“信息”、“关闭”、“详细”和“警告”

运行以下 PowerShell 命令以了解应用商店的 SiteId 和 VirtualPath：cd 'c:\program files\Citrix\Receiver Storefront\Scripts'. .\ImportModules.ps1 Get-DSStoreFeatureInstances

运行 PowerShell 脚本 SetDSStoreCustomizationTraceLevel.ps1 时，请使用从命令中检索到的 SiteId 和 VirtualPath。

故障排除

启动启用了应用程序保护的会话时，您有时会遇到以下错误：

此错误的可能原因如下：

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

如果您在 Citrix Workspace 应用程序检测期间单击 Use light version（使用简易版本），则会遇到这种情况，如以下屏幕所示：
浏览器未检测到 Citrix Workspace 应用程序。

如果您在 Citrix Workspace 应用程序检测期间单击 Already installed（已安装），则会遇到这种情况，如以下屏幕所示：

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

优化

必须检测 Citrix Workspace 应用程序才能启动启用了应用程序保护的会话。为避免在混合启动受保护的会话时失败，StoreFront 管理员可以使用 deploy-solution.ps1 命令的 ApplyUICustomization 操作并隐藏 Use light version（使用简易版本）和 Already installed（已安装）选项。

本内容的正式版本为英文版。部分 Citrix 文档内容采用了机器翻译，仅供您参考。Citrix 无法控制机器翻译的内容，这些内容可能包含错误、不准确或不合适的语言。对于从英文原文翻译成任何其他语言的内容的准确性、可靠性、适用性或正确性，或者您的 Citrix 产品或服务沿用了任何机器翻译的内容，我们均不作任何明示或暗示的保证，并且适用的最终用户许可协议或服务条款或者与 Citrix 签订的任何其他协议（产品或服务与已进行机器翻译的任何文档保持一致）下的任何保证均不适用。对于因使用机器翻译的内容而引起的任何损害或问题，Citrix 不承担任何责任。

这是否有帮助？

面向 StoreFront 的混合启动的应用程序保护

January 19, 2023

投稿者:

January 19, 2023

投稿者:

这是否有帮助？