Storebrowse

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

• Para obtener documentación sobre versiones anteriores de la utilidad Storebrowse para Citrix Receiver para Windows, consulta la documentación de Storebrowse para Citrix Receiver para Windows.

• Mediante la utilidad Storebrowse, los administradores pueden automatizar las siguientes operaciones diarias:

• Agregar un almacén.
• Enumerar las aplicaciones y escritorios virtuales de Citrix™ y Citrix DaaS (anteriormente servicio Citrix Virtual Apps and Desktops) publicados desde un almacén configurado.
• Generar un archivo ICA seleccionando manualmente cualquier aplicación y escritorio virtual de Citrix y Citrix DaaS publicados.
• Generar un archivo ICA® mediante la línea de comandos de Storebrowse.
• Iniciar la aplicación publicada.

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

Puedes confirmar si la utilidad Storebrowse está instalada junto con el componente AuthManager comprobando la ruta del registro de las siguientes maneras:

Cuando la aplicación Citrix Workspace es instalada por administradores:

Cuando la aplicación Citrix Workspace es instalada por usuarios (no administradores):

Requisitos

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

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:

• Almacén HTTP
• Almacén HTTPS
• Citrix Gateway 11.0 y posteriores

Nota:

La utilidad Storebrowse no acepta credenciales mediante la línea de comandos en un almacén HTTP.

Métodos de autenticación

Servidores StoreFront

StoreFront admite diferentes métodos de autenticación para acceder a los almacenes; sin embargo, no todos son recomendables. Por motivos de seguridad, algunos de los métodos de autenticación están deshabilitados de forma predeterminada al crear un almacén.

• Nombre de usuario y contraseña: Los usuarios pueden introducir sus credenciales y se autentican cuando acceden a sus almacenes. La autenticación explícita está habilitada de forma predeterminada al crear tu primer almacén. Todos los métodos de acceso de usuario admiten la autenticación explícita.
• Autenticación de paso de dominio: Los usuarios se autentican en sus equipos Windows unidos a un dominio y se inician sesión automáticamente cuando acceden a sus almacenes. Para usar esta opción, la autenticación de paso debe estar habilitada cuando la aplicación Citrix Workspace se instala en los dispositivos de los usuarios. Para obtener más información sobre cómo configurar la autenticación de paso de dominio, consulta Configurar la autenticación de paso.
• HTTP Basic: La utilidad Storebrowse requiere que la autenticación HTTP Basic esté habilitada para comunicarse con los servidores StoreFront. Esta opción está deshabilitada de forma predeterminada en el servidor StoreFront. Debes habilitar el método de autenticación HTTP Basic.

La utilidad Storebrowse admite métodos de autenticación de cualquiera de las siguientes maneras:

• Usando el AuthManager integrado junto con la utilidad Storebrowse. Nota: Debes habilitar el método de autenticación HTTP Basic en StoreFront mientras trabajas con la utilidad Storebrowse. Esto se aplica cuando el usuario proporciona las credenciales mediante los comandos de Storebrowse.
• AuthManager externo que se puede incluir con la aplicación Citrix Workspace para Windows.

Compatibilidad con Citrix Gateway

Con la última versión de la utilidad Storebrowse, ahora puedes agregar una URL de Citrix Gateway. No se requiere configuración adicional en la utilidad Storebrowse para comunicarse con Citrix Gateway.

Inicio de sesión único con Citrix Gateway

Además de la compatibilidad recién agregada con Citrix Gateway, ahora puedes usar el inicio de sesión único con él. Puedes agregar un nuevo almacén y enumerar los recursos publicados sin tener que proporcionar tus credenciales de usuario.

Para obtener más información sobre la compatibilidad con el inicio de sesión único con Citrix Gateway, consulta Compatibilidad con el inicio de sesión único con Citrix Gateway.

Nota:

Esta función solo es compatible con máquinas unidas a un dominio donde Citrix Gateway está configurado con la autenticación de inicio de sesión único.

Iniciar escritorio o aplicación publicados

Ahora puedes iniciar un recurso directamente desde el almacén sin tener que usar un archivo ICA.

Uso de comandos

La siguiente sección proporciona información detallada sobre los comandos que puedes usar desde la utilidad Storebrowse.

-a, –addstore

Descripción:

Agrega un nuevo almacén. Devuelve la URL completa del almacén. Si esto falla, se informa de un error.

Nota:

Puedes agregar varios almacenes usando la utilidad Storebrowse.

Ejemplo de comando en StoreFront:

Comando:

storebrowse.exe –U *nombre_de_usuario* -P *contraseña* -D *dominio* -a *URL_de_StoreFront*

Ejemplo:

.\storebrowse.exe –U {NombreDeUsuario} –P {Contraseña} –D {Dominio} –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:

Proporciona detalles sobre el uso de la utilidad Storebrowse.

(-l), –liststore

Descripción:

