====== Pasarela SSH ======

===== Descripción del servicio =====

Proporciona acceso a un equipo de la red interna del centro a través de SSH desde el exterior. Este servicio está pensado para poder acceder a la red del centro en casos donde no es posible hacer uso de la [[:centro:servizos:vpn:start|VPN]].
===== Alta en el servicio =====
Comprueba primero en el [[https://apps.citius.usc.es/xici/personainternas/edit|apartado Cuenta y Permisos de Xici]] si aparece ya listado el servicio //Acceso ext. pasarela SSH//. En ese caso, el servicio ya está activo para tu cuenta.

La alta debe solicitarse mediante el [[https://citius.usc.es/dashboard/enviar-incidencia|formulario de peticiones e incidencias]]. Para acceder al formulario necesitas usuario y contraseña del CiTIUS. Si tienes problemas recordando el usuario o contraseña, puedes solicitar una reactivación en [[citius.tic@usc.es]].

También debes añadir una clave pública SSH en tu cuenta, en el [[https://citius.usc.es/me|apartado «Biografía y otros datos» de Xici]], ya que **sólo se acepta autenticación mediante clave SSH**.

Para generar las claves, desde una terminal ejecuta:

<code bash>ssh-keygen -t rsa</code>

Introduce una contraseña para proteger tus claves. Esto generará los archivos ''~/.ssh/id_rsa'' (la clave privada) y ''~/.ssh/id_rsa.pub'' (la clave pública). Esta última es la que debes introducir en Xici.

===== Manual de usuario =====

==== Datos de conexión ====

  * Servidor: ''193.144.78.45''
  * Puerto: ''22''
  * Usuario: //Tu usuario del CiTIUS//


==== Conexión simple desde GNU/Linux ====

Para conectar, puedes hacer uso del comando SSH. Opcionalmente, puedes especificar la localización de la clave privada, si no se encuentra en su localización por defecto.

<code bash>
ssh -i ~/.ssh/id_rsa nombre.usuario@193.144.78.45
</code>

Una vez conectado, puedes conectarte a otros equipos del centro, por ejemplo a tu equipo de trabajo. Recuerda que puedes encenderlo (y apagarlo) haciendo uso del servicio de [[:centro:servizos:acendido_remoto_de_equipos_wake_on_lan|encendido remoto]].

==== Conexión simple desde Windows ====

Puedes utilizar el programa [[http://www.chiark.greenend.org.uk/~sgtatham/putty/|PuTTY]], haciendo uso de los mismos datos facilitados arriba. 

Para conectar, es necesario convertir previamente la clave privada del formato SSH al formato de PuTTY. Puedes hacerlo con PuTTYgen que puedes encontrar en la misma página de PuTTY. Para hacerlo:

  * Accede al menú //Conversions// » //Import key//.
  * Localiza la clave privada en formato SSH (el nombre por defecto es ''id_rsa'').
  * Introduce la clave de paso, si la tuviese.
  * Presiona en el botón //Save private key// y selecciona un lugar donde guardar el archivo ''.ppk'' generado.

Una vez tengas el archivo con extensión ''ppk'', puedes usarlo en el campo //Private key file// tanto de PuTTY como de WinSCP.

==== Conexión a un servicio haciendo un túnel SSH ====

Puedes usar la pasarela SSH para acceder a un servicio del CITIUS, mapeando los puertos necesarios de la máquina que ofrece el servicio a tu máquina local.

Por ejemplo, puedes acceder al [[:centro:servizos:acceso_o_almacenamento_mediante_smb_e_ssh|almacenamiento a través de SSH]] si mapeas así el servicio:

<code bash>
ssh -i ~/.ssh/id_rsa nombre.usuario@193.144.78.45 -L 8000:172.16.242.41:22
</code>

Una vez conectado, puedes acceder a los archivos a través de SSH en la dirección ''127.0.0.1:8000''. De este mismo modo puedes acceder a otros servicios.

También se puede hacer desde Windows, a través del programa [[http://winscp.net/eng/download.php|WinSCP]]. Para hacerlo, debes pulsar en //Advanced options// y cubrir los datos de conexión en el panel //Tunnel//.