Storebrowse

Storebrowse est un utilitaire léger en ligne de commande utilisé pour interagir entre le client et le serveur. Il est utilisé pour authentifier toutes les opérations au sein de StoreFront et avec Citrix Gateway.

• Pour la documentation sur les anciennes versions de l’utilitaire Storebrowse pour Citrix Receiver pour Windows, consultez la documentation Storebrowse pour Citrix Receiver pour Windows.

• À l’aide de l’utilitaire Storebrowse, les administrateurs peuvent automatiser les opérations quotidiennes suivantes :

• Ajouter un magasin.
• Énumérer les applications et bureaux virtuels Citrix™ publiés et Citrix DaaS (anciennement service Citrix Virtual Apps and Desktops) à partir d’un magasin configuré.
• Générer un fichier ICA en sélectionnant manuellement n’importe quelle application et bureau virtuel Citrix et Citrix DaaS publiés.
• Générer un fichier ICA® à l’aide de la ligne de commande Storebrowse.
• Lancer l’application publiée.

L’utilitaire Storebrowse fait désormais partie du composant Authmanager. Après l’installation de l’application Citrix Workspace, l’utilitaire Storebrowse se trouve dans le dossier d’installation AuthManager.

Vous pouvez confirmer si l’utilitaire Storebrowse est installé avec le composant Authmanager en vérifiant le chemin du registre de la manière suivante :

Lorsque l’application Citrix Workspace est installée par les administrateurs :

Lorsque l’application Citrix Workspace est installée par les utilisateurs (non-administrateurs) :

Exigences

Installez l’application Citrix Workspace version 1808 pour Windows ou ultérieure pour que l’utilitaire Storebrowse fonctionne de manière transparente entre StoreFront et Citrix Gateway. L’application Citrix Workspace version 1809 nécessite un minimum de 530 Mo d’espace disque libre et 2 Go de RAM pour être installée.

Matrice de compatibilité

• L’utilitaire Storebrowse est compatible avec les systèmes d’exploitation suivants :

• Système d’exploitation
  Windows 10 éditions 32 bits et 64 bits
  Windows 8.1, éditions 32 bits et 64 bits
  Windows 7 SP1, éditions 32 bits et 64 bits
  Windows Thin PC
  Windows Server 2016

• Windows Server 2012 R2, éditions Standard et Datacenter

• Windows Server 2012, éditions Standard et Datacenter

• Windows Server 2008 R2, édition 64 bits

  Windows Server 2008 R2, édition 64 bits

• Connexions

L’utilitaire Storebrowse prend en charge les types de connexions suivants :

• Magasin HTTP
• Magasin HTTPS
• Citrix Gateway 11.0 et versions ultérieures

Remarque :

L’utilitaire Storebrowse n’accepte pas les informations d’identification via la ligne de commande sur un magasin HTTP.

Méthodes d’authentification

Serveurs StoreFront

StoreFront prend en charge différentes méthodes d’authentification pour accéder aux magasins, mais toutes ne sont pas recommandées. Pour des raisons de sécurité, certaines méthodes d’authentification sont désactivées par défaut lors de la création d’un magasin.

• Nom d’utilisateur et mot de passe : Les utilisateurs peuvent saisir leurs informations d’identification et sont authentifiés lorsqu’ils accèdent à leurs magasins. L’authentification explicite est activée par défaut lorsque vous créez votre premier magasin. Toutes les méthodes d’accès utilisateur prennent en charge l’authentification explicite.
• Authentification pass-through de domaine : Les utilisateurs s’authentifient auprès de leurs ordinateurs Windows joints à un domaine et sont automatiquement connectés lorsqu’ils accèdent à leurs magasins. Pour utiliser cette option, l’authentification pass-through doit être activée lorsque l’application Citrix Workspace est installée sur les appareils des utilisateurs. Pour plus d’informations sur la configuration de l’authentification pass-through de domaine, consultez Configuration de l’authentification pass-through.
• HTTP Basic : L’utilitaire Storebrowse nécessite que l’authentification HTTP Basic soit activée pour communiquer avec les serveurs StoreFront. Cette option est désactivée par défaut sur le serveur StoreFront. Vous devez activer la méthode d’authentification HTTP Basic.