Enumera los almacenes agregados por 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 necesario para las aplicaciones y escritorios publicados usando la utilidad Storebrowse. La opción quicklaunch requiere una URL de lanzamiento como entrada junto con la URL del almacén, que puede ser el servidor StoreFront o la URL de Citrix Gateway. El archivo ICA se genera en el directorio %LocalAppData%\Citrix\Storebrowse\cache.

• Puedes obtener la URL de lanzamiento para cualquier aplicación y escritorio publicado ejecutando el siguiente comando:

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

• Una URL de lanzamiento típica se ve así:

'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 necesario para las aplicaciones y escritorios publicados usando la utilidad Storebrowse. La opción de lanzamiento requiere el nombre del recurso junto con la URL del almacén, que puede ser el servidor StoreFront o la URL de Citrix Gateway. El archivo ICA se genera en el directorio %LocalAppData%\Citrix\Storebrowse\cache.

Puedes obtener el nombre para mostrar de las aplicaciones y escritorios publicados ejecutando el siguiente comando:

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

Este comando produce la siguiente salida:

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

El nombre que está en negrita en la salida anterior se usa como parámetro de entrada para la opción de lanzamiento.

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:

Puedes agregar el almacén, enumerar los recursos publicados (aplicaciones y escritorios) e iniciar el recurso con un solo comando. Esta opción toma los siguientes parámetros: nombre de usuario, contraseña, dominio, nombre descriptivo del recurso que se va a iniciar y la URL del almacén. Sin embargo, si el usuario no proporciona las credenciales, se muestra un mensaje de AuthManager para introducirlas y, a continuación, se iniciará el recurso.

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

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

Este comando da como resultado la siguiente salida:

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

El nombre que aparece en negrita en la salida anterior se utilizará 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 necesario en la ruta personalizada definida en la opción –f para cualquiera de las aplicaciones y escritorios publicados mediante la utilidad Storebrowse.

La opción de inicio requiere un nombre de carpeta junto con el nombre del recurso como entrada con la URL del almacén, que es el 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 AuthManager integrado de la utilidad Storebrowse. Los registros se generan solo si la utilidad Storebrowse utiliza 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 de 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 un almacén de 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

Compatibilidad con inicio de sesión único con Citrix Gateway

El inicio de sesión único te permite autenticarte en un dominio y usar Citrix Virtual Apps and Desktops y Citrix DaaS™ entregados por ese dominio sin tener que volver a autenticarte en cada aplicación o escritorio. Cuando agregas un almacén mediante la utilidad Storebrowse, tus credenciales se transfieren al servidor Citrix Gateway, junto con las aplicaciones y escritorios virtuales enumerados para ti, incluida la configuración del menú Inicio. Después de configurar el inicio de sesión único, puedes agregar el almacén, enumerar las aplicaciones y escritorios virtuales e iniciar el recurso necesario sin tener que escribir tus credenciales varias veces.

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

Requisitos previos:

Para conocer los requisitos previos sobre cómo configurar el inicio de sesión único para Citrix Gateway, consulta Configurar la autenticación de paso a través de dominio.

La función de inicio de sesión único con Citrix Gateway se puede habilitar mediante la plantilla administrativa de objeto de directiva de grupo (GPO).

Nota:

Cuando actualizas de Citrix Receiver a la aplicación Citrix Workspace o instalas la aplicación Citrix Workspace por primera vez, debes agregar los archivos de plantilla más recientes a la GPO local. Para obtener más información sobre cómo agregar archivos de plantilla a la GPO local, consulta Configurar la plantilla administrativa de objeto de directiva de grupo. En caso de una actualización, la configuración existente se mantiene cuando se importan los archivos más recientes.

1. Abre la plantilla administrativa de GPO de la aplicación Citrix Workspace ejecutando gpedit.msc
2. En el nodo Configuración del equipo, ve a Plantillas administrativas > Componente de Citrix > Citrix Workspace > Autenticación de usuario > Inicio de sesión único para Citrix Gateway.
3. Usa las opciones de alternancia para Habilitar o Deshabilitar la opción de inicio de sesión único.
4. Haz clic en Aplicar y Aceptar.
5. Reinicia 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 inyección de credenciales con la utilidad Storebrowse.
• Si tienes un almacén HTTP y, al intentar conectarte al almacén mediante la utilidad para enumerar o iniciar las aplicaciones y escritorios virtuales publicados, la inyección de credenciales mediante la opción de línea de comandos no es compatible. Como solución alternativa, usa el módulo AuthManager externo que se activa cuando no proporcionas credenciales mediante la línea de comandos.
• La utilidad Storebrowse actualmente solo admite un único Citrix Gateway configurado en el servidor StoreFront.
• La inyección de credenciales en la utilidad Storebrowse solo funciona si Citrix Gateway está configurado con autenticación de factor único.
• Las opciones de línea de comandos Nombre de usuario (-U), Contraseña (-P) y Dominio (-D) de la utilidad Storebrowse distinguen entre mayúsculas y minúsculas y deben estar solo en mayúsculas.