Storebrowse
Storebrowse est un utilitaire de ligne de commande léger qui permet l’interaction entre le client et le serveur. Il est utilisé pour authentifier toutes les opérations dans StoreFront et avec Citrix Gateway.
Pour plus d’informations sur l’ancienne version de l’utilitaire Storebrowse pour Citrix Receiver pour Windows, consultez la documentation relative à Storebrowse pour Citrix Receiver pour Windows.
Grâce à l’utilitaire Storebrowse, les administrateurs peuvent automatiser les opérations quotidiennes suivantes :
- Ajouter un magasin
- Énumérer les bureaux ou applications Citrix Virtual Apps and Desktops et Citrix DaaS publié(e)s (anciennement Citrix Virtual Apps and Desktops Service) à partir d’un magasin configuré
- Générer manuellement un fichier ICA en sélectionnant un bureau ou une application Citrix Virtual Apps and Desktops et Citrix DaaS publié(e)
- Générer un fichier ICA à l’aide de la ligne de commande Storebrowse
- Lancer l’application publiée
L’utilitaire Storebrowse fait partie du composant Authmanager. Après l’installation de l’application Citrix Workspace, l’utilitaire Storebrowse se trouve dans le dossier d’installation de AuthManager
.
Vous pouvez vérifier 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 :
Sur une machine 32 bits | [HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\AuthManager\Install] |
Sur une machine 64 bits | [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\AuthManager\Install] |
Lorsque l’application Citrix Workspace est installée par les utilisateurs (et non les administrateurs) :
Sur une machine 32 bits | [HKEY_CURRENT_USER\SOFTWARE\Citrix\AuthManager\Install] |
Sur une machine 64 bits | [HKEY_CURRENT_USER\SOFTWARE\WOW6432Node\Citrix\AuthManager\Install] |
Exigences
Installez l’application Citrix Workspace version 1808 pour Windows ou version ultérieure pour que l’utilitaire Storebrowse fonctionne de manière transparente entre StoreFront et Citrix Gateway. L’application Citrix Workspace version 1809 requiert une capacité minimale de 530 Mo d’espace disque disponible et 2 Go de RAM.
Compatibility Matrix
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, édition Standard et Datacenter |
Windows Server 2012, édition 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 à l’aide de 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 ces méthodes 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 au domaine : les utilisateurs doivent s’authentifier sur leur ordinateur Windows membre d’un domaine et leur session est automatiquement ouverte lorsqu’ils accèdent à leurs magasins. Pour pouvoir utiliser cette option, l’authentification pass-through doit être activée lorsque l’application Citrix Workspace est installée sur les machines utilisateur. Pour plus d’informations sur la configuration de l’authentification pass-through au domaine, consultez la section Configurer l’authentification pass-through au domaine.
- HTTP basique : l’utilitaire Storebrowse requiert que l’authentification HTTP basique soit activée pour communiquer avec les serveurs StoreFront. Par défaut, cette option est désactivée sur le serveur StoreFront. Vous devez activer la méthode d’authentification HTTP basique.
L’utilitaire Storebrowse prend en charge les méthodes d’authentification via l’une des méthodes suivantes :
- En utilisant le composant
AuthManager
qui est intégré à l’utilitaire Storebrowse. Remarque : vous devez activer la méthode d’authentification HTTP basique sur StoreFront lorsque vous utilisez l’utilitaire Storebrowse. Cela s’applique lorsque l’utilisateur fournit les informations d’identification à l’aide des commandes Storebrowse. - En utilisant le composant
Authmanager
externe qui peut ê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 (Single Sign-On) avec Citrix Gateway
Outre la prise en charge de Citrix Gateway nouvellement ajoutée, vous pouvez désormais utiliser Single Sign-On. Vous pouvez ajouter un nouveau magasin et énumérer les ressources publiées sans avoir à fournir vos informations d’identification d’utilisateur.
Pour plus d’informations sur la prise en charge de Single Sign-on avec Citrix Gateway, consultez la section Prise en charge de l’authentification unique (Single Sign-On) avec Citrix Gateway.
Remarque :
Cette fonctionnalité est prise en charge uniquement sur les machines appartenant à un domaine sur lesquelles Citrix Gateway est configurée avec l’authentification unique Single Sign-On.
Lancer une application ou un bureau publié
Vous pouvez maintenant lancer une ressource directement à partir du 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 depuis l’utilitaire Storebrowse.
-a –addstore
Description :
Ajoute un nouveau magasin. Renvoie l’URL complète du magasin. Si cela échoue, 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`
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 les bureaux publiés à l’aide de l’utilitaire Storebrowse. L’option quicklaunch nécessite une URL de lancement en tant qu’entrée avec l’URL du magasin, qui peut être le serveur StoreFront ou l’URL 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 de toutes les applications et bureaux publiés en exécutant la commande suivante :
.\storebrowse –M 0X2000 –E https://myfirstexamplestore.net/Citrix/Second/discovery
Une URL de lancement ressemble généralement à celle-ci :
'Controller.Calculator' 'Calculator' '\' '' http://abc-sf.xyz.com/Citrix/Stress/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9y/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 les 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 le serveur StoreFront ou l’URL 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 suivante :
.\storebrowse –M 0X2000 –E https://myfirstexamplestore.net/Citrix/Second/discovery
Cette commande entraîne 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 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 cette commande unique. Cette option prend en compte les paramètres suivants : Nom d’utilisateur, Mot de passe, Domaine, Nom convivial de la ressource à lancer et URL du magasin. Toutefois, si l’utilisateur ne fournit pas les informations d’identification, une invite AuthManager
est envoyée pour entrer ces informations, puis le lancement de la ressource se produit.
Vous pouvez obtenir le nom de la ressource des applications et bureaux publiés en exécutant la commande suivante :
.\storebrowse –M 0X2000 –E https://myfirstexamplestore.net/Citrix/Second/discovery
Cette commande entraîne 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 est 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 qu’il est défini dans l’option –f pour les applications et les bureaux publiés à l’aide de l’utilitaire Storebrowse.
L’option launch nécessite un nom de dossier avec le nom de la ressource comme paramètre d’entrée, ainsi que l’URL du magasin, qui peut être le serveur StoreFront ou 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 composant 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 le 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 (Single Sign-On) avec Citrix Gateway
Single Sign-on vous permet de vous authentifier auprès d’un domaine et d’utiliser Citrix Virtual Apps and Desktops et Citrix DaaS mis à disposition par ce domaine sans procéder à une nouvelle authentification 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 avec les applications et bureaux virtuels énumérés pour vous, y compris les paramètres du menu Démarrer. Après avoir configuré Single Sign-on, vous pouvez ajouter le magasin, énumérer les applications et bureaux virtuels et lancer les ressources nécessaires sans saisir à plusieurs reprises vos informations d’identification.
Cette fonctionnalité est prise en charge sur Citrix Gateway version 11 et ultérieure.
Logiciels requis :
Pour plus d’informations sur les conditions préalables à la configuration de Single Sign-On pour Citrix Gateway, consultez la section Configurer l’authentification pass-through au domaine.
La fonctionnalité Single Sign-On peut être activée avec Citrix Gateway via le modèle d’administration d’objet de stratégie de groupe.
Remarque :
Lorsque vous mettez à niveau Citrix Receiver vers l’application Citrix Workspace ou installez l’application Citrix Workspace pour la première fois, vous devez ajouter les derniers fichiers de modèle à l’objet de stratégie de groupe local. Pour plus d’informations sur l’ajout de fichiers de modèle à l’objet de stratégie de groupe local, consultez la section 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.
- Ouvrez le modèle d’administration d’objet de stratégie de groupe de l’application Citrix Workspace en exécutant gpedit.msc.
- Sous le nœud Configuration ordinateur, accédez à Modèles d’administration > Composants Citrix > Citrix Workspace > Authentification utilisateur > Single Sign-on pour Citrix Gateway.
- Utilisez les options Activer/Désactiver pour activer ou désactiver l’option Single Sign-On.
- Cliquez sur Appliquer et OK.
- Redémarrez la session de l’application Citrix Workspace pour que les modifications prennent effet.
Limites :
- La méthode d’authentification HTTP de base 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 les bureaux virtuels publiés, l’injection des informations d’identification à l’aide de la ligne de commande n’est pas prise en charge. Pour résoudre ce problème, utilisez le module externe
AuthManager
qui est déclenché lorsque vous ne fournissez pas d’informations d’identification à l’aide de la ligne de commande. - L’utilitaire Storebrowse prend actuellement en charge uniquement la passerelle Citrix Gateway configurée pour un seul magasin 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
) etDomain (-D)
de l’utilitaire Storebrowse sont sensibles à la casse et doivent être uniquement entrées en majuscules.