Documento técnico: Guía de inicio rápido de la aplicación Citrix Workspace

Introducción

La aplicación Citrix Workspace para Windows proporciona acceso a los recursos de un usuario mediante Citrix Virtual Apps and Desktops. Estos recursos incluyen SaaS, aplicaciones web y heredadas y escritorios. La aplicación Citrix Workspace proporciona acceso desde el escritorio, el menú de inicio, la interfaz de usuario de Citrix Workspace y los exploradores web.

En una nota al margen, es posible acceder a recursos en un dispositivo Windows mediante la aplicación Citrix Workspace para HTML5, sin necesidad de instalar la aplicación Citrix Workspace para Windows. Sin embargo, existe una importante disparidad de funciones entre ambos clientes. Para obtener una descripción completa de todas las funciones compatibles con cada una de las versiones disponibles de la aplicación Workspace, consulte la tabla de funciones de la aplicación Citrix Workspace.

Instalación

La versión más reciente de la aplicación Citrix Workspace para Windows se puede descargar aquí. La aplicación Citrix Workspace se puede instalar tanto en sus clientes Windows como en los trabajadores de Citrix (sus VDA).

Aunque técnicamente posible, no hay necesidad de extraer los archivos incluidos en CitrixWorkspaceApp.exe. Es muy recomendable instalar la aplicación Citrix Workspace mediante el ejecutable directamente.

Es posible cambiar el nombre del archivo de instalación CitrixWorkspaceApp.exe a CitrixWorkspaceAppWeb.exe. Al cambiar el nombre de este archivo se elimina el botón Agregar cuenta de la última ventana de diálogo al final de la instalación. También evita que aparezca la ventana Agregar cuenta (Primer uso, FTU) en el primer inicio de sesión. Este modo es más adecuado si solo se planea el acceso a través del almacén web.

En caso de que quiera instalar la aplicación Citrix Workspace sin privilegios administrativos, tenga en cuenta lo siguiente:

Argumentos de línea de comandos

La aplicación Citrix Workspace incluye muchos parámetros de instalación. Para obtener una visión general completa de todos los parámetros disponibles, consulte la documentación del producto.

Para una implementación correcta, asegúrese de comprender cada uno de los parámetros y de que están alineados con los requisitos de su organización. Por ejemplo:

Al actualizar a la aplicación Citrix Workspace desde una versión anterior y no compatible (por ejemplo, Citrix Receiver 3.4), asegúrese de utilizar el parámetro /rcu o /forceinstall (aplicación Citrix Workspace 1909 y posterior).

Tenga en cuenta que algunos componentes, por ejemplo, habilitar el inicio de sesión único, requieren un reinicio de la máquina local.

Aquí hay un ejemplo de la sintaxis de la línea de comandos: CitrixWorkspaceApp.exe /silent /includeSSON /FORCE_LAA=1

Ruta de instalación

La ruta de instalación predeterminada para instalaciones basadas en equipos es C:\Program Files (x86)\ Citrix\ ICA Client.

La aplicación Citrix Workspace escribe varios archivos de registro en el directorio%TEMP% de la subcarpeta CTXReceiverInstallLogs-%DATE%-%TIME% . Se crean los siguientes archivos de registro:

La ubicación exacta de la carpeta temporal depende del usuario que ejecute la instalación. Por ejemplo, la carpeta temporal de la cuenta del sistema local (utilizada por Microsoft SCCM, por ejemplo) es C:\Windows\Temp. No se puede cambiar la ruta del archivo de registro. Es posible copiar los archivos de registro en un directorio diferente una vez finalizada la instalación de la aplicación Citrix Workspace.

Configuración

En una infraestructura de Active Directory, la aplicación Citrix Workspace se puede configurar de forma centralizada mediante directivas de grupo de Microsoft. Esto requiere que las plantillas administrativas (los archivos ADMX y ADML) de la aplicación Citrix Workspace se copien en el almacén central de directivas de grupo.

Los archivos ADMX contienen la configuración real. Los archivos ADML son los archivos de idioma que contienen el texto que se muestra en la Consola de administración de directivas de grupo.

Los archivos de plantilla administrativa se incluyen en el directorio de instalación de la aplicación Citrix Workspace:

