[[TOC(Documentation/SSHConf, depth=2)]]
= SSH Keys =

Configuring your SSH client to use keys instead of password

== Linux ==

Each distribution has their own location for the specific generation tools. The documentation for Ubuntu is located [https://help.ubuntu.com/community/SSH/OpenSSH/Keys here]. The generation process can be done with the ssh-keygen utility.

To create your public and private SSH keys on the command-line:
{{{
ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (...):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in ...
Your public key has been saved in ...
Your public key is now available as .ssh/id_rsa.pub in your home folder.
}}}

This process will generate and store a private key and a public key file. The public key file will be named id_rsa.pub, and the private key will be stored in the file you specify when prompted. [#Upload Upload] your new public key to your orbit account.

== Windows ==

=== Putty ===
In putty the key generation is handled by a separate program named puttygen.exe. If you've installed putty via the installer there may be an icon for it in the putty menu group, otherwise download it [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html here]. Generating a public/private key pair on your host by using PuTTYgen as illustrated in the following table (for more details on configuration please csee [http://www.chiark.greenend.org.uk/~sgtatham/putty/ putty documentation]):

|| 1. || Start PuTTYgen; The running executable windows is shown on the left.  || [[Image(PuTTYgen1.jpg, width=300)]] ||
|| 2. || Click the Generate button. You will be asked to move mouse to generate some randomness. After that the program will generate key and display the result.[[BR]] You can leave blank "Key passphrase" and "Confirm passphrase" to be able to authenticate without passphrase.[[BR]] Save public and private key (you can recover the public key from the private key with PuTTYgen by clicking the Load button). || [[Image(PuTTYgen2.jpg, width=300)]] ||
|| 3. || [#Upload Upload] your new public key to your orbit account. ||||
|| 4. || To connect to remote host by using newly minted keys configure your session in Pytyy: '''Load''' the session profile, go to Connection > SSH > Auth window and select the newly created private key; click '''Save''' to update session profile and then proceed to connect. If you didn't specify the passphrase in step 2, you won't be prompted for the password.  || [[Image(PuTTYgen5.jpg, width=300)]] ||


=== SSH Secure Shell ===

|| 1. || Start the ssh client || [[Image(SecSh1.jpg, width=300)]][[BR]] ||
|| 2. || From the menu choose Edit> Settings option and then Key || [[Image(SecSh2.jpg, width=300)]] ||
|| 3. || Click the Generate button. || [[Image(SecSh3.jpg,width=300)]] ||
|| 4. || Click Next || [[Image(SecSh4.jpg, width=300)]] ||
|| 5. || Select RSA type of the key. Click Next || [[Image(SecSh5.jpg, width=300)]] ||
|| 6. || Wait until key is generated. || [[Image(SecSh6.jpg, width=300)]] ||
|| 7. || Enter file name for private key and comment. Leave passphrase blank. Click Next, Next and then save public key into file by clicking Export button || [[Image(SecSh7.jpg, width=300)]] ||
|| 9. || [#Upload Upload] your new public key to your orbit account. ||||
|| 10. || After you upload public key you can connect to host choosing Public Key option for Authentication Method. || [[Image(SecSh8.jpg, width=300)]] ||

== Mac ==

== Install the public key for the ORBIT infrastructure == #Upload

To upload you public key to your orbit account visit [https://www.orbit-lab.org/loginService/ControlPanel]. Choose "Change My Profile" option which will bring up the form to upload your public key.

[[Image(ControlPanel.jpg)]]