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 un almacén.
• Enumerar las aplicaciones y los escritorios publicados de Citrix Virtual Apps and Desktops y Citrix DaaS (anteriormente Citrix Virtual Apps and Desktops Service) desde un almacén configurado.
• Generar un archivo ICA manualmente seleccionando cualquier escritorio o aplicación publicados de Citrix Virtual Apps and Desktops y Citrix DaaS.
• Generar un archivo ICA mediante 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:

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

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.

Tabla de compatibilidad

La utilidad Storebrowse es compatible con estos sistemas operativos:

Conexiones

La utilidad Storebrowse admite estos tipos de conexiones:

• Almacén HTTP
• Almacén 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 un almacén HTTP.

Métodos de autenticación

Servidores de StoreFront

StoreFront admite diferentes métodos de autenticación para acceder a los almacenes; 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 un almacén.

• Nombre de usuario y contraseña: Los usuarios pueden introducir sus credenciales y autenticarse cuando acceden a los almacenes. La autenticación explícita está habilitada de forma predeterminada cuando crea su primer almacén. 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 los almacenes. 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 de StoreFront. Esta opción está inhabilitada de forma predeterminada en el servidor de StoreFront. Debe habilitar el método de autenticación HTTP básica.

La utilidad Storebrowse permite la autenticación de cualquiera de estas 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. Esto es aplicable cuando el usuario proporciona las credenciales mediante los comandos de Storebrowse.
• Componente Authmanager externo que se puede incluir con la aplicación Citrix Workspace para Windows.

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 un nuevo almacén 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 el almacén, sin tener que usar ningún archivo ICA.

Uso de 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 un nuevo almacén. Devuelve la dirección URL completa del almacén. Si esto falla, se notifica un error.

Nota:

Puede agregar varios almacenes mediante 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 {nombre de usuario} –P {contraseña} –D {dominio} –a https://mi.primeralmacéndeejemplo.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 los almacenes 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 las aplicaciones y los escritorios publicados mediante la utilidad Storebrowse. La opción de inicio rápido requiere una URL de inicio como entrada junto con la URL del almacén, que puede ser la URL del servidor de 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 las aplicaciones y los escritorios publicados mediante la utilidad Storebrowse. La opción de inicio requiere el nombre del recurso junto con la URL del almacén, que puede ser la URL del servidor de 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 el almacén, 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 del almacén. 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 con la URL del almacén, que es la URL del servidor de 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 el almacén 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

Función 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 y Citrix DaaS entregados por ese dominio sin necesidad de volver a autenticarse para cada aplicación o escritorio. Cuando agrega un almacén mediante la utilidad Storebrowse, las credenciales se transfieren al servidor Citrix Gateway, junto con las aplicaciones y los escritorios virtuales enumerados para usted, incluidos los parámetros del menú Inicio. Después de configurar el inicio Single Sign-On, puede agregar el almacén, enumerar las aplicaciones y los escritorios virtuales 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 función Single Sign-On con Citrix Gateway puede habilitarse mediante la plantilla administrativa de 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 Single Sign-On.
4. Haga clic en Aplicar y 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 HTTP básica debe estar habilitado en el servidor de StoreFront para las operaciones de introducción de credenciales con la utilidad Storebrowse.
• Si tiene un almacén HTTP, la introducción de credenciales mediante la opción de línea de comandos no es posible cuando intenta conectarse al almacén mediante la utilidad para enumerar o iniciar las aplicaciones y los escritorios virtuales publicados. Como solución temporal, utilice el módulo AuthManager externo que se activa cuando no se proporcionan credenciales mediante la línea de comandos.
• Actualmente, la utilidad Storebrowse solo admite Citrix Gateway configurado en un único almacén en el servidor de 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.