También se pueden descargar del sitio web de Citrix en la sección Descargas para administradores (herramientas de implementación).

Copie los archivos ADMX y ADML en el almacén Central de directivas de grupo:

Para realizar pruebas, puede copiar las plantillas administrativas en un equipo local (C:\Windows\PolicyDefinitions) y utilizar el editor de directivas de grupo local (gpedit.msc) para ver y administrar la configuración.

La aplicación Citrix Workspace incluye configuraciones por equipo y por usuario. Hay muchos ajustes disponibles, por ejemplo:

Al iniciar una sesión, se puede presentar al usuario una ventana de diálogo pidiendo permisos relativos al acceso al dispositivo (por ejemplo, para unidades locales, cámaras web o micrófonos). De forma predeterminada, las restricciones del dispositivo cliente de Desktop Viewer se basan en la región de Internet. Este comportamiento se puede cambiar creando y configurando las claves del Registro de confianza selectiva de cliente. Como administrador, puede definir el nivel de acceso modificando el Registro. Hay cuatro niveles de acceso:

Las claves y valores del Registro de confianza selectiva de cliente no se crean automáticamente. Se pueden crear y configurar mediante Directiva de grupo o directamente en el Registro. El siguiente artículo proporciona información detallada sobre cómo configurar los parámetros del Registro de Confianza selectiva del cliente: CTX133565.

En el artículo, se puede descargar un archivo ZIP que contenga archivos de directiva de grupo (ADM, ADMX y AMDL) y archivos REG. Cuando se utiliza la directiva de grupo para configurar los clientes, el enfoque recomendado es utilizar los archivos ADMX y ADML.

Directivas de grupo de confianza selectivas de clientes

También es posible utilizar el archivo REG para crear y configurar las claves y valores del Registro de confianza selectiva de cliente. Utilice el archivo ReceivercstRegupX64.reg para sistemas operativos de 64 bits o ReceivercstRegupx86.reg para sistemas operativos de 32 bits. Cuando utilice el archivo REG, tenga en cuenta que los usuarios pueden cambiar la configuración de acceso al dispositivo. Si quiere evitar que el usuario cambie las preferencias, establezca el valor (Predeterminado) en la siguiente clave del Registro en false:

HKLM\SOFTWARE\WOW6432Node\Citrix\ICA Client\Client Selective Trust\oidPredefinedSecurityPolicySettings\InstantiatedSecurityPolicyEditable

A veces, se requieren plantillas administrativas de otros productos para configurar el comportamiento de la aplicación Citrix Workspace.

Advertencia: Las siguientes configuraciones pueden permitir que los sitios web malintencionados inicien una sesión silenciosamente en sus agentes VDA malintencionados sin ningún tipo de solicitud.

Por ejemplo, cuando se muestra la solicitud Abrir Citrix Workspace Launcher en Google Chrome y Microsoft Edge en Chromium cada vez que un usuario inicia un recurso de StoreFront, configure las siguientes opciones:

Los archivos ADMX necesarios se pueden descargar aquí:

Optimización y seguridad

Trabajar con aplicaciones y escritorios virtuales en sistemas remotos significa dos cosas:

  1. Los recursos (CPU/RAM) del sistema remoto son utilizados por varios usuarios al mismo tiempo y a veces pueden ejecutarse bajo una carga pesada.
  2. La comunicación entre el dispositivo de punto final local y el sistema remoto puede ser inferior a la óptima debido al rendimiento de la red (por ejemplo, latencia y fluctuación).

Por esta razón, se han introducido varias funciones de optimización.

Citrix HDX RealTime Optimization Pack

Una de estas funciones se refiere a Citrix HDX RealTime Optimization Pack para Microsoft Skype for Business. El RealTime Optimization Pack consta de dos componentes:

  1. HDX RealTime Media Engine (se ejecuta en el extremo local junto con la aplicación Citrix Workspace).
  2. HDX RealTime Connector (se ejecuta en el VDA en el centro de datos junto con el cliente Microsoft Skype for Business).

HDX RealTime Media Engine realiza el procesamiento de medios directamente en el dispositivo del usuario. Traspasa la carga fuera del servidor para una mayor escalabilidad, reduciendo el consumo de ancho de banda de red y garantizando una calidad óptima de sonido y vídeo.

