2009-03-20T21:47:14Z

added link to cygwin docs 1102 GeneratingAnSSHKey 22

[[Home | » Project Kenai Documentation and Training]]     [[Howdoi | » How Do I ...]] =Generating an SSH Key= You'll need to generate a Secure Shell Protocol (SSH) key if you use the Git source code management system. Mercurial repositories are also available though SSH as a more secure and reliable alternative to the HTTPS access mechanism. SSH provides higher performance and authentication via public key cryptography rather than with a password. To access your repositories via SSH, first ensure that you have an SSH client available on your local system, as described below. You use that client to generate a pair of cryptographic keys, which you use in place of a password when you authenticate to our servers. The type of key to generate is an SSH2 key. You can generate either an RSA or a DSA key. Both will work on Kenai.com. After you use your SSH client on your system to generate an SSH key pair, you copy the public key to the [[ProfileSettings#SSH_Keys|SSH Keys tab]] in your personal profile. Subsequently, you need to use the SSH client to access the repository. Most UNIX, Linux, and Mac systems come with a built-in SSH client, OpenSSH. * For GitHub instructions on how to generate a key on Mac OSX systems, see [http://help.github.com/mac-key-setup/]. * For GitHub instructions on how to generate a key on Linux systems, see [http://help.github.com/linux-key-setup/]. If you have a Microsoft Windows system, there are a number of SSH clients you can run. * If you plan to work with GIT, see the instructions for using Git Bash at [http://help.github.com/msysgit-key-setup/]. * For instructions on using PuTTY on Microsoft Windows, see [[Winsshwithputty|Generating and Using an SSH Key on a Microsoft Windows Machine]]. The help files for PuTTY are well written and are a very useful resource for understanding SSH. * To set up Mercurial to use PuTTY with SSH, see [[Usinghg-winsshsetup|Setting Up Mercurial to Use SSH on a Microsoft Windows Machine]]. * If you plan use SSH with a Subversion repository, see [[Usingsvn-winsshsetup|Setting Up Cygwin to Use SSH on a Microsoft Windows Machine]] * For a list of other Windows clients, see [http://www.openssh.com/windows.html]. If you're new to the whole SSH thing, this blog might help you: [http://jimmyg.org/blog/2008/beginners-guide-to-ssh-keys-with-ssh2.html].

<a href='<?url_for_page Home ?>' class='<?class_for_page_link Home ?>'> » Project Kenai Documentation and Training</a>     <a href='<?url_for_page Howdoi ?>' class='<?class_for_page_link Howdoi ?>'> » How Do I ...</a> <h1><a name='Generating_an_SSH_Key'></a>Generating an SSH Key</h1> You'll need to generate a Secure Shell Protocol (SSH) key if you use the Git source code management system. Mercurial repositories are also available though SSH as a more secure and reliable alternative to the HTTPS access mechanism. SSH provides higher performance and authentication via public key cryptography rather than with a password. To access your repositories via SSH, first ensure that you have an SSH client available on your local system, as described below. You use that client to generate a pair of cryptographic keys, which you use in place of a password when you authenticate to our servers. The type of key to generate is an SSH2 key. You can generate either an RSA or a DSA key. Both will work on Kenai.com. After you use your SSH client on your system to generate an SSH key pair, you copy the public key to the <a href='<?url_for_page ProfileSettings?>#SSH_Keys' class='<?class_for_page_link ProfileSettings?>'>SSH Keys tab</a> in your personal profile. Subsequently, you need to use the SSH client to access the repository. Most UNIX, Linux, and Mac systems come with a built-in SSH client, OpenSSH. <ul><li> For GitHub instructions on how to generate a key on Mac OSX systems, see <a class='external' href="http://help.github.com/mac-key-setup/">http://help.github.com/mac-key-setup/</a>. </li><li> For GitHub instructions on how to generate a key on Linux systems, see <a class='external' href="http://help.github.com/linux-key-setup/">http://help.github.com/linux-key-setup/</a>. </li></ul> If you have a Microsoft Windows system, there are a number of SSH clients you can run. <ul><li> If you plan to work with GIT, see the instructions for using Git Bash at <a class='external' href="http://help.github.com/msysgit-key-setup/">http://help.github.com/msysgit-key-setup/</a>. </li><li> For instructions on using PuTTY on Microsoft Windows, see <a href='<?url_for_page Winsshwithputty?>' class='<?class_for_page_link Winsshwithputty?>'>Generating and Using an SSH Key on a Microsoft Windows Machine</a>. The help files for PuTTY are well written and are a very useful resource for understanding SSH. </li><li> To set up Mercurial to use PuTTY with SSH, see <a href='<?url_for_page Usinghg-winsshsetup?>' class='<?class_for_page_link Usinghg-winsshsetup?>'>Setting Up Mercurial to Use SSH on a Microsoft Windows Machine</a>. </li><li> If you plan use SSH with a Subversion repository, see <a href='<?url_for_page Usingsvn-winsshsetup?>' class='<?class_for_page_link Usingsvn-winsshsetup?>'>Setting Up Cygwin to Use SSH on a Microsoft Windows Machine</a></li><li> For a list of other Windows clients, see <a class='external' href="http://www.openssh.com/windows.html">http://www.openssh.com/windows.html</a>. </li></ul> If you're new to the whole SSH thing, this blog might help you: <a class='external' href="http://jimmyg.org/blog/2008/beginners-guide-to-ssh-keys-with-ssh2.html">http://jimmyg.org/blog/2008/beginners-guide-to-ssh-keys-with-ssh2.html</a>.

2009-12-24T01:19:11Z