Differences

This shows you the differences between two versions of the page.

--- other:putty_conf [2020/07/28 11:44] – jypeter
+++ other:putty_conf [2020/08/26 14:56] – [Using ssh keys] Added a link jypeter
@@ Line 1: / Line 1: @@
-====== Configuring and using Putty ======
+====== Configuring and using PuTTY/Pageant ======
-Putty is a free and easy to use [[other:ssh|ssh client]] for **Windows** (7 and 10). You can use it to connect to your favorite remote Linux servers in text mode, and start graphical applications if you also have a running [[other:win10wsl#installing_an_x_server|X server]]
+PuTTY is a free and easy to use [[other:ssh|ssh client]] for **Windows** (7 and 10). You can use it to connect to your favorite remote Linux servers in text mode, and start remote graphical applications if you also have a running [[other:win10wsl#installing_an_x_server|X server]]
 ===== Installation =====
-Download and install the [[https://www.chiark.greenend.org.uk/~sgtatham/putty/|latest version of Putty]]
+Download and install the [[https://www.chiark.greenend.org.uk/~sgtatham/putty/|latest version of PuTTY]]
-===== Launching Putty or Pageant =====
+===== Launching PuTTY/Pageant =====
+You could directly launch PuTTY, but it is actually more efficient to launch ''Pageant'', especially if you are regularly going to connect to the same server(s)
-FIXME
+''Start'' => ''PuTTY'' => ''Pageant''
+  * It will seem that nothing happens, but you should get the //Pageant// icon at the bottom right of your screen.\\ {{ :other:putty_01_notes_v2.png?direct |}}\\ Pageant will allow you to create or use existing connection profiles (//Sessions//), and also easily use //ssh keys// (more on //ssh keys// later)
-  * The best way to use PuTTY, is to use it with Pageant:
+  * If you right click on the //Pageant// icon, you can manage sessions with the ''New Session'' option, use ''Saved Sessions'' profiles and manage  //ssh keys// (''View Keys'', ''Add Key'').\\ You can also view/add keys by double clicking on the pageant icon\\ {{ :other:putty_02.png?direct |}}
-    * Start Menu => Putty menu => Pageant (this will just put the Pageant icon in the rightmost part of the taskbar, the icon may even me masked)
-    * Right-click on the Pageant icon and choose:
-      * **New session** to define a new server you want to connect to
-        * Recommended settings: FIXME
-      * **Saved Sessions** to connect to a server
-      * **Add key** to select a private ssh key and type/store the matching pass phrase (if you have a private ssh key you generated on Linux, you need to convert it with Putty Menu => PuTTYgen)
-FIXME
+===== Configuring PuTTY =====
-===== Adding and configuring a new session =====
+Launch the session/configuration manager: (Right click on) ''Pageant'' => ''New Session''\\ {{ :other:putty_03.png?direct&300 |}}
-===== Making ssh tunnels with Putty =====
+  * You can keep most PuTTY's default settings. This section will show you how to create your first //session profile//, with some useful options. If you want to add another session later, just ''Load'' an existing (and properly configured) session, ''Save'' it under a new name, and the change the session details
+  * When changing a setting, select a (sub-)**Category in the left part** of the PuTTY Configuration windows, and change the displayed **settings in the right part** of the window.
+  * After changing the settings of an existing Session, **do not forget to go back to the //Session// category and click ''Save''!**
+==== Creating a new session ====
+In the ''Session'' category:
+  * Specify a **Host Name**: e.g. ''ssh1.lsce.ipsl.fr'' for the LSCE access server
+  * Specify a matching session name in **Saved Sessions**: e.g. ''ssh1''
+  * Click on **Save** to save the session\\ {{ :other:putty_04.png?direct |}}
+If you are in a hurry, you can connect to the Linux server by clicking on **Open**, but you should first change some useful settings
+==== Changing some useful settings ====
+  * In the ''Windows'' => ''Selection'' category:
+    * Select **xterm** for the mouse buttons behavior. This will allow you to use the mouse buttons in the Putty terminal the same way you would use them in an standard Linux //xterm// terminal: **Copy** text with the left button, and **Paste** it with the middle button\\ {{ :other:putty_05.png?direct |}}
+  * In the ''Connection'' => ''Data'' category:
+    * Specify your login name in **Auto-login username**. This way you won't have to type it when you connect to the Linux server\\ {{ :other:putty_06.png?direct |}}
+  * In the ''Connection'' => ''SSH'' => ''Auth'' category:
+    * Select **Allow agent forwarding**. This is the same as [[/other:ssh#standard_usage|using ssh with the -A option]]\\ {{ :other:putty_07.png?direct |}}
+  * In the ''Connection'' => ''SSH'' => ''X11'' category:
+    * Select **Enable X11 forwarding**. This is the same as [[/other:ssh#standard_usage|using ssh with the -X option]]\\ {{ :other:putty_08.png?direct |}}
+  * When you have finished updating settings, **do not forget to go back to ''Category'' => ''Session'' and Save the session**!\\ {{ :other:putty_09.png?direct |}}
+==== Adding more sessions ====
+=== Direct connection to a remote server ===
+  * Select an existing session (e.g. the [[#creating_a_new_session|ssh1 profile]] defined above) and click on **Load**
+  * Update the values of the **Host Name** and **Saved Session** (the name of the new profile you want) text fields, and settings\\ e.g. for connecting to LSCE **from INSIDE LSCE** use:
+    * ''Host Name'' => ''obelix''
+    * ''Saved Session'' => ''obelix (direct connection)''
+  * Go back to ''Category'' => ''Session'' and **Save** the session
+=== Connection through a gateway ===
+  * Select an existing //gateway// session and click on **Load**.\\ For connecting to LSCE **from OUTSIDE LSCE**, select the [[#creating_a_new_session|ssh1 profile]]\\ If you are at LSCE, but use the //eduroam// or the //guest// **WiFi network**, you are considered as being //outside LSCE//!
+  * In the ''Connection'' => ''SSH'' category, specify the command used to connect to the target server in the **Remote command** field\\ e.g. **for LSCE**, use
+    * ''ssh obelix''
+    * or ''ssh -X -A obelix'' (check the [[other:ssh#standard_usage|useful ssh options]] for more details)\\ {{ :other:putty_10.png?direct |}}
+  * Go back to ''Category'' => ''Session'', specify a new profile name in **Saved Sessions** (e.g. ''obelix via ssh1'') and **Save** the session\\ {{ :other:putty_11.png?direct |}}
+===== Daily usage of PuTTY/Pageant =====
+Note: PuTTY will ask your password each time you open a session, unless you have [[#using_ssh_keys|ssh keys, and you use Pageant to store your passphrase]]
+==== Starting a session from Pageant ====
+Once you have [[#launching_putty_pageant|started pageant]], and [[#using_putty_pageant|configured sessions]], you can easily open terminals on the remote servers by right-clicking on the pageant icon, and selecting a **Saved Session**. \\ {{ :other:putty_12.png?direct |}}
+==== Starting a session from a desktop shortcut ====
+It is also possible to create a shortcut on the desktop to start a specific session!
+  * Right-click on the desktop and select ''New'' => ''Shortcut''
+  * Specify the location of ''putty.exe'': ''C:\Program Files\PuTTY\putty.exe''
+  * Specify the name of the shortcut, and save the shortcut\\ e.g. ''obelix via ssh1''
+  * Right-click on the shortcut and select **Properties**, then add the name of the desired profile to the existing target\\ e.g. ''"C:\Program Files\PuTTY\putty.exe" -load "obelix via ssh1"''
+  * Click **OK** to save the changes
+  * You can now connect to the remote server just by clicking on the shortcut!
 ===== Using ssh keys =====
+Read the [[other:ssh#using_ssh_keys|Using ssh keys]] section if you don't know what //ssh keys// are
+==== Existing ssh keys ====
+==== Importing or creating ssh keys with PuTTYgen ====