================
PuTTY on Windows
================

`PuTTY <http://www.chiark.greenend.org.uk/~sgtatham/putty/>`_ is a terminal emulator, serial console and network file transfer application. It supports several network protocols, including SCP, SSH, Telnet, rlogin, and raw socket connection. It can also connect to a serial port.

1. Installation
===============

1.1 Download
------------

The PuTTY installer (look for *"Windows installer for everything except PuTTYtel"*) can be downloaded from its homepage at `chiark.greenend.org.uk <http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html>`_.

1.2 Installer
-------------

After downloading the installer, run it and follow the screenshots below.

.. image:: putty-0001.png

|

.. image:: putty-0002.png

|

.. image:: putty-0003.png

|

.. image:: putty-0004.png

|

.. image:: putty-0005.png

|

.. image:: putty-0006.png

2. Configuration
================

2.1 Create a SSH Key
--------------------

.. image:: puttygen-0001.png

|

.. image:: puttygen-0002.png

|

.. image:: puttygen-0003.png

|

.. image:: puttygen-0004.png

|

.. image:: puttygen-0005.png

|

.. image:: puttygen-0006.png

|

.. image:: puttygen-0007.png

2.2 Set default User Name
-------------------------

.. image:: putty-0007.png

2.3 Use default Key Authentication
----------------------------------

.. image:: putty-0008.png

|

.. image:: putty-0009.png

|

.. image:: putty-0010.png

2.4 Enable X11 Forwarding
-------------------------

.. image:: putty-0011.png

2.5 Use SSH Gateways
--------------------

.. raw:: html

  <ol>
    <li>Create a new SSH key (RSA, 4096bit) with puttygen.exe, save it as PuTTY key (key.ppk) and send the OpenSSH public key to ITS Linux System Administration via the <a href="https://servicedesk.bfh.ch">servicedesk</a>.</li>
    <li>Start PuTTY and create a session named ssh-gateway.example.org with the following configuration:<br />
        <ul>
          <li>Session / Host Name: <b>ssh-gateway.example.org</b></li>
          <li>Connection / Data / Auto-login username: <b>john</b></li>
          <li>Connection / SSH / Auth / Private key file for authentication:<br />
              Select your previously created private key (<b>key.ppk</b>).</li>
        </ul></li>
    <li>Create a second session named intern.example.org with the following configuration:<br />
        <ul>
          <li>Session / Host Name: <b>intern.example.org</b></li>
          <li>Connection / Data / Auto-login username: <b>john</b></li>
          <li>Connection / Proxy / Proxy type: <b>Local</b></li>
          <li>Connection / Proxy / Proxy hostname: <b>ssh-gateway.example.org</b></li>
          <li>Connection / Proxy / Port: <b>22</b></li>
          <li>Connection / Proxy / Username: <b>john</b></li>
          <li>Connection / Proxy / Telnet command, or local proxy command:<br />
              <b>plink -agent -l %user %proxyhost -nc %host:%port</b></li>
          <li>Connection / SSH / Auth / Private key file for authentication:<br />
              Select your previously created private key (<b>key.ppk</b>).</li>
        </ul></li>
  </ol>