VNC#

Uso de VNC#

VNC (Virtual Network Computing) es una tecnología de escritorio remoto. Permite ver la pantalla del equipo del robot y controlarlo con el ratón y el teclado a través del navegador.

Cómo funciona#

Navegador del usuario
    │ WebSocket (puerto 6080-6100)
    ▼
orchestrator-vnc-proxy (websockify)
    │ TCP (puerto VNC, normalmente 5900)
    ▼
Servidor VNC en el equipo del robot

El usuario hace clic en el botón → el Orchestrator crea una conexión proxy a través de websockify → el navegador se conecta a la pantalla del robot.

Preparación#

1. Cada robot debe tener un servidor VNC#

Instale un servidor VNC en el equipo del robot.

  • La configuración de la contraseña y el puerto se realiza en los ajustes del Asistente, en la pestaña "Ejecución/Servidor VNC"

Campos que completar en el Asistente:

  • Puerto VNC del Robot
  • Contraseña VNC
  • Casilla "Iniciar servidor VNC al iniciar el robot"
  • Casilla "Iniciar automáticamente el servidor VNC al iniciar el robot Unattended"

Asegúrese de que el servidor VNC esté en ejecución, su puerto real esté abierto en el firewall del equipo del robot y la contraseña VNC esté establecida.

2. Complete los datos VNC en la ficha del robot#

En el Orchestrator, abra la ficha del robot (edición) y complete los campos:

Campo Descripción Ejemplo
Machine IP Dirección del equipo del robot y puerto VNC. Indique el puerto explícitamente para acceder al servidor correcto 192.168.1.100:5900
Machine Login Inicio de sesión para VNC (si el servidor VNC lo requiere) admin
Machine Password Contraseña del servidor VNC en el robot (¡no confundir con la contraseña del Orchestrator ni con la contraseña de la cuenta de Windows!) vnc_pass_123
Huella SHA-256 de la clave del servidor VNC RA2 Huella de confianza de la clave pública del servidor: 32 pares de dígitos hexadecimales separados por dos puntos AA:BB:... (32 pares)

Dónde obtener la contraseña: La contraseña se establece al instalar el servidor VNC en el equipo del robot. Es una contraseña VNC independiente, NO la contraseña del usuario de Windows ni la contraseña de la cuenta en el Orchestrator.

La contraseña VNC debe tener como máximo 128 caracteres y 255 bytes en UTF-8, sin espacios ni otros caracteres de espacio en blanco.

Dónde obtener la huella: Cópiela de la configuración VNC de Sherpa RPA ejecutada con la misma cuenta de Windows que ProcessAgent. Confírmela con el administrador del robot por un canal de confianza antes de guardar la ficha. Actualice la huella guardada si cambia la clave del servidor VNC.

3. Permisos de acceso de usuarios#

El rol del usuario debe tener el permiso VNC (access_vnc) con derechos de Lectura y Actualización:

  1. Vaya a la sección Roles
  2. Seleccione el rol requerido
  3. Encuentre el campo access_vnc y marque las casillas de Lectura y Actualización
  4. Guarde

(Si no tiene derechos para editar roles, contacte al administrador)

Uso de VNC#

Método 1: Conectarse al robot desde la tabla#

  1. Vaya a la sección Robots
  2. En la fila del robot requerido, haga clic en el icono del monitor (columna más a la derecha)
  3. Se abrirá una nueva pestaña con la pantalla del robot

Si la ficha del robot contiene la dirección, la contraseña y la huella de confianza de la clave del servidor, la conexión comienza automáticamente. Si falta la huella, se abre el formulario, pero no es posible conectarse sin ella. El navegador verifica la clave del servidor antes de enviar las credenciales.

Método 2: Conectarse manualmente mediante VNC Viewer#

  1. Abra en el navegador: https://SU_ORCHESTRATOR/main/vnc-viewer

  2. Complete el formulario:

    Campo Qué ingresar
    VNC Server (host:port) Dirección IP del robot y puerto VNC (por ejemplo, 192.168.1.100:5900)
    Contraseña Contraseña VNC
    Huella SHA-256 de la clave del servidor Huella de confianza de la configuración VNC del robot: 32 pares hexadecimales separados por dos puntos
    Inicio de sesión (opcional) Inicio de sesión, si el servidor VNC lo requiere

Si falta la huella, su formato es incorrecto o no coincide con la clave del servidor, la conexión se interrumpe. No omita esta verificación: confirme la huella correcta con el administrador del robot.

Desconexión#

  • Haga clic en el botón rojo "Desconectar" en la esquina superior izquierda
  • O simplemente cierre la pestaña del navegador

El servicio proxy se detendrá automáticamente y liberará el puerto.

Variables de entorno VNC (.env)#

Variable Por defecto Descripción
VNC_HOST orchestrator-vnc-proxy Dirección del servicio proxy VNC
VNC_PORT 5000 Puerto API del proxy VNC
VNC_LOG_LEVEL INFO Nivel de registro
VNC_START_PORT 6080 Puerto inicial para conexiones proxy
VNC_MAX_PORTS 100 Máximo de conexiones simultáneas

Lista de puertos#

Puerto Propósito
5000 API del proxy VNC (interno, contenedor a contenedor)
6080-6100 Proxy WebSocket para sesiones VNC (navegador → websockify)
5900 Puerto estándar del servidor VNC en el robot

Posibles problemas#

Problema Causa Solución
El icono del monitor está en gris Sin permiso access_vnc Conceda permisos en la sección Roles
"API del proxy VNC no encontrado" orchestrator-vnc-proxy no iniciado Verifique el estado del contenedor vnc docker-compose ps
"Error de seguridad VNC: contraseña incorrecta" Contraseña VNC incorrecta Verifique el campo Machine Password en la ficha del robot
"No se ha indicado una huella de confianza del servidor VNC" Falta la huella Añada la huella de confianza a la ficha del robot o al formulario de conexión
"La clave del servidor VNC no coincide con la huella de confianza" Cambió la clave o se seleccionó otro servidor Compruebe la dirección del robot y confirme la nueva huella por un canal de confianza antes de conectarse
"El servidor VNC no responde" El robot está apagado o VNC no está en ejecución Verifique el robot y el servidor VNC en él
Pantalla negra tras la conexión La pantalla del robot está bloqueada Verifique si la sesión gráfica está activa