---
title: Configuración del comando SSH
description: "##### 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…"
url: "https://www.stela.ai/wiki/configuracion-del-comando-ssh/"
updated: "2026-09-04"
category: Configuración de Proyectos
---

# 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](https://www.stela.ai/wp-content/uploads/2025/07/image-9.webp)

![](https://www.stela.ai/wp-content/uploads/2025/07/image-14.png)

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

![](https://www.stela.ai/wp-content/uploads/2025/07/image-10.webp)

**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.

![](https://www.stela.ai/wp-content/uploads/2025/07/image-11.webp)

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.