Storebrowse

Storebrowse es una utilidad ligera de línea de comandos que se usa para interactuar entre el cliente y el servidor. Se usa para autenticar todas las operaciones en StoreFront y Citrix Gateway.

Para obtener información sobre la versión anterior de la utilidad Storebrowse para Citrix Receiver para Windows, consulte la documentación de Storebrowse para Citrix Receiver para Windows.

Con la utilidad Storebrowse, los administradores pueden automatizar las siguientes operaciones cotidianas:

  • Agregar una tienda.
  • Enumerar las aplicaciones y los escritorios publicados de Citrix Virtual Apps and Desktops desde una tienda configurada.
  • Generar un archivo ICA manualmente seleccionando cualquier escritorio o aplicación publicados de Citrix Virtual Apps and Desktops.
  • Generar un archivo ICA utilizando la línea de comandos de Storebrowse.
  • Iniciar la aplicación publicada.

A partir de ahora, la utilidad Storebrowse forma parte del componente Authmanager. Después de instalar la aplicación Citrix Workspace, la utilidad Storebrowse se encuentra en la carpeta de instalación AuthManager.

Puede confirmar si la utilidad Storebrowse está instalada junto con el componente Authmanager. Para ello, consulte la ruta de registro de las siguientes maneras:

Cuando los administradores instalan la aplicación Citrix Workspace:

   
En una máquina de 32 bits [HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\AuthManager\Install]
En una máquina de 64 bits [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\AuthManager\Install]

Cuando los usuarios (no los administradores) instalan la aplicación Citrix Workspace:

   
En una máquina de 32 bits [HKEY_CURRENT_USER\SOFTWARE\Citrix\AuthManager\Install]
En una máquina de 64 bits [HKEY_CURRENT_USER\SOFTWARE\WOW6432Node\Citrix\AuthManager\Install]

Requisitos

Instale la aplicación Citrix Workspace para Windows 1808 o posterior para que la utilidad Storebrowse funcione sin problemas entre StoreFront y Citrix Gateway. La versión 1809 de Citrix Workspace requiere un mínimo de 530 MB de espacio libre en disco y 2 GB de RAM para su instalación.

Matriz de compatibilidad

La utilidad Storebrowse es compatible con los siguientes sistemas operativos:

Sistema operativo
Windows 10 (ediciones de 32 y 64 bits)
Windows 8.1 (ediciones de 32 y 64 bits)
Windows 7 SP1 (ediciones de 32 y 64 bits)
Windows Thin PC
Windows Server 2016
Windows Server 2012 R2, ediciones Standard y Datacenter
Windows Server 2012, ediciones Standard y Datacenter
Windows Server 2008 R2, edición de 64 bits
Windows Server 2008 R2, edición de 64 bits

Conexiones

La utilidad Storebrowse admite los siguientes tipos de conexiones:

  • Tienda HTTP
  • Tienda HTTPS
  • Citrix Gateway 11.0 y versiones posteriores

Nota:

La utilidad Storebrowse no acepta credenciales introducidas desde la línea de comandos cuando se tiene una tienda HTTP.

Métodos de autenticación

Servidores StoreFront

StoreFront admite diferentes métodos de autenticación para acceder a las tiendas; sin embargo, no todos se recomiendan. Por motivos de seguridad, algunos de los métodos de autenticación están inhabilitados de forma predeterminada cuando se crea una tienda.

  • Nombre de usuario y contraseña: Los usuarios pueden introducir sus credenciales y autenticarse cuando acceden a las tiendas. La autenticación explícita está habilitada de forma predeterminada cuando crea su primera tienda. Todos los métodos de acceso de usuario son compatibles con la autenticación explícita.
  • PassThrough de dominio: Los usuarios realizan la autenticación en los equipos unidos a un dominio de Windows y su sesión se inicia automáticamente cuando acceden a las tiendas. Para poder usar esta opción, la autenticación PassThrough debe estar habilitada cuando se instala la aplicación Citrix Workspace en los dispositivos de los usuarios. Para obtener más información sobre cómo configurar la autenticación PassThrough de dominio, consulte Configurar la autenticación PassThrough.
  • Autenticación HTTP básica: La utilidad Storebrowse requiere que la autenticación HTTP básica esté habilitada para poder comunicarse con los servidores StoreFront. Esta opción está inhabilitada de forma predeterminada en el servidor StoreFront. Debe habilitar el método de autenticación HTTP básica.

