![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() | ![]() | ![]() | ![]() | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() | ![]()
![]() ![]() |
Abstract Installing the PuTTY program ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() Configuring WinCVS to work with SSH (PuTTY) ![]() ![]() AbstractInstalling the PuTTY programPuTTY is a fully featured SSH client for Windows operation systems. PuTTY is available from the PuTTY web site. Note: You need a couple of binaries, the PuTTY program itself is not enough. Including your PuTTY binaries in your default PATH You have to include the PuTTY binaries mentioned above in your system's default PATH. To do so add the path to your PuTTY binaries like the ollowing the your system's PATH environment variable. To test your PuTTY installation, you can try to type the following command at the command prompt of a dos box. How to generate your public/private RSA keySSH works with a private/public asymetric key scheme like it does PGP or other asymetric krypto systems. This fact requires that you generate a public/private key pair to use WinCVS with SSH (PuTTY). Generating these keys using the PuTTY key generator (PUTTYGEN.exe) is pretty easy. Just press 'generate' and move your mouse over the blank area until the key gets generated. After the procedure has finished you have to save the private/public key pair in a _SECURE_ place on your system by using the 'save public/private' buttons. Usually the private key is named ... A word from the wise (security note)The private key should _NEVER_ leave your system! Keep it as private as possible! How to install the public key on the SF systemInstalling your public key manuallyThe following section is just to demonstrate how the SSH public/private key system works. To get the public key installed on the SF OpenEJB CVS server you have to use SF's web based form for submiting public RSA keys. If you want to install your public key manually on one of the SF servers, you have to perform a few steps. The two figures below illustrate the processes described above. Installing your public key using the SF upload formThe SF upload form for public RSA/DSA keys can be found at your account options page of your SF personal page. If you are using the SF web based form, your public key gets distributed within six hours to the following systems. How to start and configure the PuTTY SSH agentThe PuTTY SSH agent manages all your private RSA/DSA keys. Launching the PuTTY SSH agent is very easy - just execute the program 'PAGEANT.exe'. After starting the agent a new icon should reside in your system tray. How to add a private key to the PuTTY SSH agentBy openeing the PuTTY SSH agent you are able to add your private RSA/DSA key. Be carefull you have to use your private key (identity)! From now on the PuTTY SSH agent will log you in to any remote system which has your public key installed on it. No need to type passwords any more. Testing your private/public keys
A word from the wise (security note)Never leave your computer alone while running the PuTTY SSH agent! With the use of this agent, everybody might login to the SF servers without even having to know your password. Configuring WinCVS to work with SSH (PuTTY)There are just a few steps left until you will have a fully working CVS/SSH couple ;-) Making changes to the CVSROOT variableIf you want to use WinCVS in conjunction with SSH you have to use the SSH authentication method (aka :ext) The figure below shows my basic WinCVS settings. Additional but important WinCVS optionsFinally you have to provide the SSH binary which should be used by WinCVS. In our case this is PLINK.exe. From now on you should be able to work with CVS using SSH as you did earlier without SSH. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() | ![]() | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() | ![]() | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() |