Changes between Version 1 and Version 2 of PublicKeyAuthentication


Ignore:
Timestamp:
30/07/12 20:08:08 (5 years ago)
Author:
alamaison
Comment:

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

Legend:

Unmodified
Added
Removed
Modified
  • PublicKeyAuthentication

    v1 v2  
    1 Swish will use any keys you add to Putty's key agent, Pageant, to authenticate you with servers you connect to. 
    2  
    31= Public key authentication = 
    42 
     
    64 
    75How 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. 
     6 
     7= Using keys = 
     8Swish 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. 
     9 
     10[[Image(swish-launch-agent.png)]] 
     11 
     12When Pageant is running, its icon will be in your taskbar notification area (usually botton-left corner). 
     13 
     14[[Image(swish-pageant-icon.png)]] 
     15 
     16Pageant doesn't do anything without keys so now you need to add one. 
     17 
     18== Creating new keys == 
     19 
     20If 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.   
     21 
     22[[Image(swish-puttygen-generate-save.png)]] 
     23 
     24PuTTYgen 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. 
     25 
     26== Adding your key to Pageant == 
     27 
     28[[Image(swish-puttygen-publickey.png)]] 
     29 
     30Once you have a key, right-click on the Pageant notification icon to bring up the menu.  Choose ''Add Key'' and open your key file. 
     31 
     32[[Image(swish-pageant-menu.png)]] 
     33 
     34== Tell your SFTP server about the key == 
     35 
     36This 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). 
     37 
     38You need to find out which way is right for your SFTP setup.