La utilidad Storebrowse admite la autenticación de cualquiera de las siguientes maneras:

  • Mediante el componente AuthManager, integrado en la utilidad Storebrowse. Nota: Debe habilitar el método de autenticación HTTP básica en StoreFront mientras trabaje con la utilidad Storebrowse. Se aplica cuando el usuario proporciona las credenciales usando los comandos de Storebrowse.
  • Componente Authmanager externo que se puede incluir con la aplicación Citrix Workspace para Windows.

Respaldo para Citrix Gateway

A partir de la versión más reciente de la utilidad Storebrowse, puede agregar una URL de Citrix Gateway. No se requiere configuración adicional en la utilidad Storebrowse para comunicarse con Citrix Gateway.

Single Sign-On en Citrix Gateway

Además de la recién agregada compatibilidad con Citrix Gateway, ahora puede usar Single Sign-On en él. Puede agregar una nueva tienda y enumerar los recursos publicados sin tener que proporcionar sus credenciales de usuario.

Para obtener más información sobre la disponibilidad de Single Sign-On en Citrix Gateway, consulte Disponibilidad de Single Sign-On en Citrix Gateway.

Nota:

Esta función solo se admite en máquinas unidas a dominio en las que Citrix Gateway está configurado con el método de autenticación Single Sign-On.

Iniciar una aplicación o un escritorio publicado

Ahora puede iniciar un recurso directamente desde la tienda, sin tener que usar ningún archivo ICA.

Utilizar comandos

En la siguiente sección se ofrece información detallada sobre los comandos que se pueden usar desde la utilidad Storebrowse.

-a, –addstore

Descripción:

Agrega una nueva tienda. Devuelve la dirección URL completa de la tienda. Si esto falla, se notifica un error.

Nota:

Puede agregar varias tiendas usando la utilidad Storebrowse.

Ejemplo de comando en StoreFront:

Comando:

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

Ejemplo:

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

Ejemplo de comando en Citrix Gateway:

Comando:

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

Ejemplo:

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

/?

Descripción:

Ofrece información detallada sobre el uso de la utilidad Storebrowse

(-l), –liststore

Descripción:

Ofrece una lista de las tiendas que agrega el usuario.

Ejemplo de comando en StoreFront:

.\storebrowse.exe –l

Ejemplo de comando en Citrix Gateway:

.\storebrowse.exe –l

(-M 0x2000 -E)

Descripción:

Enumera los recursos disponibles

Ejemplo de comando en StoreFront:

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

Ejemplo de comando en Citrix Gateway:

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

-q, –quicklaunch

Descripción:

Genera el archivo ICA requerido para aplicaciones y escritorios publicados utilizando la utilidad Storebrowse. La opción de inicio rápido requiere una URL de inicio como entrada junto con la URL de la tienda, que puede ser la URL del servidor StoreFront o la URL de Citrix Gateway. El archivo ICA se genera en el directorio %LocalAppData%\Citrix\Storebrowse\cache.

Puede obtener la URL de inicio para cualquier aplicación y escritorio publicados ejecutando el siguiente comando:

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

Una URL de inicio típica es similar a la siguiente:

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

Ejemplo de comando en 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>

Ejemplo de comando en Citrix Gateway:

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

-L, –launch

Descripción:

Genera el archivo ICA requerido para aplicaciones y escritorios publicados utilizando la utilidad Storebrowse. La opción de inicio requiere el nombre del recurso junto con la URL de la tienda, que puede ser la URL del servidor StoreFront o la URL de Citrix Gateway. El archivo ICA se genera en el directorio %LocalAppData%\Citrix\Storebrowse\cache.

Puede obtener el nombre simplificado de las aplicaciones y los escritorios publicados ejecutando el siguiente comando:

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

Este comando da como resultado lo siguiente:

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

El nombre en negrita en el resultado anterior se usa como parámetro de entrada para la opción de inicio.

Ejemplo de comando en StoreFront:

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

Ejemplo de comando en Citrix Gateway:

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

-S, –sessionlaunch

Descripción:

Puede agregar la tienda, enumerar los recursos publicados (aplicaciones y escritorios) e iniciar el recurso con un solo comando. Esta opción toma lo siguiente como parámetros: nombre de usuario, contraseña, dominio, nombre descriptivo del recurso que se iniciará y la URL de la tienda. Sin embargo, si el usuario no proporciona las credenciales, se inicia una solicitud de AuthManager que insta a escribir las credenciales a fin de poder iniciar el recurso.

Puede obtener el nombre del recurso de aplicaciones y escritorios publicados ejecutando el siguiente comando:

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

Este comando da como resultado lo siguiente:

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

El nombre en negrita en el resultado anterior se usa como parámetro de entrada para la opción -S.

