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 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 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 Datacenter |
Windows Server 2012, ediciones Standard y Datacenter |
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.
- Autenticación HTTP básica: La utilidad Storebrowse requiere que la autenticación HTTP básica esté habilitada para poder comunicarse con los servidores de StoreFront. Esta opción está inhabilitada de forma predeterminada en el servidor de StoreFront. Debe habilitar el método Autenticación HTTP básica.
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. Esto es aplicable cuando el usuario proporciona las credenciales mediante los comandos de Storebrowse. - Componente
Authmanager
externo que se puede incluir con la aplicación Citrix Workspace para Windows.
Single Sign-On en Citrix Gateway
Además de la recién agregada compatibilidad con Citrix Gateway, ahora puede usar Single Sign-On en él. Puede agregar un almacén y enumerar los recursos publicados sin tener que proporcionar sus credenciales de usuario.
Para obtener más información sobre la disponibilidad de Single Sign-On en Citrix Gateway, consulte Disponibilidad de Single Sign-On en Citrix Gateway.
Nota:
Esta función solo se admite en máquinas unidas a dominio en las que Citrix Gateway está configurado con el método de autenticación Single Sign-On.
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.
Uso de comandos
En la siguiente sección se ofrece información detallada sobre los comandos que se pueden usar desde la utilidad Storebrowse.
-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>
/?
Descripción:
Ofrece información detallada sobre el uso de la utilidad Storebrowse.
(-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
(-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>
-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>
-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>
-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>
-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}
-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}
-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
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).
- Abra la plantilla administrativa de GPO de la aplicación Citrix Workspace; para ello, ejecute gpedit.msc.
- 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.
- Utilice las opciones de activación o desactivación para habilitar o inhabilitar la opción Single Sign-On.
- Haga clic en Aplicar y Aceptar.
- 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
) yDomain (-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.