安全私有访问 2308 与旧版本的兼容性

Last published : Oct 24, 2026
安全私有访问 2308 与旧版本（本地部署版安全私有访问 V1.0 和 V1.5）不兼容。必须使用新脚本配置 NetScaler 网关，具体方法如之前在 配置 NetScaler 网关 中所述。对于安全私有访问 2308，Citrix 虚拟应用和桌面交付控制器中无需进行任何配置。
从本地部署的 Secure Private Access 旧版本（1.0 和 1.5）迁移到 2308 的最佳方法是清理以下内容：
  • Citrix 虚拟应用和桌面 交付控制器，用于 Web/软件即服务应用程序
  • 将 Citrix StoreFront™ 更新为默认配置或在 StoreFront 上创建新应用商店
  • 网思乐® 网关

Citrix 虚拟应用和桌面™ 交付控制器清理

在 Citrix 虚拟应用和桌面 交付控制器上创建的 安全私有访问 应用程序可以手动删除或使用 PowerShell 脚本删除。
手动：
  1. Open Citrix Studio or Citrix WebStudio.
  2. 单击“应用程序”。
  3. 选择应用程序，右键单击，然后选择“删除”。
使用脚本：
  1. 通过运行以下命令获取当前的 Secure Private Access 应用程序：
    Get-BrokerApplication -Description "KEYWORDS:SPAENABLED"
    For details, see Remove-BrokerApplication.
  2. 验证应用程序后，运行以下命令将其删除：
    Get-BrokerApplication -Description "KEYWORDS:SPAENABLED" | Remove-BrokerApplication

Citrix StoreFront cleanup

您可以创建新的 StoreFront 商店，也可以清理现有商店。
  • 创建新的 StoreFront 商店：您必须为 Secure Private Access 2308 创建新的 StoreFront 商店，因为为旧版本创建的现有 StoreFront 商店与 2308 不兼容。这是避免配置相关问题的推荐选项。
  • 清理现有 StoreFront 商店：StoreFront 上的现有商店可以手动清理，也可以使用脚本清理。但是，将本地 Secure Private Access 迁移到 2308 的最佳选择是在 StoreFront 上创建新商店。
手动：
  1. Find and remove policy.json (e.g C:\inetpub\wwwroot\Citrix\Store\Resources\SecureBrowser\policy.json)
  2. Find and remove folders SecureBrowser (for example C:\inetpub\wwwroot\Citrix\Store\Resources\SecureBrowser) and Resources (for example C:\inetpub\wwwroot\Citrix\Store\Resources)
  3. Remove the "route" node from web.config (you can find it in C:\inetpub\wwwroot\Citrix\Store\) with the name "webSecurePolicy" routing to the URL "Resources\SecureBrowser\policy.json"
  4. 重新启动 Internet 信息服务 (IIS) 管理器上的默认网站 控制台以应用更改。
使用脚本：
  1. 从 <https://www.citrix.com/downloads/citrix-secure-private-access/> 下载脚本。
  2. 将脚本上传到 StoreFront 计算机。
  3. 在 PowerShell 上以管理员身份运行脚本。
  4. 输入应用商店名称。
    该脚本会删除位于 C:\inetpub\wwwroot\Citrix\Store\Resources 的文件夹、其所有子文件夹以及其中的文件，并对 web.config 文件进行更新。
  5. 重新启动 Internet 信息服务 (IIS) 管理器中的默认网站 控制台以应用更改。

NetScaler 网关的清理工作

NetScaler 网关虚拟服务器

为旧版本（1.0 和 1.5）创建的 NetScaler 网关虚拟服务器可用于安全私有访问 2308。
  • 要更新现有的 NetScaler 网关，请参阅 。
  • 要配置新的 NetScaler 网关，请参阅 。

会话策略和操作

为旧版本（1.0 和 1.5）创建的会话策略和操作可由 Secure Private Access 2308 重复使用。
脚本还会创建完全配置的会话策略/操作。

授权策略规则

在 NetScaler Gateway 上为旧版本（1.0 和 1.5）创建的授权策略可能会干扰 Secure Private Access 2308 策略并中断流程。
您可以执行以下操作来清理授权策略。
  • 手动解除授权策略与在 NetScaler Gateway 上用作默认组的身份验证和授权组的绑定。在这种情况下，策略可以重复使用。
  • 对授权策略进行移除。