Ejemplo de comando en StoreFront:

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

Ejemplo de comando en Citrix Gateway:

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

-f, –filefolder

Descripción:

Genera el archivo ICA requerido en la ruta personalizada definida en la opción -f para las aplicaciones y los escritorios publicados que utilizan la utilidad Storebrowse.

La opción de inicio requiere un nombre de carpeta junto con el nombre del recurso como entrada, acompañado de la URL de la tienda, que puede ser la URL del servidor StoreFront o la URL de Citrix Gateway.

Ejemplo de comando en StoreFront:

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

Ejemplo de comando en Citrix Gateway:

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

-t, –traceauthentication

Descripción:

Genera registros para el componente integrado AuthManager de la utilidad Storebrowse. Los registros se generan solo si la utilidad Storebrowse está utilizando un AuthManager integrado. Los registros se generan en el directorio localappdata%\Citrix\Storebrowse\logs.

Nota: Esta opción no puede ser el último parámetro que aparece en la línea de comandos del usuario.

Ejemplo de comando en StoreFront:

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

Ejemplo de comando en Citrix Gateway:

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

-d, –deletestore

Descripción:

Elimina la tienda StoreFront o Citrix Gateway existente.

Ejemplo de comando en StoreFront:

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

Ejemplo de comando en Citrix Gateway:

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

Respaldo para Single Sign-On en Citrix Gateway

Single Sign-On permite autenticarse en un dominio y usar las aplicaciones y los escritorios de Citrix Virtual Apps and Desktops entregados por ese dominio sin necesidad de volver a autenticarse para cada aplicación o escritorio. Cuando agrega una tienda usando la utilidad Storebrowse, las credenciales se transfieren al servidor Citrix Gateway, junto con las aplicaciones y los escritorios de Citrix Virtual Apps and Desktops enumerados para usted, incluidos los parámetros del menú Inicio. Después de configurar el inicio Single Sign-On, puede agregar la tienda, enumerar las aplicaciones y los escritorios de Citrix Virtual Apps and Desktops e iniciar los recursos necesarios sin tener que escribir sus credenciales varias veces.

Esta función es compatible con Citrix Gateway versión 11 y posteriores.

Requisitos previos:

Si quiere ver los requisitos previos necesarios para configurar el inicio Single Sign-On en Citrix Gateway, consulte Configurar la autenticación PassThrough de dominio.

La característica de inicio Single Sign-On en Citrix Gateway se puede habilitar a través de la plantilla administrativa del objeto de directiva de grupo (GPO).

Nota:

Cuando actualice de Citrix Receiver a la aplicación Citrix Workspace o instale de cero la aplicación Citrix Workspace por primera vez, debe agregar los archivos de plantilla más recientes al GPO local. Para obtener más información sobre cómo agregar los archivos de plantilla al GPO local, consulte Configurar la plantilla administrativa de objeto de directiva de grupo. En caso de una actualización, la configuración existente se conserva si se importan los archivos más recientes.

  1. Abra la plantilla administrativa de GPO de la aplicación Citrix Workspace; para ello, ejecute gpedit.msc.
  2. En el nodo Configuración del equipo, vaya a Plantillas administrativas > Componentes de Citrix > Citrix Workspace > Autenticación de usuarios > Single Sign-on para Citrix Gateway.
  3. Utilice las opciones de activación o desactivación para habilitar o inhabilitar la opción de inicio de sesión único.
  4. Haga clic en Aplicar y, a continuación, en Aceptar.
  5. Reinicie la sesión de la aplicación Citrix Workspace para que los cambios surtan efecto.

Limitaciones:

  • El método de autenticación básica HTTP debe estar habilitado en el servidor StoreFront para las operaciones de introducción de credenciales con la utilidad Storebrowse.
  • Si tiene una tienda HTTP, la introducción de credenciales mediante la opción de línea de comandos no se respalda cuando intenta conectarse a la tienda usando la utilidad para enumerar o iniciar los recursos de Citrix Virtual Apps and Desktops publicados. Como solución temporal, utilice el módulo externo AuthManager que se activa cuando no se proporcionan credenciales utilizando la línea de comandos.
  • Actualmente, la utilidad Storebrowse solo admite Citrix Gateway configurado con una sola tienda en el servidor StoreFront.
  • La introducción de credenciales en la utilidad Storebrowse solo funciona si Citrix Gateway está configurado con el método de autenticación con factor único.
  • Las opciones de línea de comandos Username (-U), Password (-P) y Domain (-D) de la utilidad Storebrowse distinguen entre mayúsculas y minúsculas, y deben contener solo mayúsculas.