Storebrowse

Nota:

Este artículo se aplica solo a implementaciones locales de Citrix Workspace. Para implementaciones en la nube, consulta 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 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 los escritorios publicados desde un almacén configurado.
• Generar un archivo ICA® seleccionando manualmente cualquier aplicación y escritorio 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. 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 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 la aplicación Citrix Workspace la instalan los usuarios (no administradores):

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:

• 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 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 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 al 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: Este método lo usan las integraciones de clientes de terceros y los portales web, donde se ha usado una interfaz de usuario externa para capturar un nombre de usuario y una contraseña calificados por dominio. StoreFront usa la función de autenticación básica en IIS para transportar las credenciales al servidor StoreFront. StoreFront usa entonces los Servicios de dominio o la autenticación del servicio XML de Broker para validar las credenciales y obtener la información del grupo. Para obtener información sobre cómo habilitar la autenticación HTTP Basic, consulta HTTP Basic en la documentación de Administrar métodos de autenticación.

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

• Usando el AuthManager integrado con la utilidad Storebrowse. Nota: Habilita el método de autenticación HTTP Basic en StoreFront cuando trabajes con la utilidad Storebrowse. Este método se aplica cuando el usuario proporciona las credenciales mediante los comandos de Storebrowse.
• Usa el Authmanager que se incluye con la aplicación Citrix Workspace para Windows. Puedes usar este método cuando utilices la autenticación de paso a través de dominio. Para obtener más información, consulta la documentación de Autenticación de paso a través de dominio.

Iniciar un escritorio o una aplicación publicados

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

Nota:

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

Uso de comandos

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

Agregar un almacén

-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 utilidad Storebrowse admite la configuración de 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>

Lo anterior funcionará si StoreFront configurado con Gateway tiene un solo almacén.

Si StoreFront configurado con Gateway tiene varios almacenes, se debe usar el siguiente comando:

Comando: storebrowse.exe –U *username* -P *password* -D *domain* -a *URL of CitrixGateway*?StoreName

• Ejemplo: .\storebrowse.exe –U {Username} –P {Password} –D {Domain} –a https://mysecondexample.com?Store

• Ayuda

• /?

Descripción:

Proporciona detalles sobre el uso de la utilidad Storebrowse.

Enumerar almacenes

(-l), --liststore

Descripción:

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

Inicio rápido

-q, --quicklaunch

Descripción:

Genera el archivo ICA para las aplicaciones y 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 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 inicio 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>

Iniciar

• -L, --launch

• Descripción:

• Genera el archivo ICA necesario para las aplicaciones y escritorios publicados mediante la utilidad Storebrowse. La opción de inicio requiere el nombre del recurso junto con la URL del almacén. 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 el siguiente resultado:

• '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>

Inicio de sesión

-S, --sessionlaunch

Descripción:

Con este comando, puedes agregar un almacén, verificar y lanzar los recursos publicados. Esta opción toma los siguientes 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 solicita que se introduzcan las credenciales y, a continuación, se inicia 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 el siguiente resultado:

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

El nombre que aparece en negrita en el resultado anterior se utiliza 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>

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 lanzamiento requiere un nombre de carpeta y el nombre del recurso como entrada con la URL de la Store. La URL de la Store 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}

Rastrear autenticación

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

Eliminar una Store

-d, --deletestore

Descripción:

Elimina una Store 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

Seguimiento del estado de los comandos de Storebrowse

A partir de la versión 2305.1, puedes realizar un seguimiento del estado de ejecución de un comando de Storebrowse en un archivo. Para realizar un seguimiento del estado de éxito, proporciona un nombre de archivo único con el comando -f launch. Este comando genera un archivo con el nombre que has proporcionado. El estado de error se encuentra en el archivo ica.error, que se crea automáticamente.

Nota:

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

Los archivos para realizar un seguimiento tanto del éxito como del error se encuentran en %LOCALAPPDATA%\citrix\selfservice\cache y puedes supervisarlos según sea necesario.

Esta mejora está habilitada de forma predeterminada.

A continuación, se muestra un ejemplo de cómo usar el comando de lanzamiento 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-->

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

El inicio de sesión único te permite autenticarte en un dominio y usar las aplicaciones y escritorios virtuales de Citrix Virtual Apps and Desktops™ y Citrix DaaS (anteriormente servicio Citrix Virtual Apps and Desktops) que proporciona el dominio. Puedes iniciar sesión sin tener que volver a autenticarte en cada aplicación o escritorio. Cuando agregas una Store, tus credenciales pasan por el servidor Citrix Gateway, junto con Citrix Virtual Apps and Desktops 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 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).

1. Abre la plantilla administrativa 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 las operaciones de inyección de credenciales con la utilidad Storebrowse.
• Si tienes una Store HTTP e intentas conectarte a la Store usando la utilidad para comprobar o iniciar 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 mediante la línea de comandos.
• La utilidad Storebrowse actualmente solo admite una única Store 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 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 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.
• Esta función es compatible con la versión 2107 en adelante.

Gestión mejorada de sesiones de Storebrowse

A partir de esta versión, la gestión de sesiones de Storebrowse se ha mejorado con las siguientes optimizaciones, que mejoran la experiencia del usuario y la gestión de recursos críticos en entornos de alta disponibilidad para aumentar la eficiencia:

• Storebrowse ignora de forma inteligente las sesiones existentes al iniciar aplicaciones virtuales - Esta opción evita las reconexiones a sesiones que el sistema está cerrando activamente, lo que mejora la estabilidad. Esto garantiza un acceso fluido y sin errores a las aplicaciones empresariales críticas, especialmente durante las actualizaciones del cliente, simplificando la gestión al reducir las necesidades de configuración complejas. Para habilitar la gestión inteligente de sesiones, los administradores deben agregar el parámetro -I true a los comandos existentes de Storebrowse. Este parámetro se integra sin problemas con todos los tipos de lanzamiento existentes, manteniendo la estructura de sintaxis actual.

  Ejemplo de comando:

  Inicio rápido:

  Sintaxis anterior:

   .\storebrowse.exe -U {Username} -P {Password} –D {Domain} -q {Launch_URL_of_published_ apps and desktops} <https://cwa-ddc2c.cwa.com/Citrix/Store/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9yLVRTVkRBMTk-/launch/ica> < https://cwa-ddc2c.cwa.com/citrix/store/discovery>
   <!--NeedCopy-->
  

  Sintaxis mejorada con gestión inteligente de sesiones:

   .\storebrowse.exe -U {Username} -P {Password} –D {Domain} -I true -q {Launch_URL_of_published_ apps and desktops} https://cwa-ddc2c.cwa.com/Citrix/Store/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9yLVRTVkRBMTk-/launch/ica> < https://cwa-ddc2c.cwa.com/citrix/store/discovery>
   <!--NeedCopy-->
  

• Compatibilidad de la API de Storebrowse para devolver listas de sesiones - Esta opción proporciona una visibilidad valiosa de las sesiones de usuario activas, lo que permite lanzamientos de sesiones más contextualizados y eficientes. Esta visibilidad mejorada disminuye los errores que afectan al usuario y los retrasos durante el acceso a las aplicaciones, lo que garantiza una experiencia más fluida y fiable para todos los usuarios.