Storebrowse

Nota:

Este artículo solo se aplica a las implementaciones locales de Citrix Workspace. Para las implementaciones de la nube, consulte la documentación de Storebrowse para Workspace.

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 con Citrix Gateway.

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

  • Agregar un almacén.
  • Producir una lista de las aplicaciones y los escritorios publicados desde un almacén configurado.
  • Generar un archivo ICA manualmente seleccionando cualquier escritorio o aplicación virtual publicados.
  • Generar un archivo ICA mediante la línea de comandos de Storebrowse.
  • Iniciar la aplicación publicada.

La utilidad Storebrowse forma parte del componente Authmanager. Al completar la instalación de 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 1808 para Windows 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 estos sistemas operativos:

Sistema operativo
Windows 10 (ediciones de 32 y 64 bits)
Windows Server 2022
Windows Server 2016
Windows Server 2008 R2, edición de 64 bits
Windows Server 2008 R2, edición de 64 bits

Conexiones

La utilidad Storebrowse admite estos 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 PassThrough de dominios, consulte Configurar la autenticación PassThrough.
  • HTTP básica: Este método lo utilizan portales web e integraciones de clientes de terceros, donde se usa una interfaz de usuario externa para capturar un nombre de usuario y una contraseña aptos para el dominio. StoreFront utiliza la función de autenticación básica de IIS para transportar las credenciales al servidor de StoreFront. A continuación, StoreFront utiliza los Servicios de dominio o la autenticación de XML Broker Service para validar las credenciales y obtener la información del grupo. Para obtener información sobre cómo habilitar la autenticación HTTP básica, consulte HTTP básica en la documentación sobre Administrar métodos de autenticación.

La utilidad Storebrowse permite la autenticación de cualquiera de estas maneras:

  • Mediante el componente AuthManager, integrado en la utilidad Storebrowse. Nota: Habilite el método de autenticación HTTP básica en StoreFront mientras trabaje con la utilidad Storebrowse. Este método es aplicable cuando el usuario proporciona las credenciales mediante los comandos de Storebrowse.
  • Utilice el Authmanager que se incluye en la aplicación Citrix Workspace para Windows. Puede utilizar este método cuando utilice la autenticación Pass-Through de dominio. Para obtener más información, consulte la documentación de Autenticación PassThrough de dominio.

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.

Nota:

No puede abrir aplicaciones SaaS ni contenido publicado mediante comandos de Storebrowse.

Uso de comandos

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

Agregar un almacén

-a, --addstore

Descripción:

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

Ayuda

/?

Descripción:

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

Enumerar almacenes

(-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

Enumerar

(-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>

Inicio rápido

-q, --quicklaunch

Descripción:

Genera el archivo ICA para las aplicaciones y los escritorios publicados mediante 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 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

Las URL de inicio suelen ser 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>

Inicio

-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 este 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 del 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>

Lanzamiento de sesiones

-S, --sessionlaunch

Descripción:

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

  • Nombre de usuario
  • Contraseña
  • 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 este 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 del resultado anterior se usa como el parámetro de entrada de 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>

Carpeta de archivos

-f, --filefolder

Descripción:

Genera el archivo ICA en la ruta personalizada para las 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 el dispositivo Citrix Gateway:

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

Autenticación del seguimiento

-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}

Eliminar un almacén

-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

Seguimiento del estado de los comandos de Storebrowse

A partir de la versión 2305.1, puede realizar un seguimiento del estado de ejecución de comandos de Storebrowse en un archivo. Para realizar un seguimiento del estado de operación correcta, proporcione un nombre de archivo único con el comando -f launch. Este comando genera un archivo con el nombre proporcionado. El estado de operación fallida está presente en el archivo ica.error, que se crea automáticamente.

Nota:

Asegúrese de agregar una .ica extensión al nombre del archivo con el comando -f launch. De lo contrario, el archivo no se generará.

Los archivos para realizar un seguimiento tanto de las operaciones correctas como de las erróneas están presentes en %LOCALAPPDATA%\citrix\selfservice\cache, y puede supervisarlos según sea necesario.

Esta mejora está habilitada de forma predeterminada.

A continuación, se muestra un ejemplo de cómo utilizar el comando de inicio con la opción -f:


-launch -f <uniqueFileName.ica> "launchcommandline"
For example:
SelfService.exe storebrowse -launch -f uniqueFileName.ica -s store0-5c3ec017 -CitrixID store0-5c3ec017@@a9a8e3ac-099d-4577-b84e-e33d0695df39.Notepad -ica "https://cwawiniwstest.cloudburrito.com/Citrix/Store/resources/v2/YTlhOGUzYWMtMDk5ZC00NTc3LWI4NGUtZTMzZDA2OTVkZjM5Lk5vdGVwYWQ-/launch/ica" -cmdline

<!--NeedCopy-->

Función Single Sign-On en Citrix Gateway

Single Sign-On permite autenticarse en un dominio y usar Citrix Virtual Apps and Desktops y Citrix DaaS (anteriormente Citrix Virtual Apps and Desktops Service) que proporciona el dominio. Puede iniciar sesión sin tener que reautenticarse en cada aplicación o escritorio. Al agregar 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 y Citrix DaaS, y 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).

  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 e intenta conectarse al almacén mediante la utilidad para comprobar o iniciar las aplicaciones o escritorios virtuales publicados, no se permite introducir credenciales mediante la opción de línea de comandos. 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.

Para habilitar SSON para aplicaciones de terceros que usan ICOSDK, cree este Registro:

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

Ejemplo:

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

Nota:

  • Puede proporcionar varias aplicaciones de terceros separadas por puntos y comas.
  • Esta función es compatible a partir de la versión 2107.
Storebrowse