Citrix Workspace app for Windows

Storebrowse

Nota:

Este artículo es aplicable 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.

  • Mediante 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 publicado.
  • 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):

   
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 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
Ediciones de Windows 10 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 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.
  • Transferencia 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 transferencia al instalar la aplicación Citrix Workspace. Para obtener más información sobre la transferencia de dominio, consulta Configuración de la autenticación de transferencia.
  • 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. A continuación, StoreFront usa 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 básica HTTP, consulta HTTP Basic en la documentación de Administrar métodos de autenticación.
  • Directivas avanzadas de NetScaler para Storebrowse: La aplicación Citrix Workspace para Windows admite directivas avanzadas en NetScaler Gateway con Storebrowse. El protocolo de autenticación admitido es la autenticación LDAP.

Nota:

El protocolo de autenticación nFactor no es compatible con Storebrowse en Windows.

La utilidad Storebrowse admite métodos de autenticación en cualquiera de los siguientes métodos:

  • Mediante el AuthManager integrado junto con la utilidad Storebrowse. Nota: Habilita el método de autenticación básica HTTP en StoreFront mientras trabajas 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 utilizas la autenticación de transferencia de dominio. Para obtener más información, consulta la documentación de Autenticación de transferencia 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 los 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 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>

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 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 la del servidor StoreFront o la 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 del 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>

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 a iniciar
  • URL del almacén

Sin embargo, si el usuario no proporciona las credenciales, AuthManager solicita que se introduzcan las credenciales y luego 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 la siguiente salida:

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

El nombre que aparece en negrita en 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 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 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}

Autenticación de 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 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

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 fallo se encuentra en el archivo ica.error, que se crea automáticamente.

Nota:

Asegúrate de añadir 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 fallo 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 inicio de sesión único (SSO) con Citrix Gateway

El inicio de sesión único te permite autenticarte en un dominio y usar Citrix Virtual Apps and Desktops™ y Citrix DaaS (anteriormente servicio Citrix Virtual Apps and Desktops) que el dominio proporciona. 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 la Store usando la utilidad para comprobar 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 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 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 el SSO 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.
Storebrowse