Compatibilité de Secure Private Access 2311 avec les versions héritées

Dernière publication : Oct 24, 2026
Secure Private Access 2311 est incompatible avec les versions héritées. NetScaler Gateway doit être configuré à l'aide du nouveau script, comme décrit précédemment dans Configurer NetScaler Gateway. Aucune configuration n'est requise dans le contrôleur de livraison Citrix Virtual Apps and Desktops pour les versions héritées de Secure Private Access.
La meilleure façon de migrer des versions héritées vers la version 2311 est de nettoyer les éléments suivants :
  • Contrôleur de livraison Citrix Virtual Apps and Desktops des applications Web/SaaS
  • Mettre à jour Citrix StoreFront™ vers la configuration par défaut ou créer un nouveau magasin sur StoreFront
  • NetScaler® Gateway

Nettoyage du contrôleur de livraison Citrix Virtual Apps and Desktops™

Les applications Secure Private Access créées sur le contrôleur de livraison Citrix Virtual Apps and Desktops peuvent être supprimées manuellement ou à l'aide du script PowerShell.
Manuel :
  1. Ouvrez Citrix Studio ou Citrix WebStudio.
  2. Cliquez sur Applications.
  3. Sélectionnez l'application, cliquez avec le bouton droit, puis sélectionnez Supprimer.
À l'aide d'un script :
  1. Récupérez les applications Secure Private Access actuelles en exécutant la commande suivante :
    Get-BrokerApplication -Description "KEYWORDS:SPAENABLED"
    Pour plus de détails, consultez Remove-BrokerApplication.
  2. Après avoir vérifié les applications, exécutez la commande suivante pour les supprimer :
    Get-BrokerApplication -Description "KEYWORDS:SPAENABLED" | Remove-BrokerApplication

Nettoyage de Citrix StoreFront

Vous pouvez soit créer un nouveau magasin StoreFront, soit nettoyer le magasin existant.
  • Créer un nouveau magasin StoreFront : Vous devez créer un nouveau magasin StoreFront pour Secure Private Access 2311, car les magasins StoreFront existants créés pour les versions héritées ne sont pas compatibles avec la version 2311. C’est l’option recommandée pour éviter les problèmes liés à la configuration.
  • Nettoyer le magasin StoreFront existant : Le magasin existant sur StoreFront peut être nettoyé manuellement ou à l’aide du script. Cependant, la meilleure option pour migrer Secure Private Access sur site vers la version 2311 est de créer un nouveau magasin sur StoreFront.
Manuel :
  1. Recherchez et supprimez policy.json (par exemple C:\inetpub\wwwroot\Citrix\Store\Resources\SecureBrowser\policy.json).
  2. Recherchez et supprimez les dossiers SecureBrowser (par exemple C:\inetpub\wwwroot\Citrix\Store\Resources\SecureBrowser) et Resources (par exemple C:\inetpub\wwwroot\Citrix\Store\Resources).
  3. Supprimez le nœud « route » de web.config (vous pouvez le trouver dans C:\inetpub\wwwroot\Citrix\Store\) avec le nom « webSecurePolicy » acheminant vers l’URL « Resources\SecureBrowser\policy.json ».
  4. Redémarrez la console Site web par défaut dans le Gestionnaire des services Internet (IIS) pour appliquer les modifications.
À l’aide d’un script :
  1. Téléchargez le script à partir de <https://www.citrix.com/downloads/citrix-secure-private-access/>.
  2. Chargez le script sur une machine StoreFront.
  3. Exécutez le script en tant qu'administrateur sur PowerShell.
  4. Saisissez le nom du Store.
    Le script supprime le dossier C:\inetpub\wwwroot\Citrix\Store\Resources, ses sous-dossiers et fichiers, et met à jour le fichier web.config.
  5. Redémarrez la console Default Web Site on Internet Information Service (IIS) Manager pour appliquer les modifications.

Nettoyage de NetScaler Gateway

Serveur virtuel NetScaler Gateway

Le serveur virtuel NetScaler Gateway créé pour les versions héritées peut être réutilisé pour Secure Private Access 2311.
  • Pour mettre à jour un NetScaler Gateway existant, consultez Mettre à jour un NetScaler Gateway existant.
  • Pour configurer un nouveau NetScaler Gateway, consultez Configurer NetScaler Gateway.

Stratégies et actions de session

Les stratégies et actions de session créées pour les versions héritées peuvent être réutilisées par Secure Private Access 2311.
Le script crée également des stratégies/actions de session entièrement configurées.

Stratégies d'autorisation

Les stratégies d'autorisation créées sur NetScaler Gateway pour les versions héritées peuvent interférer avec les stratégies Secure Private Access 2311 et interrompre le flux.
Vous pouvez effectuer les opérations suivantes pour nettoyer les stratégies d'autorisation.
  • Déliez manuellement les stratégies d'autorisation des groupes d'authentification et d'autorisation qui sont utilisés comme groupes par défaut sur NetScaler Gateway. Dans ce cas, les stratégies peuvent être réutilisées.
  • Supprimez les stratégies d'autorisation.