Storebrowse

Storebrowse es una utilidad de línea de comandos que interactúa 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:

  • Agregar un almacén.
  • Enumerar las aplicaciones y los escritorios publicados desde un almacén configurado.
  • Generar un archivo ICA manualmente seleccionando cualquier escritorio o aplicación publicados de Citrix Virtual Apps and Desktops.
  • 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 verificar si la utilidad Storebrowse está instalada junto con el componente Authmanager. Para ello, consulte la siguiente ruta de registro:

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

  • Aplicación Citrix Workspace para Windows 1808 o una versión posterior.
  • Mínimo 530 MB de espacio libre en disco.
  • 2 GB de RAM.

Tabla 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 versiones posteriores

Nota:

En un almacén HTTP, la utilidad Storebrowse no acepta credenciales introducidas desde la línea de comandos.

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: Introduzca las credenciales para autenticarse y acceder a los almacenes. La autenticación explícita está habilitada de forma predeterminada cuando crea el primer almacén.
  • PassThrough de dominio: Después de autenticarse en los equipos Windows unidos a un dominio, se inicia sesión automáticamente en los almacenes. Para utilizar esta opción, habilite la autenticación PassThrough al instalar la aplicación Citrix Workspace. Para obtener más información sobre la llamada transferencia de dominios, 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 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. 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.

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 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 Soporte para 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.

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

Nota:

Con la utilidad Storebrowse, es posible configurar varios almacenes.

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 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 recursos.

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 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. La URL de inicio puede ser el 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 si ejecuta 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 y la URL del almacén. El nombre puede ser el servidor de StoreFront o la URL de Citrix Gateway. El archivo ICA se genera en el directorio %LocalAppData%\Citrix\Storebrowse\cache.

Ejecute el siguiente comando para obtener el nombre simplificado de las aplicaciones y los escritorios publicados:

.\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:

Con este comando, puede agregar un almacén, enumerar e iniciar los recursos publicados. Esta opción toma los siguientes elementos como parámetros:

  • Nombre de usuario
  • Password
  • Dominio
  • Nombre del recurso que se va a iniciar
  • URL del almacén

Sin embargo, si el usuario no proporciona las credenciales, AuthManager le pide que introduzca las credenciales y, a continuación, se inicia el recurso.

Puede obtener el nombre del recurso de aplicaciones y escritorios publicados con 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 en la ruta de acceso personalizada para aplicaciones y escritorios publicados.

La opción de inicio requiere un nombre de carpeta y el nombre del recurso como entrada con la URL del almacén. La URL del almacén puede ser el 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 AuthManager. 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 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 entregados por ese dominio sin necesidad de volver a autenticarse para cada aplicación o escritorio. Cuando agrega un almacén, las credenciales se transfieren al servidor de Citrix Gateway, junto con las aplicaciones y los escritorios de Citrix Virtual Apps and Desktops enumerados, incluidos los parámetros del menú Inicio.

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 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 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 es posible cuando intenta conectarse al almacén mediante la utilidad para enumerar o iniciar los recursos de Citrix Virtual Apps and Desktops publicados. Como solución temporal, utilice el módulo AuthManager externo si no proporciona 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.