HDX RealTime Media Engine solo se puede instalar cuando la aplicación Citrix Workspace ya está presente.

Descargue la última versión de Citrix RealTime Optimization Pack aquí.

Para obtener más información sobre Citrix HDX RealTime Optimization Pack for Microsoft Skype for Business, consulte la documentación del producto.

Optimización para Microsoft Teams

En cuanto a Microsoft Teams, no se requiere ninguna optimización adicional. Todas las funciones de optimización disponibles se incluyen de forma predeterminada en la aplicación Citrix Workspace y Virtual Delivery Agent (VDA) en las siguientes versiones:

Para obtener más información, consulte la documentación del producto.

Redirección de contenido de explorador web

La función de redirección de contenido del explorador impide la representación de páginas web en la lista de permitidos en el lado del VDA. En su lugar, las páginas web se representan en el extremo local.

Para obtener más información sobre cómo configurar la redirección de contenido del explorador web, consulte la documentación del producto.

Citrix Desktop Lock

Es posible que algunos usuarios de su organización no necesiten interactuar con el escritorio local de su PC; es posible que solo necesiten su escritorio virtual. Citrix Desktop Lock puede bloquear equipos físicos y coloca estas máquinas en modo kiosco de forma efectiva. Cuando se inicia la PC, el usuario se presenta con su escritorio virtual en lugar del escritorio del sistema operativo local.

Citrix Desktop Lock es un componente independiente y no está incluido en la aplicación Citrix Workspace. La aplicación Citrix Workspace debe instalarse antes de instalar Citrix Desktop Lock. SSON debe estar habilitado al instalar la aplicación Citrix Workspace y debe configurarse un almacén, ya sea durante la instalación o mediante una directiva de grupo. Citrix Desktop Lock funciona en máquinas unidas a dominios.

Descargue la última versión de Citrix Desktop Lock aquí.

Para obtener más información sobre la instalación y configuración de Citrix Desktop Lock, consulte la documentación del producto.

Protección de aplicaciones

La versión 1912 de la aplicación Citrix Workspace introdujo la nueva función de seguridad de la protección de aplicaciones. Esta es una función complementaria para la aplicación Citrix Workspace que proporciona seguridad mejorada al usar recursos publicados de Citrix Virtual Apps and Desktops. Para ser más específico. Laprotección de aplicaciones proporciona funciones antirregistro de teclas y captura de pantalla en una sesión de Citrix HDX.

Para instalaciones silenciosas, asegúrese de incluir el modificador /includeappprotection al instalar la aplicación Citrix Workspace (documentación del producto).

Para obtener más información sobre la protección de aplicaciones, consulte la documentación del producto.

Automatización

Es posible que las organizaciones más grandes quieran automatizar la instalación y configuración de la aplicación Citrix Workspace en sus dispositivos de terminales Windows. Hay varias maneras de hacer esto.

Se pueden descargar varios scripts de implementación (archivos*.bat) desde la siguiente URL de la sección Descargas para administradores.

Antes de que puedan implementarse, estos archivos por lotes primero deben personalizarse para adaptarse al entorno de su organización.

Otra opción es utilizar un script personalizada de PowerShell como esta:

Renuncia de responsabilidades

