Si necesitás que una herramienta de desarrollo, un cliente SFTP, un IDE o una aplicación de programación con IA se conecte a tu hosting por SSH, lo más seguro es hacerlo mediante una clave SSH.
Al generar una clave SSH se crea un par: una clave pública, que queda autorizada en el servidor, y una clave privada, que vas a utilizar desde tu computadora o desde la aplicación que necesite conectarse.
Importante: la clave privada permite acceder a tu cuenta. No la compartas ni la pegues en chats, prompts o lugares donde pueda quedar almacenada. También vas a tener que guardar la frase de contraseña que utilices para protegerla.
Antes de empezar
Ingresá al cPanel de la cuenta a la que quieras acceder por SSH. También vas a necesitar tu usuario de cPanel.
Como servidor de conexión te recomendamos utilizar el subdominio ftp.tudominio.com.ar, reemplazando tudominio.com.ar por tu propio dominio. De esta forma, si en el futuro tu cuenta cambia de servidor, normalmente no vas a tener que modificar la configuración de tu aplicación.
En nuestros servidores, la conexión SSH se realiza por el puerto 6790.
Si administrás los DNS de tu dominio mediante Cloudflare, el subdominio ftp normalmente se encuentra configurado sin proxy, lo que lo hace especialmente útil para este tipo de conexiones. De todos modos, verificá que el registro ftp figure como DNS only / Solo DNS, ya que las conexiones SSH y SFTP no deben pasar por el proxy web de Cloudflare.
1. Ingresar al administrador de claves SSH
Dentro de cPanel, buscá Acceso a SSH.
En la pantalla siguiente vas a encontrar la sección Administrar claves SSH. Hacé clic en el botón Administrar claves SSH para continuar.
2. Generar una nueva clave
Dentro de Administrar claves SSH, hacé clic en Generar una nueva clave.
Completá el formulario de la siguiente manera:
- Key Name / Nombre de la clave: elegí un nombre que te permita identificarla fácilmente. Por ejemplo, podés utilizar el nombre de la aplicación, equipo o computadora donde la vas a usar.
- Contraseña clave: ingresá una frase de contraseña segura y repetila en el campo siguiente. Guardala en un lugar seguro, porque la vas a necesitar para desbloquear la clave privada.
- Tipo de clave: seleccioná RSA.
- Tamaño de la clave: seleccioná 4096 bits.
Finalmente, hacé clic en Generar clave.
La frase de contraseña de la clave SSH no es la contraseña de cPanel. Son credenciales diferentes.
3. Autorizar la clave pública
Este paso es indispensable. Generar la clave no significa que ya esté habilitada para conectarse al servidor.
Volvé a Administrar claves SSH y buscá la sección Claves públicas. La clave que acabás de crear inicialmente va a aparecer con el estado not authorized.
En la columna Acciones, hacé clic en Administrar junto a esa clave y luego elegí Authorize / Autorizar.
Cuando vuelvas a la lista de claves públicas, verificá que el Estado de autorización haya cambiado a authorized.
Si continúa figurando como “not authorized”, la conexión SSH no va a funcionar.
4. Obtener la clave privada
En la misma pantalla de Administrar claves SSH, bajá hasta la sección Claves privadas.
Buscá la clave que acabás de generar y hacé clic en Ver/Descargar.
La clave privada es la que vas a configurar en la aplicación, cliente SSH o herramienta de desarrollo desde la que quieras conectarte.
Muchas aplicaciones modernas utilizan directamente claves SSH compatibles con OpenSSH. Si la aplicación que vas a utilizar te pide específicamente un archivo con extensión .PPK, cPanel también permite convertir la clave.
Para hacerlo, dentro de Ver/Descargar buscá la opción de conversión, ingresá la frase de contraseña que elegiste al generar la clave y hacé clic en Convertir. Después vas a poder descargarla en el formato requerido.
5. Configurar la conexión
Cuando tu aplicación te solicite los datos de acceso SSH, utilizá:
- Servidor / Host:
ftp.tudominio.com.ar, reemplazándolo por tu propio dominio. - Puerto: 6790.
- Usuario / Login: tu usuario de cPanel.
- Autenticación: clave privada SSH.
- Clave privada: la clave que obtuviste desde cPanel.
- Passphrase: la frase de contraseña que definiste al generar la clave.
Si la aplicación permite seleccionar un archivo de clave privada, es preferible utilizar esa opción antes que copiar y pegar su contenido.
Recomendación de seguridad
Lo ideal es utilizar una clave distinta para cada cuenta cPanel y, cuando resulte práctico, también una clave diferente para cada computadora o aplicación.
De esa manera, si dejás de utilizar una herramienta, cambiás de equipo o sospechás que una clave pudo quedar expuesta, podés desautorizar solamente esa clave sin afectar los demás accesos.
Preguntas frecuentes
¿La clave pública y la clave privada son lo mismo?
No. La clave pública queda autorizada en el servidor. La clave privada queda en tu computadora o aplicación y no debe compartirse.
Generé la clave pero no puedo conectarme. ¿Qué reviso?
Primero verificá que en Claves públicas figure como authorized. Después comprobá que estés utilizando el puerto 6790, tu usuario correcto de cPanel y que ftp.tudominio.com.ar resuelva correctamente. Si utilizás Cloudflare, verificá además que el registro ftp esté configurado como DNS only / Solo DNS.
¿Qué pasa si pierdo la clave privada o su passphrase?
La solución es generar una clave nueva y autorizarla. Si la anterior ya no debería tener acceso, también podés desautorizarla o eliminarla desde Administrar claves SSH.
¿Puedo usar esta misma configuración para SFTP?
Sí. SFTP funciona sobre SSH, por lo que los clientes compatibles pueden utilizar el mismo servidor, puerto, usuario y clave privada.
¿Esta misma clave es la que necesito para un repositorio privado de GitHub?
No recomendamos reutilizarla. Si vas a utilizar Git Version Control de cPanel con un repositorio privado, conviene crear una clave SSH específica para ese repositorio y registrarla en GitHub como Deploy key. El procedimiento es diferente porque, en ese caso, es el servidor el que se autentica frente a GitHub. Consultá nuestra guía ¿Cómo conectar un repositorio privado de GitHub con Git Version Control de cPanel?.
¿Puedo usar esta clave con una herramienta de programación con IA?
Sí, siempre que esa herramienta permita conectarse por SSH. Configurá solamente los datos que necesite y evitá pegar el contenido de la clave privada dentro de un chat o prompt.
