View Categories

Configuración del comando SSH

Descripción General #

La sección SSH dentro de la Configuración del Proyecto en STELA permite centralizar los parámetros de red, autenticación y seguridad necesarios para establecer conexiones remotas mediante el protocolo SSH.

Al definir estos valores a nivel de perfil o configuración del proyecto, se garantiza la reutilización de credenciales y se evita hardcodear direcciones IP, usuarios o claves dentro de los flujos de automatización. Todos los comandos {ssh} ejecutados dentro del proyecto utilizarán de forma automática los datos definidos en esta sección.

Esta configuración debe ser gestionada por líderes de automatización, analistas RPA o administradores con acceso a los parámetros del proyecto.

Guía de Configuración Paso a Paso #

Para configurar la conexión SSH, sigue estos pasos:

1. Selecciona la Carpeta del Proyecto: Dirígete a la carpeta que contiene tu proyecto.

2. Accede a Configuración: Accede a la configuración del proyecto, y una vez dentro del modal de gestión selecciona el perfil de configuración que deseas editar.

Bloque SSH STELA

3. Selecciona SSH: En el menú lateral izquierdo de categorías, selecciona la opción SSH.

4. Ingresa la Información de Conexión: Completa los campos con los datos de tu servidor SSH.

  • Host SSH: Ingresa la dirección del servidor. Por ejemplo, test.rebex.net.
  • Puerto SSH: Introduce el puerto de conexión. Por ejemplo, 22.
  • Usuario SSH: Escribe el nombre de usuario para la conexión. Por ejemplo, demo.
  • Contraseña SSH: Introduce la contraseña correspondiente. Por ejemplo, password.
  • Clave privada SSH: (Opcional) Si tu servidor requiere una clave privada para la autenticación, ingrésala en este campo.

Para este manual, se utiliza un servidor público de pruebas con los siguientes datos:

  • Host: test.rebex.net
  • Puerto: 22
  • Usuario: demo
  • Contraseña: password
Parámetros y Opciones Detalladas #

Dentro de la categoría SSH del perfil de configuración se encuentran los siguientes campos configurables:

  • Host SSH: Ingresa la dirección IP o el nombre de dominio (FQDN) del servidor remoto al que se conectará el robot (ejemplo: 192.168.1.50 o test.rebex.net).
  • Puerto SSH: Especifica el puerto de escucha del servicio SSH en el servidor de destino. Si este campo se deja vacío, STELA utilizará por defecto el puerto estándar 22.
  • Usuario SSH: Escribe el nombre de usuario de la cuenta con permisos de acceso y ejecución en la máquina remota (ejemplo: admin, demo, root).
  • Contraseña SSH: Introduce la clave secreta de autenticación asociada al usuario indicado.
  • Clave privada SSH: (Opcional) Si el servidor requiere autenticación mediante par de claves en lugar de (o en adición a) contraseña, pega aquí el contenido completo de la clave privada (formatos habituales .pem o .id_rsa).
Problemas Comunes y Soluciones #
  • Fallo de conexión por bloqueo de puerto o Firewall:
    • Causa: El puerto especificado (por defecto 22) está bloqueado por reglas de red, firewall corporativo o el servidor remoto utiliza un puerto alternativo.
    • Solución: Confirma con el equipo de infraestructura el puerto SSH activo en el servidor de destino e ingrésalo explícitamente en el campo Puerto SSH. Verifique también que la máquina donde corre el agente de STELA tenga alcance de red hacia la IP/dominio.
  • Error de autenticación por formato de clave privada:
    • Causa: El contenido copiado en el campo Clave privada SSH está incompleto o le faltan los encabezados/pie de página requeridos (-----BEGIN RSA PRIVATE KEY----- / -----END RSA PRIVATE KEY-----).
    • Solución: Copia y pega el texto completo del archivo de clave privada asegurándote de no dejar espacios en blanco adicionales al inicio o al final.
  • El robot se conecta a un servidor incorrecto al cambiar de entorno:
    • Causa: El proyecto maneja múltiples entornos (QA, Producción) pero no se invocó el comando Configuración en el flujo para cambiar al perfil SSH adecuado.
    • Solución: Utiliza el comando {configuracion} al inicio del flujo o antes de ejecutar el comando {ssh} para asegurar que el robot active el perfil con los parámetros SSH correctos.
Consideraciones Importantes #
  • Ejecución Local: La ejecución de comandos que utilicen conexiones SSH no es compatible con entornos de ejecución remota. Se requiere que el robot corra en un agente o entorno local habilitado.
  • Seguridad de Credenciales: Evita compartir capturas de pantalla de la configuración SSH cuando contengan contraseñas o claves privadas expuestas.
  • Múltiples Perfiles: Si necesitas probar la misma automatización contra servidores de Desarrollo, QA y Producción, crea un perfil de configuración por cada entorno y define los datos SSH correspondientes en cada uno.