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:
- Vaya a la sección Roles
- Seleccione el rol requerido
- Encuentre el campo access_vnc y marque las casillas de Lectura y Actualización
- Guarde
(Si no tiene derechos para editar roles, contacte al administrador)
Uso de VNC#
Método 1: Conectarse al robot desde la tabla#
- Vaya a la sección Robots
- En la fila del robot requerido, haga clic en el icono del monitor (columna más a la derecha)
- 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#
Abra en el navegador:
https://SU_ORCHESTRATOR/main/vnc-viewerComplete 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 |