Changes between Version 1 and Version 2 of PublicKeyAuthentication

Timestamp:

30/07/12 20:08:08 (8 years ago)

Author:

alamaison

Comment:

Added step-by-step guide to using keys with Pageant

PublicKeyAuthentication

@@ -1 @@
-Swish will use any keys you add to Putty's key agent, Pageant, to authenticate you with servers you connect to.
-
 = Public key authentication =
 
@@ -6 +4 @@
 
 How is the server still able to know it is really you?  In short, using very clever maths.  You can [http://en.wikipedia.org/wiki/Public-key_cryptography read more about it] if you're interested.
+
+= Using keys =
+Swish will use any keys you add to Putty's key agent, Pageant, to authenticate you with servers you connect to.  If Pageant is not already running, you can launch it from the Swish SFTP Connections folder using ''Launch key agent'' from the toolbar or menu.  Swish includes a copy of Pageant so don't worry if you didn't install it.
+
+[[Image(swish-launch-agent.png)]]
+
+When Pageant is running, its icon will be in your taskbar notification area (usually botton-left corner).
+
+[[Image(swish-pageant-icon.png)]]
+
+Pageant doesn't do anything without keys so now you need to add one.
+
+== Creating new keys ==
+
+If you don't already have a key to use, you will need to create one.  Swish doesn't do this bit for you yet so you will need to [http://the.earth.li/~sgtatham/putty/latest/x86/puttygen.exe download PuTTYgen] and use it to create a new one in Putty (PPK) format.  
+
+[[Image(swish-puttygen-generate-save.png)]]
+
+PuTTYgen will show you the 'public' half of your new key.  You will probably need it later so leave the window open after you have saved the private key somewhere.
+
+== Adding your key to Pageant ==
+
+[[Image(swish-puttygen-publickey.png)]]
+
+Once you have a key, right-click on the Pageant notification icon to bring up the menu.  Choose ''Add Key'' and open your key file.
+
+[[Image(swish-pageant-menu.png)]]
+
+== Tell your SFTP server about the key ==
+
+This still won't do anything useful unless you have told your SFTP server about this new key.  As we said earlier, this doesn't mean you give it a copy of the whole key, just the 'public' part.  How you do this varies wildly from server to server.  Web hosting companies often ask you to paste the public key from the PuTTYgen window into a form on your admin pages.  Or if your SFTP server is a Linux running OpenSSH, you need to add this text to the end of your `authorized_keys` file (usually in `~/.ssh` - create it if it isn't there).
+
+You need to find out which way is right for your SFTP setup.