Estas aplicaciones de software se proporcionan a usted tal como está sin representaciones, garantías o condiciones de ningún tipo. Puede utilizarla y distribuirla, bajo su propio riesgo. CITRIX RENUNCIA A TODAS LAS GARANTÍAS, EXPRESAS, IMPLÍCITAS, ESCRITAS, ORALES O LEGALES, INCLUIDAS, ENTRE OTRAS, GARANTÍAS DE COMERCIABILIDAD, IDONEIDAD PARA UN PROPÓSITO PARTICULAR, TÍTULO Y NO INFRACCIÓN. Sin limitar el carácter general de lo anteriormente expuesto, Ud. reconoce y acepta (a) que la aplicación de software puede presentar errores, fallos de diseño o cualquier otro problema, que pueden provocar una pérdida de datos o daños materiales; (b) que puede que no sea posible hacer funcionar por completo la aplicación de software; y (c) que sin previo aviso y sin responsabilidad respecto a Ud., Citrix puede dejar de poner a su disposición la versión actual o las versiones futuras de esta aplicación de software. El código no debe utilizarse en ningún caso para dar apoyo a actividades de riesgo extremo, incluidas, a título enunciativo, actividades de explosión o de soporte vital. NI CITRIX NI SUS AFILIADOS O AGENTES SERÁN RESPONSABLES, EN CASO DE INCUMPLIMIENTO DE CONTRATO O CUALQUIER OTRA TEORÍA DE RESPONSABILIDAD, DE CUALQUIER DAÑO QUE SURJA DEL USO DE LA APLICACIÓN DE SOFTWARE, INCLUYENDO, SIN LIMITACIÓN, DAÑOS DIRECTOS, ESPECIALES, INCIDENTALES, PUNITIVOS, CONSECUENCIALES O DE OTRO TIPO, INCLUSO SI SE ADVIERTE DEL POSIBILIDAD DE TALES DAÑOS. Ud. acepta indemnizar y defender a Citrix contra cualquier tipo de reclamación relativa al uso, modificación o distribución del código.

Ejemplo de script

#==========================================================================
# INSTALLING AND CONFIGURING CITRIX WORKSPACE APP FOR WINDOWS
#
# Author: Citrix Systems, Inc.
# Date  : 16.03.2020
# Editor: Microsoft Visual Studio Code
# Citrix Workspace app versions supported by this script: ALL
#==========================================================================

# Error handling
$global:ErrorActionPreference = "Stop"
if($verbose){ $global:VerbosePreference = "Continue" }

# Disable File Security (prevents the "Open File – Security Warning" dialog -> "Do you want to run this file")
$env:SEE_MASK_NOZONECHECKS = 1

# Custom variables [edit | customize to your needs]
$LogDir = "C:\Logs\Citrix Workspace app"                                       # the full path to your log directory
$LogFile = Join-Path $LogDir "Install Citrix Workspace app.log"                # the full path to your log file
$StartDir = $PSScriptRoot                                                      # the directory path of the installation file(s). $PSScriptRoot is the directory of the current script.
$InstallFileName = "CitrixWorkspaceApp.exe"                                    # the name of the installation file. Options: 'CitrixWorkspaceApp.exe' or 'CitrixWorkspaceAppWeb.exe'.
$InstallArguments = "/silent /includeSSON /FORCE_LAA=1"                        # the command line arguments for the installation file
$ClientSelectiveTrustRegKeys = "CitrixWorkspaceApp_Client_Selective_Trust.reg" # the name of the registry file containing the Client Selective Trust settings

# Create the log directory if it does not exist
if (!(Test-Path $LogDir)) { New-Item -Path $LogDir -ItemType directory | Out-Null }

# Function WriteToLog
Function WriteToLog {
    param(
        [string]$InformationType,
        [string]$Text
    )

    $DateTime = (Get-Date -format dd-MM-yyyy) + " " + (Get-Date -format HH:mm:ss)
    if ( $Text -eq "" ) {
        Add-Content $LogFile -value ("")   # Write an empty line
    } else {
        Add-Content $LogFile -value ($DateTime + " " + $InformationType.ToUpper() + " - " + $Text)
    }
}

# Create a new log file (overwriting any existing one)
New-Item -Path $LogFile -ItemType "file" -force | Out-Null

# Write to log file
WriteToLog "I" "Install Citrix Workspace app" $LogFile
WriteToLog "I" "----------------------------" $LogFile
WriteToLog "-" "" $LogFile

############################
# Pre-Installation         #
############################

