Protection des applications pour le lancement hybride de StoreFront

On parle de lancement hybride de Citrix Virtual Apps and Desktops lorsque vous vous connectez à StoreFront pour le Web, en saisissant l’URL du magasin dans le navigateur natif, puis lancez les applications et les bureaux virtuels via l’application Citrix Workspace native et son moteur HDX. Le terme hybride désigne le résultat de l’utilisation combinée de l’application StoreFront pour le Web et de l’application native Citrix Workspace pour connecter et utiliser les ressources.

Remarque :

Lorsqu’aucun composant natif de l’application Citrix Workspace n’est installé sur le terminal, il s’agit d’une configuration sans installation dans laquelle le magasin Citrix Workspace et le moteur HDX résident dans le navigateur. C’est ce que l’on appelle l’application Citrix Workspace pour HTML5, qui est hébergée sur Citrix Workspace ou Citrix Storefront. Ce document ne traite pas de ce scénario.

La protection des applications pour le lancement hybride pour StoreFront permet d’énumérer et de lancer des ressources activées par la fonction de protection des applications à partir de navigateurs.

Remarque :

Si vous sélectionnez les options Utiliser la version simplifiée (qui utilise le client HTML5) ou Déjà installé, les sessions activées par la protection des applications sont bloquées car l’application Citrix Workspace n’est pas détectée correctement dans le navigateur.

Vous pouvez accéder aux applications et aux bureaux activés par la protection des applications à l’aide d’un navigateur Web si la personnalisation StoreFront est déployée et que l’application Citrix Workspace native est correctement détectée dans le navigateur. Consultez la section Déploiement.

Composants requis

Assurez-vous d’utiliser l’application Citrix Workspace version 1912 LTSR ou ultérieure, et StoreFront version 3.12 ou ultérieure. Pour plus d’informations sur les versions requises des composants Citrix pour la protection des applications, consultez la section Configuration système requise.

Déploiement

1. Téléchargez le fichier Zip nommé stf-customization-AppP.zip qui contient tous les fichiers requis que vous devez déployer sur la machine serveur StoreFront. Téléchargez le fichier depuis la page Téléchargements de Citrix. Le fichier inclut les éléments suivants :

   • DLL que vous devez copier dans le dossier bin du magasin
   • Fichiers JavaScript et autres fichiers nécessaires au fonctionnement de la solution
   • Script PowerShelldeploy-solution.ps1 que l’administrateur StoreFront utilise pour déployer la solution

2. Décompressez le fichier stf-customization-AppP.zip et ouvrez une invite de commande PowerShell en tant qu’administrateur à l’emplacement où les fichiers sont extraits. Exécutez la commande deploy-solution.ps1 qui utilise les arguments suivants :

   • -Action : action exécutée par le script. Les valeurs autorisées sont les suivantes :

     • L’action Deploy déploie la solution de manière fluide. Elle crée une sauvegarde des fichiers que la solution modifie, copie les fichiers de solution et redémarre les services. La capture d’écran suivante décrit la commande permettant de déployer la solution sur le serveur StoreFront :

       

     • L’action ApplyUICustomization applique une personnalisation à l’interface utilisateur du magasin afin que les options Déjà installé et Utiliser la version simplifiée ne s’affichent pas. Cette action permet de détecter l’application Citrix Workspace native dans le navigateur et de contourner les scénarios bloqués ou non pris en charge.

       

     • L’action RemoveUICustomization annule l’action ApplyUICustomization, et les options Déjà installé et Utiliser la version simplifiée apparaissent à nouveau.

   • -StoreName : nom du magasin pour lequel l’action doit être entreprise. Ce paramètre est obligatoire et doit être transmis en même temps que l’action Deploy.
   • -BackupDir : paramètre pouvant être transmis avec l’action Deploy permettant de créer une sauvegarde dans le répertoire requis. S’il n’est pas transmis, la sauvegarde est créée sur le bureau. Paramètre facultatif.

Remarque :

S’il existe des personnalisations dans StoreCustomization_Input.dll ou StoreCustomization_Launch.dll, le déploiement de cette solution les remplace.

Les applications et les bureaux activés par la protection des applications ne seront énumérés qu’après le déploiement des personnalisations. Sans déploiement, les applications et les bureaux ne sont pas énumérés.

Expérience utilisateur pour un lancement hybride des ressources protégées

1. Après le déploiement de la solution par l’administrateur sur le serveur StoreFront, connectez-vous à votre magasin côté client. Accédez ensuite à StoreFront à l’aide de l’URL dans un navigateur Web.

2. Pour savoir si l’application Citrix Workspace est correctement détectée dans le navigateur, vérifiez le champ État actuel sur l’écran Paramètres du compte.

   

3. Une fois l’application Citrix Workspace détectée, vous pouvez afficher et lancer toutes les applications et tous les bureaux virtuels pour lesquels la protection des applications est activée.

Activer le suivi sur StoreFront

Vous pouvez activer le suivi sur StoreFront pour collecter des journaux. La fonction de suivi écrit des informations détaillées dans la trace. Cette trace peut être utilisée pour vérifier si les étiquettes de stratégie de session NetScaler Gateway configurées sont correctement transmises au magasin. L’emplacement par défaut pour les vidages de traces sur le serveur StoreFront est C:\Program Files\Citrix\Receiver StoreFront\Admin\trace.

Pour activer le suivi et définir le niveau de trace, utilisez le script PowerShell SetDSStoreCustomizationTraceLevel.ps1. Ce script est fourni avec le SDK de personnalisation public de StoreFront disponible ici. Le script utilise les paramètres suivants :

• SiteId : ID du site IIS sur lequel le magasin est déployé
• VirtualPath : chemin virtuel vers le magasin
• TraceLevel : définit les niveaux de suivi, à savoir Error, Info, Off, Verbose et Warning

Exécutez les commandes PowerShell suivantes pour connaître les paramètres SiteId et VirtualPath du magasin : cd 'c:\program files\Citrix\Receiver Storefront\Scripts'. .\ImportModules.ps1 Get-DSStoreFeatureInstances

Utilisez les paramètres SiteId et VirtualPath extraits des commandes lors de l’exécution du script PowerShell SetDSStoreCustomizationTraceLevel.ps1.

Dépannage

Lorsque vous lancez les sessions activées par la protection des applications, l’erreur suivante peut parfois se produire :

Les raisons possibles de cette erreur sont les suivantes :

• Les applications et les bureaux sont configurés pour s’ouvrir dans un navigateur.

  

  Ce scénario peut se produire si vous avez cliqué sur Utiliser la version simplifiée lors de la détection de l’application Citrix Workspace, comme indiqué dans l’écran suivant :

  

• Le navigateur ne détecte pas l’application Citrix Workspace.

  

  Ce scénario peut se produire si vous avez cliqué sur Déjà installé lors de la détection de l’application Citrix Workspace, comme indiqué dans l’écran suivant :

  

Solution : pour corriger les scénarios précédents et lancer les sessions activées par la protection des applications, cliquez sur Changer l’application Citrix Workspace dans Paramètres du compte et attendez que l’application Citrix Workspace soit détectée.

Optimisation

La détection de l’application Citrix Workspace est obligatoire pour lancer les sessions activées par la protection des applications. Pour éviter les échecs lors des lancements hybrides de sessions protégées, les administrateurs de StoreFront peuvent utiliser l’action ApplyUICustomization de la commande deploy-solution.ps1, et masquer les options Utiliser la version simplifiée et Déjà installé.