Committer SSH Configuration on Windows
Windows users have a choice to when make when using SSH to access
people.apache.org : to either install cygwin and
use the standard command line tools or to use Putty which
provides a graphical user interface.
Non-Windows-specific documentation is also available, and generally contains details that are not repeated in this document.
Setting Up Putty
Describes how to create a public/private key pair and how to configure
Putty to use them to access
Download & install Putty
Putty can be downloaded
here. Double-click on
the downloaded Installer package to install Putty to a suitable location.
Once installed it will be easier to transfer files using PSFTP if the Putty
directory is in your
Putty comes with Puttygen , Pageant and PSFTP amongst other things. We will be using all the ones just mentioned.
Create A Public/Private Key Pair Using PuttyGen
Double-click on Puttygen to start the authentication keys creation process.
Type of key to generatehas
Generateto create a random key (and move the mouse around to supply the required entropy).
Keycomment on its default description or change it if you wish.
Key Passphrasewhich will protect your private key and confirm it.
Save Public Keyand save it as
Save Private Keyand save it as
This next step is important, although we have saved your
Public Key as
yourapacheusername.pub , we don't actually use this next (but it is saved
for use in other scenarios). We now need to create an
Copy the Public Key information in the top box and paste into
save the file as
authorized_keys. Note that the file must be called
precisely this and there must also be no extension. Ensure
not add one when you save it.
Finally, close Puttygen.
Upload The 'authorized_keys' file using PSFTP
Open a DOS Prompt box and navigate to the location where you stored your
psftp people.apache.orginto the prompt.
A connection will be made to
people.apache.organd will ask for your login username and then password. (Once we have completed this tutorial you will no longer be asked this)
Create a new directory in your area called
chmod 700 .ssh. This ensures only you can then enter this directory.
Navigate into this directory with
authoriized_keysfile. with the command
exitto logout from your
people.apache.orgprivate area and from
Add Key to Pageant and run Pageant
This is probably the most overlooked but most important step for Windows
users. We need to load a key into Pageant and have Pageant running all the
time in memory so that other applications can use the keys created earlier.
Otherwise, when entering
people.apache.org Putty or PSFTP will prompt for
user and password once again regardless of the work we have just done.
Open Pageant and click on
Addto add a new key
browse to your
yourapacheusername.ppkprivate key file and load this in,
Closeto close this window. Note Pageant is still running with an Icon in the system tray.
You should now be able to login without being asked for your username or
password any more :) Try it! From the
DOS command box type in
people.apache.org. You should log right in with no more to type!
Note that whenever you Exit Pageant, or restart your computer, you will need to restart Pageant and Add your key in again. Pageant does not keep details of loaded keys between sessions.
Configure Putty to Login using your Keys
Open up Putty.
people.apache.orgas the Hostname.
Ensure SSH protocol radio button is checked.
Fill in your Apache username for auto-login username.
Click on the SSH Category.
SSH 2 Onlyradio button is checked.
Click on the
Authsub-category of the SSH Category.
Attempt "Keyboard Interactive" auth (SSH 2)checkbox is ticked.
BrowseButton and locate and load your
Private Keyyou saved earlier as
Go back and click on the
SessionCategory and Save this session choosing a suitable name.
Good, all the details are now saved for future use. All you need do now is
click on the
Open button to open a secure connection to the server and to
log in automatically to your personal area of
people.apache.org. You will
still be asked for a password if this is the first time connecting to your
area, after which you'll just go straight in.