# Cleanup: delete existing group policy registry keys (reference: https://docs.citrix.com/en-us/citrix-workspace-app-for-windows/install.html#uninstall)
WriteToLog "I" "Cleanup: delete existing Citrix Workspace group policy registry keys" $LogFile
$x = 0
try {
    $RegKeyPath = "hklm:\SOFTWARE\Policies\Citrix\ICA Client"
    if ( Test-Path $RegKeyPath ) {
        $x++
        Remove-Item -Path $RegKeyPath -recurse
    }
    $RegKeyPath = "hklm:\SOFTWARE\Wow6432Node\Policies\Citrix\ICA Client"
    if ( Test-Path $RegKeyPath ) {
        $x++
        Remove-Item -Path $RegKeyPath -recurse
    }
    if ( $x -eq 0 ) {
        WriteToLog "I" "No existing group policy registry keys were found. Nothing to do." $LogFile
    } else {
        WriteToLog "S" "The group policy registry keys were deleted successfully" $LogFile
    }
} catch {
    WriteToLog "E" "An error occurred trying to delete the group policy registry keys (error: $($Error[0]))" $LogFile
    Exit 1
}

# Write an empty line to the log file
WriteToLog "-" "" $LogFile

# Cleanup: delete old Citrix Workspace app log folders in the TEMP directory
WriteToLog "I" "Cleanup: delete old Citrix Workspace app log folders" $LogFile
try {
    Get-ChildItem -path ( Join-Path $env:Temp "CTXReceiverInstallLogs*" ) -directory | Remove-Item -force -recurse
    WriteToLog "S" "The old log folders were deleted successfully (or they did not exist in the first place)" $LogFile
} catch {
    WriteToLog "E" "An error occurred trying to delete the old log folders (error: $($Error[0]))" $LogFile
    Exit 1
}

# Write an empty line to the log file
WriteToLog "-" "" $LogFile

############################
# Installation             #
############################

$InstallFile = Join-Path $StartDir $InstallFileName
WriteToLog "I" "Install Citrix Workspace app" $LogFile
WriteToLog "I" "Command: $InstallFile $InstallArguments" $LogFile
if ( Test-Path $InstallFile ) {
    $Process = Start-Process -FilePath $InstallFile -ArgumentList $InstallArguments -PassThru -ErrorAction Stop
    Wait-Process -InputObject $process
    switch ($Process.ExitCode) {
        0 { WriteToLog "S" "Citrix Workspace app was installed successfully (exit code: 0)" $LogFile }
        3 { WriteToLog "S" "Citrix Workspace app was installed successfully (exit code: 3)" $LogFile } # Some Citrix products exit with 3 instead of 0
        1603 {
            WriteToLog "E" "A fatal error occurred (exit code: 1603). Some applications throw this error when the software is already (correctly) installed! Please check the log files!" $LogFile
            Exit 1
            }
        1605 {
            WriteToLog "E" "Citrix Workspace app is not currently installed on this machine (exit code: 1605)" $LogFile
            Exit 1
            }
        1619 {
            WriteToLog "E" "The installation files cannot be found. The PS1 script should be in the root directory and all source files in the subdirectory 'Files' (exit code: 1619)" $LogFile
            Exit 1
            }
        3010 { WriteToLog "W" "A reboot is required (exit code: 3010)!" $LogFile }
        40008 {
            WriteToLog "I" "This version of Citrix Workspace app has already been installed. Nothing to do!" $LogFile
            # Re-enable File Security
            Remove-Item env:\SEE_MASK_NOZONECHECKS

            # Write an empty line to the log file
            WriteToLog "-" "" $LogFile
            WriteToLog "I" "End of script" $LogFile
            Exit 0
        }
        default {
            WriteToLog "E" "The installation ended in an error (exit code: $($Process.ExitCode))" $LogFile
            Exit 1
        }
    }
} else {
    WriteToLog "E" "The file '$InstallFile' could not be found" $LogFile
    Exit 1
}

# Write an empty line to the log file
WriteToLog "-" "" $LogFile

############################
# Post-Installation        #
############################

