Sombreado de sesión
El sombreado de sesiones permite a los administradores de dominio ver las sesiones ICA® de los usuarios en una intranet. Esta función usa noVNC para conectarse a las sesiones ICA.
Nota:
Para usar esta función, usa
Citrix Director7.16 o una versión posterior.
Instalación y configuración
Dependencias
Se requieren dos nuevas dependencias, python-websockify y x11vnc, para el sombreado de sesión. Instala python-websockify y x11vnc manualmente después de instalar el VDA de Linux.
Para RHEL 7.x y Amazon Linux2:
Ejecuta los siguientes comandos para instalar python-websockify y x11vnc (versión 0.9.13 o posterior de x11vnc):
sudo pip3 install websockify
- sudo yum install x11vnc
<!--NeedCopy-->
(Para RHEL 7.x) Resuelve python-websockify y x11vnc habilitando los repositorios Extra Packages for Enterprise Linux (EPEL) y RPM opcionales:
-
EPEL
El repositorio EPEL es necesario para
x11vnc. Ejecuta el siguiente comando para habilitar el repositorio EPEL:yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm <!--NeedCopy--> -
RPM opcionales
Ejecuta el siguiente comando para habilitar el repositorio de
RPMopcionales para instalar algunos paquetes de dependencia dex11vnc:subscription-manager repos --enable rhel-7-server-optional-rpms --enable rhel-7-server-extras-rpms <!--NeedCopy-->
Para RHEL 9.1/9.0/8.x y Rocky Linux 9.1/9.0/8.x:
Ejecuta los siguientes comandos para instalar python-websockify y x11vnc (versión 0.9.13 o posterior de x11vnc).
sudo pip3 install websockify
sudo yum install x11vnc
<!--NeedCopy-->
Resuelve x11vnc habilitando los repositorios EPEL y CodeReady Linux Builder:
dnf install -y --nogpgcheck https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
subscription-manager repos --enable "codeready-builder -for-rhel-8-x86_64-rpms"
<!--NeedCopy-->
Para Ubuntu:
Ejecuta los siguientes comandos para instalar python-websockify y x11vnc (versión 0.9.13 o posterior de x11vnc):
sudo pip3 install websockify
sudo apt-get install x11vnc
<!--NeedCopy-->
Para SUSE:
Ejecuta los siguientes comandos para instalar python-websockify y x11vnc (versión 0.9.13 o posterior de x11vnc):
sudo pip3 install websockify
sudo zypper install x11vnc
<!--NeedCopy-->
Para Debian:
- Ejecuta los siguientes comandos para instalar
python-websockifyyx11vnc(versión 0.9.13 o posterior dex11vnc):
sudo pip3 install websockify
- sudo apt-get install x11vnc
<!--NeedCopy-->
Puerto
La función de sombreado de sesión selecciona automáticamente los puertos disponibles dentro del rango 6001-6099 para establecer conexiones desde el VDA de Linux a Citrix Director. Por lo tanto, el número de sesiones ICA que puedes sombrear simultáneamente está limitado a 99. Asegúrate de que haya suficientes puertos disponibles para satisfacer tus requisitos, especialmente para el sombreado de varias sesiones.
Registro
La siguiente tabla enumera los registros relacionados:
| Registro | Descripción | Valor predeterminado |
|---|---|---|
| EnableSessionShadowing | Habilita o deshabilita la función de sombreado de sesión | 1 (Habilitado) |
| ShadowingUseSSL | Determina si se debe cifrar la conexión entre el VDA de Linux y Citrix Director | 0 (Deshabilitado) |
- Ejecuta el comando
ctxregen el VDA de Linux para cambiar los valores del registro. Por ejemplo, para deshabilitar el sombreado de sesión, ejecuta el siguiente comando:
- /opt/Citrix/VDA/bin/ctxreg update -k "HKLM\Software\Citrix\VirtualDesktopAgent" -v "EnableSessionShadowing" -d "0x00000000"
<!--NeedCopy-->
SSL
La conexión noVNC entre el VDA de Linux y Citrix Director usa el protocolo WebSocket. Para el sombreado de sesión, la elección de ws:// o wss:// depende del registro “ShadowingUseSSL” mencionado anteriormente. De forma predeterminada, se elige ws://. Sin embargo, por razones de seguridad, te recomendamos que uses wss:// e instales certificados en cada cliente de Citrix Director y en cada servidor VDA de Linux. Citrix renuncia a cualquier responsabilidad de seguridad por el sombreado de sesión del VDA de Linux al usar ws://.
Para habilitar SSL, ejecuta el siguiente comando:
/opt/Citrix/VDA/bin/ctxreg update -k "HKLM\Software\Citrix\VirtualDesktopAgent" -v "ShadowingUseSSL" -d "0x00000001"
<!--NeedCopy-->
Obtener certificados SSL de servidor y raíz
Los certificados deben estar firmados por una Autoridad de certificación (CA) de confianza.
Se requiere un certificado de servidor independiente (incluida la clave) para cada servidor VDA de Linux en el que quieras configurar SSL. Un certificado de servidor identifica un equipo específico, por lo que debes conocer el nombre de dominio completo (FQDN) de cada servidor. Para mayor comodidad, considera usar un certificado comodín para todo el dominio.
También se requiere un certificado raíz para cada cliente de Citrix Director que se comunica con el VDA de Linux. Los certificados raíz están disponibles en las mismas CA que emiten los certificados de servidor.
Puedes instalar certificados de servidor y de cliente de las siguientes CA:
- Una CA que se incluye con tu sistema operativo
- Una CA empresarial (una CA a la que tu organización te da acceso)
- Una CA que no se incluye con tu sistema operativo
Consulta al equipo de seguridad de tu organización para averiguar qué métodos requieren para obtener certificados.
Importante:
- El nombre común de un certificado de servidor debe ser el FQDN exacto del VDA de Linux o al menos el comodín correcto más los caracteres de dominio. Por ejemplo, vda1.basedomain.com o \*.basedomain.com.
- Los algoritmos de hash, incluidos SHA1 y MD5, son demasiado débiles para las firmas en certificados digitales para que algunos navegadores los admitan. Por lo tanto, SHA-256 se especifica como el estándar mínimo.
- Chrome ha dejado de aceptar certificados SSL autofirmados, considerándolos inseguros. El error
NET::ERR_CERT_COMMON_NAME_INVALIDse produce porque el certificado generado carece del campo SAN (subjectAltName). Para resolver este problema, proporciona un certificado con atributos extendidos (extensiones X509 v3) que incluyan el campo SAN.
Instalar un certificado raíz en cada cliente de Citrix Director
El shadowing de sesiones utiliza el mismo almacén de certificados basado en el registro que IIS, por lo que puedes instalar certificados raíz mediante IIS o el complemento Certificados de Microsoft Management Console (MMC). Cuando recibas un certificado de una CA, puedes reiniciar el Asistente para certificados de servidor web en IIS y el asistente instalará el certificado. Alternativamente, puedes ver e importar certificados en el equipo mediante la MMC y agregar el certificado como un complemento independiente. Internet Explorer y Google Chrome importan los certificados instalados en tu sistema operativo de forma predeterminada. Para Mozilla Firefox, debes importar tus certificados SSL raíz en la ficha Autoridades del Administrador de certificados.
Instalar un certificado de servidor y su clave en cada servidor VDA de Linux
Nombra los certificados de servidor como “shadowingcert.\*” y el archivo de clave como “shadowingkey.\*” (el asterisco indica el formato, por ejemplo, shadowingcert.pem y shadowingkey.key). Coloca los certificados de servidor y los archivos de clave en la ruta /etc/xdl/shadowingssl y protégelos correctamente con permisos restringidos. Un nombre o una ruta incorrectos impiden que el VDA de Linux encuentre un certificado o un archivo de clave específicos y, por lo tanto, provocan un error de conexión con Citrix Director.
Uso
Desde Citrix Director, busca la sesión de destino y haz clic en Shadow en la vista Detalles de la sesión para enviar una solicitud de shadowing al VDA de Linux.
Después de que la conexión se inicialice, aparece una confirmación en el cliente de sesión ICA (no en el cliente de Citrix Director) para pedir al usuario permiso para hacer shadowing de la sesión.
Si el usuario hace clic en Sí, aparece una ventana en el lado de Citrix Director, indicando que se está haciendo shadowing de la sesión ICA.
Para obtener más información sobre el uso, consulta la documentación de Citrix Director.
Limitaciones
- El shadowing de sesiones está diseñado para usarse solo en una Intranet. No funciona para redes externas, incluso si se conecta a través de Citrix Gateway. Citrix declina toda responsabilidad por el shadowing de sesiones del VDA de Linux en una red externa.
- Con el shadowing de sesiones habilitado, un administrador de dominio solo puede ver las sesiones ICA, pero no tiene permiso para escribir o controlarlas.
- Después de que un administrador haga clic en Shadow desde
Citrix Director, aparece una confirmación para pedir al usuario permiso para hacer shadowing de la sesión. Solo se puede hacer shadowing de una sesión cuando el usuario de la sesión da el permiso. - La confirmación mencionada anteriormente tiene una limitación de tiempo de espera, que es de 20 s. Una solicitud de shadowing falla cuando se agota el tiempo.
- Solo un administrador puede hacer shadowing de una sesión. Por ejemplo, si el administrador B envía una solicitud de shadowing para una sesión de la que el administrador A está haciendo shadowing, la confirmación para obtener el permiso del usuario reaparece en el dispositivo del usuario. Si el usuario acepta, la conexión de shadowing para el administrador A se detiene y se establece una nueva conexión de shadowing para el administrador B. Si un administrador envía otra solicitud de shadowing para la misma sesión, también se puede establecer una nueva conexión de shadowing.
- Para usar el shadowing de sesiones, instala
Citrix Director7.16 o posterior. - Un cliente de
Citrix Directorutiliza un FQDN en lugar de una dirección IP para conectarse al servidor VDA de Linux de destino. Por lo tanto, el cliente deCitrix Directordebe poder resolver el FQDN del servidor VDA de Linux.
Solución de problemas
Si el shadowing de sesiones falla, depura tanto en el cliente de Citrix Director como en el VDA de Linux.
En el cliente de Citrix Director
A través de las herramientas para desarrolladores del explorador, comprueba los registros de salida en la ficha Consola. O bien, comprueba la respuesta de la API ShadowLinuxSession en la ficha Red. Si aparece la confirmación para obtener el permiso del usuario, pero la conexión falla, haz ping al FQDN del VDA manualmente para verificar que Citrix Director pueda resolver el FQDN. Si hay un problema con la conexión wss://, comprueba tus certificados.
En el VDA de Linux
-
Comprueba el archivo
/var/log/xdl/vda.logen busca de pistas. -
Edita el archivo
/var/xdl/sessionshadowing.shy cambia la variable ‘logFile’ para especificar un archivo de registro que se pueda seguir para obtener pistas durante el shadowing de sesiones desde el director. -
Además, puedes verificar manualmente si tus certificados funcionan correctamente con la conexión noVNC:
-
Ejecuta ps aux | grep xorg para encontrar el número de pantalla Xorg de la sesión actual
<display-num>, por ejemplo,:3. -
Ejecuta el siguiente comando para iniciar un servidor x11vnc y esperar una conexión entrante.
runuser -l "ctxsrvr" -s /bin/bash -c "websockify <port> -v --cert /etc/xdl/shadowingssl/shadowingcert.pem --key /etc/xdl/shadowingssl/shadowingkey.key -- x11vnc -viewonly -shared -passwd <passwd> -rfbport <port> -display <display-num> -many -o /var/log/xdl/x11vnc.log" <!--NeedCopy--> -
Intenta conectarte usando noVNC para verificar el modo SSL de la siguiente manera. Introduce el FQDN de tu VDA y el número de puerto. En este ejemplo, el número de puerto es 6009.
-
Resuelve cualquier error impreso por Websockify en el VDA o informado por el explorador en el cliente.
Puntos clave durante el establecimiento de la conexión:
- Comprueba si hay alguna limitación del firewall que impida que el shadowing de sesiones abra el puerto.
- Verifica que hayas nombrado correctamente los certificados y los archivos de clave y los hayas colocado en la ruta correcta si se trata del escenario SSL.
- Verifica que queden suficientes puertos entre 6001 y 6099 para nuevas solicitudes de shadowing.
- Verifica que ‘netstat’ esté instalado porque lo requiere
/var/xdl/sessionshadowing.sh. - Ejecuta
openssl x509 -in shadowingcert.pem -text -nooutpara verificar que los certificados estén configurados correctamente, prestando especial atención a los campos CN y SAN. -
En RHEL 8, podría haber un problema en el que no se encuentre
rebind.so. Para resolver este problema, ejecuta el siguiente comando:ln -s /usr/bin/rebind.so /usr/local/bin/rebind.so <!--NeedCopy-->
-