L’utilitaire Storebrowse prend en charge les méthodes d’authentification de l’une des manières suivantes :

• À l’aide de l’AuthManager intégré à l’utilitaire Storebrowse. Remarque : Vous devez activer la méthode d’authentification HTTP Basic sur StoreFront lorsque vous travaillez avec l’utilitaire Storebrowse. Ceci s’applique lorsque l’utilisateur fournit les informations d’identification à l’aide des commandes Storebrowse.
• Authmanager externe pouvant être inclus avec l’application Citrix Workspace pour Windows.

Prise en charge de Citrix Gateway

Avec la dernière version de l’utilitaire Storebrowse, vous pouvez désormais ajouter une URL Citrix Gateway. Aucune configuration supplémentaire n’est requise dans l’utilitaire Storebrowse pour communiquer avec Citrix Gateway.

Authentification unique avec Citrix Gateway

En plus de la prise en charge nouvellement ajoutée de Citrix Gateway, vous pouvez désormais utiliser l’authentification unique avec celui-ci. Vous pouvez ajouter un nouveau magasin et énumérer les ressources publiées sans avoir à fournir vos informations d’identification utilisateur.

Pour plus d’informations sur la prise en charge de l’authentification unique avec Citrix Gateway, consultez Prise en charge de l’authentification unique avec Citrix Gateway.

Remarque :

Cette fonctionnalité est prise en charge uniquement sur les machines jointes à un domaine où Citrix Gateway est configuré avec l’authentification unique.

Lancer un bureau ou une application publiée

Vous pouvez désormais lancer une ressource directement depuis le magasin sans avoir à utiliser un fichier ICA.

Utilisation des commandes

La section suivante fournit des informations détaillées sur les commandes que vous pouvez utiliser avec l’utilitaire Storebrowse.

-a, –addstore

Description :

Ajoute un nouveau magasin. Renvoie l’URL complète du magasin. En cas d’échec, une erreur est signalée.

Remarque :

Vous pouvez ajouter plusieurs magasins à l’aide de l’utilitaire Storebrowse.

Exemple de commande sur StoreFront :

Commande :

storebrowse.exe –U *username* -P *password* -D *domain* -a *URL of StoreFront*

Exemple :