# Optional: import the Client Selective Trust registry keys and values. This prevents security popup messages regarding permissions for access to files, microphones, cameras, scanners, etc. in the local intranet and trusted sites.
# Reference: How to Configure Default Device Access Behavior of Receiver, XenDesktop and XenApp (https://support.citrix.com/article/CTX133565)
$RegFile = Join-Path $StartDir $ClientSelectiveTrustRegKeys
WriteToLog "I" "Optional: import the Client Selective Trust registry keys and values. This prevents security popup messages during logon" $LogFile
WriteToLog "I" "Import registry file '$RegFile'" $LogFile
if ( Test-Path $RegFile ) {
    try {
        $process = start-process -FilePath "reg.exe" -ArgumentList "IMPORT ""$RegFile""" -WindowStyle Hidden -Wait -PassThru
        if ( $process.ExitCode -eq 0 ) {
            WriteToLog "S" "The registry settings were imported successfully (exit code: $($process.ExitCode))" $LogFile
        } else {
            WriteToLog "E" "An error occurred trying to import registry settings (exit code: $($process.ExitCode))" $LogFile
            Exit 1
        }
    } catch {
        WriteToLog "E" "An error occurred trying to import the registry file '$RegFile' (error: $($Error[0]))!" $LogFile
        Exit 1
    }
} else {
    WriteToLog "I" "The file '$RegFile' could not be found. Nothing to do." $LogFile
}

# Write an empty line to the log file
WriteToLog "-" "" $LogFile

# Copy the Citrix Workspace app log files to the custom log path defined in the variable '$LogDir'
WriteToLog "I" "Copy the log files from the TEMP directory to '$LogDir'" $LogFile
$CitrixLogPath = (Get-ChildItem -directory -path $env:Temp -filter "CTXReceiverInstallLogs*").FullName
if ( Test-Path ( $CitrixLogPath + "\*.log" ) ) {
    $SourceFiles = Join-Path $CitrixLogPath "\*.log"
    WriteToLog "I" "Source files          = $SourceFiles" $LogFile
    WriteToLog "I" "Destination directory = $LogDir" $LogFile
    try {
        Copy-Item $SourceFiles -Destination $LogDir -Force -Recurse
        WriteToLog "S" "The log files were copied successfully" $LogFile
    } catch {
        WriteToLog "E" "An error occurred trying to copy the log files" $LogFile
        Exit 1
    }
} else {
    WriteToLog "I" "There are no log files in the directory '$CitrixLogPath'. Nothing to copy." $LogFile
}

# Re-enable File Security
Remove-Item env:\SEE_MASK_NOZONECHECKS

# Write an empty line to the log file
WriteToLog "-" "" $LogFile
WriteToLog "I" "End of script" $LogFile
<!--NeedCopy-->

Guarde el script como un **archivo*.ps1** y ejecute el script de la siguiente manera:

powershell.exe -executionpolicy bypass -file "C:\Temp\Citrix Workspace app installation.ps1"

Asegúrese de ejecutar el script de PowerShell como administrador. De forma predeterminada, el script de PowerShell espera que el instalador (CitrixWorkspaceApp.exe) y, opcionalmente, el archivo de registro que contiene las claves y valores del Registro de confianza selectiva de cliente, estén en el mismo directorio que el propio script. Cambie la ruta de instalación y el nombre del script a sus necesidades.

Los archivos de registro se escriben en C:\Logs\Citrix Workspace app, pero esta ruta se puede cambiar modificando las variables $LogDir y $LogFile. Todos los archivos de registro generados por el instalador de la aplicación Citrix Workspace se copian en el directorio de registro (definido en la variable $LogDir) una vez finalizada la instalación.

Además, el script quita cualquier configuración de directiva de grupo específica del equipo existente eliminando las dos claves del Registro siguientes:

El script también importa el archivo de registro de confianza selectiva de cliente, pero esto es opcional. Si no se encuentra ningún *archivo.reg, el script no terminará en un error.

Puede ejecutar scripts en una directiva de grupo de Active Directory o mediante el software de distribución electrónica de software (ESD), por ejemplo, Microsoft SCCM.

Adopción

Después de la instalación y configuración iniciales, una de las fases de implementación más críticas es la capacitación y la incorporación de los usuarios finales. Citrix ha preparado una lista de recursos de adopción de usuarios finales de Citrix Workspace que incluye todo lo que necesita para ayudar a los usuarios finales a empezar a usar Citrix Workspace. Puede encontrar todo, incluido un cronograma de implementación de muestra, plantillas de correo electrónico, folletos y kits de adopción en la sección de herramientas.

Desinstalación

La desinstalación de la aplicación Citrix Workspace para Windows se puede realizar con la siguiente línea de comandos: CitrixWorkspaceApp.exe /silent /uninstall

Para obtener más información, consulte la documentación del producto