Storebrowse

Nota:

Este artículo es aplicable únicamente 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 utiliza 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 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 se completa la instalación de la aplicación Citrix Workspace, 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 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 deshabilitados 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.
• 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 el paso a través de dominio, consulta Configurar la autenticación de paso a través.
• HTTP Basic: Este método lo utilizan integraciones de clientes de terceros y portales web, donde se ha utilizado una interfaz de usuario externa para capturar un nombre de usuario y una contraseña calificados por el dominio. StoreFront utiliza la función de autenticación básica en IIS para transportar las credenciales al servidor StoreFront. StoreFront utiliza 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:

• Mediante el AuthManager integrado en 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 escritorio o 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:

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

Ejemplo:

[[CODE_BLOCK_1]]

Ejemplo de comando en Citrix Gateway:

Comando:

[[CODE_BLOCK_2]]

Ejemplo:

[[CODE_BLOCK_3]]

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

• Si StoreFront configurado con Gateway tiene varios almacenes, debes 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.

Listar almacenes

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

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 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 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 aplicaciones y escritorios publicados usando 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 da como resultado 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>

Inicio de sesión

-S, --sessionlaunch

Descripción:

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

• Nombre de usuario
• Contraseña
• Dominio
• Nombre del recurso a iniciar
• URL del almacén

Sin embargo, si el usuario no proporciona las credenciales, AuthManager te pedirá que las introduzcas y luego se iniciará 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 da como resultado la siguiente salida:

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

La cadena en negrita de la salida 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 archivo

-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 junto con la URL de la Store. La URL de la Store 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}

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

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 rastrear tanto el éxito como el fallo se encuentran en %LOCALAPPDATA%\citrix\selfservice\cache y puedes monitorearlos 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 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 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 a través del servidor de Citrix Gateway, junto con Citrix Virtual Apps and Desktops y Citrix DaaS, y la configuración del menú Inicio.

Esta característica 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 característica 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 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 de StoreFront para las operaciones de inyección de credenciales con la utilidad Storebrowse.
• Si tienes una Store HTTP e intentas conectarte a ella usando la utilidad para comprobar o lanzar las aplicaciones y escritorios virtuales publicados, la inyección de credenciales mediante 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 de 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 característica es compatible con la versión 2107 en adelante.