.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –a [https://my.firstexamplestore.net](https://my.firstexamplestore.net)

Exemple de commande sur Citrix Gateway :

Commande :

storebrowse.exe –U *username* -P *password* -D *domain* -a *URL of CitrixGateway*

Exemple :

.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –a <https://mysecondexample.com>

/?

Description :

Fournit des détails sur l’utilisation de l’utilitaire Storebrowse.

(-l), –liststore

Description :

Répertorie les magasins ajoutés par l’utilisateur.

Exemple de commande sur StoreFront :

.\storebrowse.exe –l

Exemple de commande sur Citrix Gateway :

.\storebrowse.exe –l

(-M 0x2000 -E)

Description :

Énumère les ressources disponibles.

Exemple de commande sur StoreFront :

.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –M 0x2000 –E <https://my.firstexamplestore.net/Citrix/Store/discovery>

Exemple de commande sur Citrix Gateway :

.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –M 0x2000 –E <https://my.secondexample.net>

-q, –quicklaunch

Description :

Génère le fichier ICA requis pour les applications et bureaux publiés à l’aide de l’utilitaire Storebrowse. L’option quicklaunch nécessite une URL de lancement en entrée, ainsi que l’URL du magasin, qui peut être l’URL du serveur StoreFront ou de Citrix Gateway. Le fichier ICA est généré dans le répertoire %LocalAppData%\Citrix\Storebrowse\cache.

• Vous pouvez obtenir l’URL de lancement pour toutes les applications et tous les bureaux publiés en exécutant la commande suivante :

• .\storebrowse –M 0X2000 –E https://myfirstexamplestore.net/Citrix/Second/discovery

• Une URL de lancement typique se présente comme suit :

'Controller.Calculator' 'Calculator' '\' '' http://abc-sf.xyz.com/Citrix/Stress/resources/v2/Q29udHJvbGxlci5DYWxjY3VsYXRvci/launch/ica

Exemple de commande sur StoreFront :

.\storebrowse.exe –U {Username} –P {Password}–D {Domain} –q {Launch_URL_of_published_ apps and desktops }<https://my.firstexamplestore.net/Citrix/Store/resources/v2/Q2hJkOlmNoPQrSTV9y/launch/ica> <https://my.firstexamplestore.net/Citrix/Store/discovery>

Exemple de commande sur Citrix Gateway :

.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –q {Launch_URL_of_published_ apps and desktops} <https://my.secondexmaplestore.com>

-L, –launch

Description :

Génère le fichier ICA requis pour les applications et bureaux publiés à l’aide de l’utilitaire Storebrowse. L’option launch nécessite le nom de la ressource ainsi que l’URL du magasin, qui peut être l’URL du serveur StoreFront ou de Citrix Gateway. Le fichier ICA est généré dans le répertoire %LocalAppData%\Citrix\Storebrowse\cache.

Vous pouvez obtenir le nom d’affichage des applications et bureaux publiés en exécutant la commande ci-dessous :

.\storebrowse –M 0X2000 –E https://myfirstexamplestore.net/Citrix/Second/discovery

Cette commande génère la sortie suivante :

'Controller.Calculator' 'Calculator' '\' '' http://abc-sf.xyz.com/Citrix/Stress/resources/v2/Q29udHJvbGxlci5DYWxjY3VsYXRvci/launch/ica

Le nom qui est en gras dans la sortie ci-dessus est utilisé comme paramètre d’entrée pour l’option launch.

Exemple de commande sur StoreFront :

.\storebrowse.exe -U {Username} –P {Password} –D {Domain} –L “{Resource_Name} <https://my.firstexamplestore.net/Citrix/Store/discovery>

Exemple de commande sur Citrix Gateway :

<.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –L {Resource_Name} https://my.secondexamplestore.com>

-S, –sessionlaunch

Description :

Vous pouvez ajouter le magasin, énumérer les ressources publiées (applications et bureaux) et lancer la ressource avec une seule commande. Cette option prend les paramètres suivants : Nom d’utilisateur, Mot de passe, Domaine, Nom convivial de la ressource à lancer et l’URL du magasin. Cependant, si l’utilisateur ne fournit pas les informations d’identification, une invite AuthManager s’affiche pour saisir les informations d’identification, puis le lancement de la ressource a lieu.

Vous pouvez obtenir le nom de la ressource des applications et bureaux publiés en exécutant la commande ci-dessous :

.\storebrowse –M 0X2000 –E https://myfirstexamplestore.net/Citrix/Second/discovery

Cette commande génère la sortie suivante :

'Controller.Calculator' 'Calculator' '\' '' http://abc-sf.xyz.com/Citrix/Stress/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9y/launch/ica

Le nom en gras dans la sortie ci-dessus sera utilisé comme paramètre d’entrée pour l’option -S.

Exemple de commande sur StoreFront :

.\storebrowse.exe -U {Username} –P {Password} –D {Domain} –S “{Friendly_Resource_Name} <https://my.firstexamplestore.net/Citrix/Store/discovery >

Exemple de commande sur Citrix Gateway :

.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –S {Friendly_Resource_Name} <https://my.secondexamplestore.com>

-f, –filefolder

Description :

Génère le fichier ICA requis dans le chemin personnalisé tel que défini dans l’option –f pour toutes les applications et tous les bureaux publiés à l’aide de l’utilitaire Storebrowse.

L’option de lancement nécessite un nom de dossier ainsi que le nom de la ressource comme entrée avec l’URL du magasin, qui est soit le serveur StoreFront, soit l’URL de Citrix Gateway.

Exemple de commande sur StoreFront :

.\storebrowse.exe –f “C:\Temp\Launch.ica” –L “Resource_Name” {Store}

Exemple de commande sur Citrix Gateway :

.\storebrowse.exe –f “C:\Temp\Launch.ica” –L “Resource_Name” {NSG_URL}

-t, –traceauthentication

Description :

Génère des journaux pour le composant AuthManager intégré à l’utilitaire Storebrowse. Les journaux sont générés uniquement si l’utilitaire Storebrowse utilise un AuthManager intégré. Les journaux sont générés dans le répertoire localappdata%\Citrix\Storebrowse\logs.

Remarque : Cette option ne peut pas être le dernier paramètre répertorié dans la ligne de commande de l’utilisateur.

Exemple de commande sur StoreFront :

.\storebrowse.exe –t –U {UserName} –P {Password} –D {Domain} –a {StoreURL}

Exemple de commande sur Citrix Gateway :

.\storebrowse.exe –t –U {UserName} –P {Password} –D {Domain} –a {NSG_URL}

-d, –deletestore

Description :

Supprime un magasin StoreFront ou Citrix Gateway existant.

Exemple de commande sur StoreFront :

.\storebrowse.exe –d https://my.firstexamplestore.net/Citrix/Store/discovery

Exemple de commande sur Citrix Gateway :

.\storebrowse.exe –d https://my.secondexmaplestore.com

Prise en charge de l’authentification unique avec Citrix Gateway

L’authentification unique (Single Sign-On) vous permet de vous authentifier auprès d’un domaine et d’utiliser les applications et bureaux virtuels Citrix Virtual Apps and Desktops et Citrix DaaS™ fournis par ce domaine sans avoir à vous réauthentifier pour chaque application ou bureau. Lorsque vous ajoutez un magasin à l’aide de l’utilitaire Storebrowse, vos informations d’identification sont transmises au serveur Citrix Gateway, ainsi que les applications et bureaux virtuels énumérés pour vous, y compris vos paramètres de menu Démarrer. Après avoir configuré l’authentification unique, vous pouvez ajouter le magasin, énumérer les applications et bureaux virtuels, lancer la ressource requise sans avoir à saisir vos informations d’identification plusieurs fois.

Cette fonctionnalité est prise en charge sur Citrix Gateway version 11 et ultérieure.

Prérequis :

Pour connaître les prérequis sur la configuration de l’authentification unique pour Citrix Gateway, consultez Configurer l’authentification pass-through de domaine.

La fonctionnalité d’authentification unique avec Citrix Gateway peut être activée à l’aide du modèle d’administration d’objet de stratégie de groupe (GPO).

Remarque :

Lorsque vous effectuez une mise à niveau de Citrix Receiver vers l’application Citrix Workspace ou que vous installez l’application Citrix Workspace pour la première fois, vous devez ajouter les derniers fichiers de modèle au GPO local. Pour plus d’informations sur l’ajout de fichiers de modèle au GPO local, consultez Configuration du modèle d’administration d’objet de stratégie de groupe. En cas de mise à niveau, les paramètres existants sont conservés lors de l’importation des derniers fichiers.

1. Ouvrez le modèle d’administration GPO de l’application Citrix Workspace en exécutant gpedit.msc
2. Sous le nœud Configuration ordinateur, accédez à Modèles d’administration > Composant Citrix > Citrix Workspace > Authentification utilisateur > Authentification unique pour Citrix Gateway.
3. Utilisez les options de bascule pour activer ou désactiver l’option d’authentification unique.
4. Cliquez sur Appliquer et OK.
5. Redémarrez la session de l’application Citrix Workspace pour que les modifications prennent effet.

Limitations :

• La méthode d’authentification de base HTTP doit être activée sur le serveur StoreFront pour les opérations d’injection d’informations d’identification avec l’utilitaire Storebrowse.
• Si vous avez un magasin HTTP et que vous essayez de vous connecter au magasin à l’aide de l’utilitaire pour énumérer ou lancer les applications et bureaux virtuels publiés, l’injection d’informations d’identification à l’aide de l’option de ligne de commande n’est pas prise en charge. Comme solution de contournement, utilisez le module AuthManager externe qui se déclenche lorsque vous ne fournissez pas d’informations d’identification via la ligne de commande.
• L’utilitaire Storebrowse ne prend actuellement en charge qu’un seul magasin Citrix Gateway configuré sur le serveur StoreFront.
• L’injection d’informations d’identification dans l’utilitaire Storebrowse ne fonctionne que si Citrix Gateway est configuré avec l’authentification à facteur unique.
• Les options de ligne de commande Username (-U), Password (-P) et Domain (-D) de l’utilitaire Storebrowse sont sensibles à la casse et doivent être en majuscules uniquement.