Secure Private Access 2311 compatibility with legacy versions

Last published : Oct 24, 2026
Secure Private Access 2311 is incompatible with the legacy versions. NetScaler Gateway must be configured using the new script as described earlier in Configure NetScaler Gateway. No configuration is required in the Citrix Virtual Apps and Desktops delivery controller for Secure Private Access legacy versions.
从旧版本迁移到 2311 的最佳方法是清理以下内容：
  • 来自 Web/SaaS 应用程序的 思杰虚拟应用和桌面 交付控制器
  • 将 Citrix StoreFront™ 更新为默认配置，或在 StoreFront 上创建新应用商店
  • 网标器网关

思杰虚拟应用和桌面交付控制器清理

在 Citrix Virtual Apps and Desktops 交付控制器上创建的安全私有访问应用程序可以手动删除或使用 PowerShell 脚本删除。
手动：
  1. 打开 Citrix 管理工作室 或 Citrix Web 管理工作室。
  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 2311 创建新的 StoreFront 存储，因为为旧版本创建的现有 StoreFront 存储与 2311 不兼容。这是避免配置相关问题的推荐选项。
  • 清理现有 StoreFront 存储：StoreFront 上的现有存储可以手动清理或使用脚本清理。但是，将本地 Secure Private Access 迁移到 2311 的最佳选项是在 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. 输入应用商店名称。
    The Script removes the C:\inetpub\wwwroot\Citrix\Store\Resources folder, subfolder and files, and updates the web.config file.
  5. 重新启动 互联网信息服务 (IIS) 管理器上的默认网站 控制台以应用更改。

奈思开勒网关清理

NetScaler 网关虚拟服务器

为旧版本创建的 NetScaler 网关虚拟服务器可重复用于 Secure Private Access 2311。
  • 要更新现有 NetScaler 网关，请参阅 更新现有 NetScaler 网关。
  • 要配置新的 NetScaler 网关，请参阅 配置 NetScaler 网关。

会话策略和操作

为旧版本创建的会话策略和操作可以由 Secure Private Access 2311 重复使用。
该脚本还会创建完全配置的会话策略/操作。

授权相关的策略

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