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 dentro de StoreFront y con Citrix Gateway.

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

  • Agregar un almacén.
  • Enumerar las aplicaciones y escritorios publicados de un almacén configurado.
  • Generar un archivo ICA® seleccionando manualmente cualquier aplicación y escritorio virtual publicados.
  • Generar un archivo ICA usando la línea de comandos de Storebrowse.
  • Iniciar la aplicación publicada.

La utilidad Storebrowse forma parte del componente Authmanager. Cuando la instalación de la aplicación Citrix Workspace finaliza, la utilidad Storebrowse se encuentra en la carpeta de instalación de AuthManager.

Para confirmar que la utilidad Storebrowse está instalada junto con el componente Authmanager, comprueba la siguiente ruta del Registro:

Cuando la aplicación Citrix Workspace la instalan los administradores:

   
En un equipo de 32 bits [HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\AuthManager\Install]
  • En un equipo de 64 bits [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\AuthManager\Install]
  • Cuando la aplicación Citrix Workspace la instalan los usuarios (no administradores):
   
En un equipo de 32 bits [HKEY_CURRENT_USER\SOFTWARE\Citrix\AuthManager\Install]
En un equipo de 64 bits [HKEY_CURRENT_USER\SOFTWARE\WOW6432Node\Citrix\AuthManager\Install]

Requisitos

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

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 Data center
  • Windows Server 2012, ediciones Standard y Data center
  • 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 posterior

Nota:

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

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 inhabilitados de forma predeterminada al crear un almacén.

  • Nombre de usuario y contraseña: Introduce las credenciales para autenticarte y acceder a los almacenes. De forma predeterminada, la autenticación explícita está habilitada cuando creas tu primer almacén.
  • Autenticación de paso a través de dominio: Después de autenticarte en los equipos Windows unidos a un dominio, inicias sesión automáticamente en los almacenes. Para usar esta opción, habilita la autenticación de paso a través al instalar la aplicación Citrix Workspace. Para obtener más información sobre la autenticación de paso a través de dominio, consulta Configurar la autenticación de paso a través.
  • HTTP Basic: Habilita la autenticación HTTP Basic para que la utilidad Storebrowse pueda comunicarse con los servidores StoreFront. Esta opción está inhabilitada de forma predeterminada en el servidor StoreFront. Habilita 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: Habilita el método de autenticación HTTP Basic en StoreFront cuando trabajes 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.

Inicio de sesión único con Citrix Gateway

Además de la compatibilidad con Citrix Gateway recién agregada, ahora puedes usar el inicio de sesión único con él. Puedes agregar un 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 se admite en equipos unidos 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 la devolución falla, se informa de un error.

Nota:

La configuración de varios almacenes es compatible con 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:

Proporciona detalles sobre el uso de la utilidad Storebrowse.

(-l), --liststore

Descripción:

Enumera los almacenes que ha agregado 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.

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 aplicaciones y escritorios publicados usando la utilidad Storebrowse. La opción quicklaunch requiere una URL de inicio como entrada junto con la URL del almacén. La URL de inicio 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 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 lanzamiento típica es 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 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 de la tienda. El nombre puede ser el servidor StoreFront o la URL de Citrix Gateway. El archivo ICA se genera en el directorio %LocalAppData%\Citrix\Storebrowse\cache.

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

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

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, puedes agregar una tienda, verificar y lanzar los recursos publicados. Esta opción toma los siguientes parámetros:

  • Nombre de usuario
  • Contraseña
  • Dominio
  • Nombre del recurso a lanzar
  • URL de la tienda

Sin embargo, si el usuario no proporciona las credenciales, AuthManager solicita que las introduzcas y luego se lanza 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 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 -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 personalizada para las aplicaciones y escritorios publicados.

La opción de lanzamiento requiere un nombre de carpeta y el nombre del recurso como entrada con la URL de la tienda. La URL de la tienda puede ser 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. Los registros se generan solo si la utilidad Storebrowse usa un AuthManager integrado. Los registros se generan en el directorio localappdata%\Citrix\Storebrowse\logs.

Nota:

Esta opción no debe ser el último parámetro listado 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 una 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

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

El inicio de sesión único te permite autenticarte en un dominio y usar las aplicaciones y escritorios virtuales de Citrix™ y Citrix DaaS (anteriormente servicio de aplicaciones y escritorios virtuales de Citrix) que proporciona el dominio. Puedes iniciar sesión sin tener que volver a autenticarte en cada aplicación o escritorio. Cuando agregas una tienda, tus credenciales pasan por el servidor Citrix Gateway, junto con las aplicaciones y escritorios virtuales de Citrix y Citrix DaaS, y la configuración del menú Inicio.

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 de dominio.

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

  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 Plantilla administrativa > 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:

  • Habilita el método de Autenticación básica HTTP en el servidor StoreFront para operaciones de inyección de credenciales con la utilidad Storebrowse.
  • Si tienes una tienda HTTP e intentas conectarte a ella usando la utilidad para verificar o lanzar las aplicaciones y escritorios virtuales publicados, la inyección de credenciales usando la opción de línea de comandos no es compatible. Como solución alternativa, usa el módulo AuthManager externo si no proporcionas credenciales usando la línea de comandos.
  • La utilidad Storebrowse actualmente solo admite una única tienda configurada en Citrix Gateway en el servidor StoreFront.
  • La inyección de credenciales en la utilidad Storebrowse solo funciona si Citrix Gateway está configurado con autenticación de un solo factor.
  • 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 estar solo en mayúsculas.

Para habilitar SSON para aplicaciones de terceros que usan ICOSDK, crea el siguiente registro:

  • Clave de registro: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\ICA Client\NonIEAppsWithSson
  • Valor de registro: ruta completa de las aplicaciones de terceros
  • Tipo de registro: reg_multi_sz

Ejemplo:

  • Clave de registro: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\ICA Client\NonIEAppsWithSson
  • Valor de registro: C:\temp1\abc.exe;C:\temp2\xyz.exe
  • Tipo de registro: reg_multi_sz

Nota:

  • Puedes proporcionar varias aplicaciones de terceros separadas por punto y coma.
Storebrowse