[[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, click Next || [[Image(SecSh3.jpg,width=300)]] ||
|| 4. || Select RSA type of the key. Click Next || [[Image(SecSh5.jpg, width=300)]] ||
|| 5. || Wait until key is generated. || [[Image(SecSh6.jpg, width=300)]] ||
|| 6. || 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)]] ||
|| 7. || [#Upload Upload] your new public key to your orbit account. ||||
|| 8. || 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. Please be aware that IE browser is not supported for Control Panel operations (and key upload).

[[Image(ControlPanel.jpg)]]