Cómo conectarte por SSH a tu hosting con clave pública

SSH (Secure Shell) es un método para acceder y gestionar de forma remota los archivos de tu web, hacer cambios de configuración y ejecutar comandos dentro de tu espacio de hosting. La conexión va cifrada y se valida con 2FA o con un par de claves pública/privada, lo que la hace fiable y segura.

A continuación están las instrucciones para conectarte por SSH desde Windows, Mac y Linux usando claves pública/privada. Si prefieres conectarte con 2FA, consulta cómo conectarte por SSH usando 2FA.

Nota: te recomendamos conectarte por SSH solo si estás familiarizado con la línea de comandos.

Nota: tu clave pública puede tardar hasta 30 minutos en quedar configurada en el sistema.

Nota: si la conexión SSH se cierra de inmediato, es posible que tu cuenta esté bloqueada por uso no autorizado de sudo. Abre un ticket de soporte desde el Área de clientes para que te ayudemos.

Windows

En Windows necesitas un cliente SSH. Esta guía usa PuTTY, un cliente SSH gratuito que puedes descargar aquí: https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html

1. Cuando hayas instalado PuTTY, busca y abre PuTTY Key Generator (PuTTYgen).
2. Haz clic en Generate y mueve el ratón dentro del recuadro gris para generar aleatoriedad (Randomness). Así se genera la clave pública.
3. Escribe una frase de contraseña (passphrase). Será la que tendrás que introducir en la línea de comandos.
4. Entra a tu panel de control (Stack HC), abre el plan de hosting para el que quieres acceso SSH y, en la sección Security, selecciona SSH Access.
5. Pega en el cuadro Public Key la clave pública generada por PuTTYgen. El identificador (handle) se genera automáticamente. Después haz clic en Add Public Key.
6. Vuelve a PuTTYgen y haz clic en Save private key. Guárdala con el nombre que quieras.
7. Abre PuTTY. En el menú de la izquierda, despliega SSH, luego Auth y después Credentials.
8. En Private key file for authentication, haz clic en Browse y selecciona la clave privada que acabas de guardar.
9. Vuelve a Session en el menú de la izquierda e introduce el nombre del host SSH. El host y el puerto aparecen en la parte superior de la página SSH Access. Si no se indica ningún puerto, usa el puerto 22.
10. Se abrirá la línea de comandos. Escribe tu dominio como nombre de usuario (por ejemplo, tudominio.com).
11. Se te pedirá la frase de contraseña que definiste antes. Escríbela; PuTTY no muestra los caracteres por seguridad, así que es normal que no veas nada mientras escribes.
12. Ya estarás dentro de tu cuenta, con acceso completo a tu área SSH.

Linux

Para conectarte por SSH desde Linux debes crear un par de claves pública/privada en tu equipo, añadir la clave pública en el área SSH de tu plan y luego conectarte con los datos que te indica el panel.

1. Abre una sesión de Terminal y ve al directorio donde quieres guardar el par de claves.
2. Ejecuta el comando ssh-keygen y sigue las instrucciones en pantalla: te pedirá un nombre para el archivo y una contraseña (passphrase). Anótala, porque la necesitarás para conectarte.
3. Cuando se hayan creado los archivos, entra a tu panel de control (Stack HC), abre el plan para el que quieres acceso SSH y, en la sección Security, selecciona SSH Access.
4. De vuelta en la terminal, usa el comando cat para ver el contenido de tu clave pública. Es el archivo que termina en .pub y que tiene el nombre que elegiste. Por ejemplo, si llamaste a la clave example, el comando sería: cat example.pub
5. Copia el contenido del archivo y pégalo en el cuadro Public Key del área SSH Access del panel. El identificador (handle) se genera automáticamente. Después haz clic en Add Public Key.
6. Ahora ya puedes conectarte por SSH con este comando:

   ssh -i nombre_clave usuario@host

   donde nombre_clave es el nombre del archivo de clave privada que creaste, y usuario@host son el usuario y el host que aparecen en la parte superior de la página SSH Access (por ejemplo, tudominio.com@ssh.us.stackcp.com). Si no se indica ningún puerto, usa el puerto 22.
7. Se te preguntará si quieres conectarte con la clave. Escribe yes.
8. Se te pedirá la frase de contraseña que definiste antes. Escríbela; el terminal no muestra los caracteres por seguridad, así que es normal que no veas nada mientras escribes.
9. Ya estarás dentro de tu cuenta, con acceso completo a tu área SSH.

macOS

1. Entra a tu panel de control (Stack HC) y abre el plan de hosting al que quieres conectarte.
2. Selecciona el icono SSH Access.
3. Ahora debes generar una clave pública. En Mac se hace con la utilidad Terminal; ábrela.
4. Escribe este comando y pulsa Enter:

   ssh-keygen

5. Se te preguntará dónde guardar las claves pública y privada. En este caso dejamos la ubicación por defecto; pulsa Enter.
6. Se te pedirá una frase de contraseña (passphrase). En esta guía la dejamos vacía; si escribes una, recuérdala porque te la pedirán después. Pulsa Enter.
7. Se te pedirá confirmar la frase de contraseña; si la dejaste vacía, pulsa Enter de nuevo.
8. Se generarán las claves y la clave pública quedará guardada en la ubicación indicada. En este ejemplo se guardó en: /Users/tuusuario/.ssh/id_rsa.pub
9. Copia la ruta y ejecuta este comando:

   cat /Users/tuusuario/.ssh/id_rsa.pub

10. Se mostrará la clave; cópiala completa, desde el principio hasta el final.
11. Pega la clave en el campo Public Key de la sección SSH Access del panel de control. El identificador (handle) se añade automáticamente. Haz clic en Add Public Key. Ten en cuenta que puede tardar hasta 5 minutos.
12. Vuelve a Terminal y usa el usuario SSH y el host que aparecen en la parte superior de la sección SSH Access. Tendrá una forma parecida a tudominio.com@ssh.us.stackcp.com. Escríbelo después del comando ssh:

    ssh tudominio.com@ssh.us.stackcp.com

Se te pedirá confirmar que quieres conectarte; escribe yes y pulsa Enter.

Si todo ha ido bien, ya estás conectado por SSH desde tu Mac a tu plan de hosting en HostCarriel.