Differences

This shows you the differences between two versions of the page.

--- ssh_key_help [2014/02/21 16:43] – created bguillon
+++ ssh_key_help [2016/12/12 10:24] (current) – [Windows] onicolas
@@ Line 1: / Line 1: @@
 # SSH key creation procedure
-This little guide is there to help you with the creation of your SSH key. This key will then be used for SSH connection to your personal account on the testbed.
+This little guide is there to help you with the creation of your SSH key. This key will then be used for SSH connections to your personal account on the testbed.
 ## Unix
 The SSH key generation is fairly straightforward on Unix systems:
-`you@yourpc:~$ ssh-keygen -t rsa -f output_keyfile`
+<code>
+you@yourpc:~$ ssh-keygen -t rsa [-f <output_keyfile>]
+</code>
-Replace the value of `output_keyfile` with the desired destination path for the newly created key pair.
+The part in braces '[ ]' is optional and omitting it will generate key files at the default location ($HOME/.ssh/). If you wish to generate the keys at a different location, replace the value of `output_keyfile` with the desired destination path for the newly created key pair. Two files will be created:
-Two files will be created at the destination path:
 . The public key will have the *.pub* extension. This **is** the key that you will send us.
 . The private key should **never** be sent to anyone, even us, and remain secret.
-You can get more info about the `ssh-keygen` command in the **manpage** that can be found [there](http://www.delafond.org/traducmanfr/man/man1/ssh-keygen.1.html).
+You can get more info about the `ssh-keygen` command in the **manpage** (which can be found [here](http://www.delafond.org/traducmanfr/man/man1/ssh-keygen.1.html) for instance).
 ## Windows
-The SSH key generation can be a little bit more difficult on MS Windows, espacialy if you're not used to using the quite crude Putty tool suite. Indeed, you need to use the Puttygen tool to generate a SSH key pair.
+The SSH key generation can be a little bit more difficult on MS Windows, especially if you're not used to the quite crude Putty tool suite. Indeed, you need to use the Puttygen tool to generate a SSH key pair.
 You can get Putty (the SSH client) and Puttygen (the key generation tool) from the author's [website](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html).
@@ Line 27: / Line 28: @@
 {{ ::putty1.png?nolink |}}
-You should end up with two files, a public and a private keys:
+You should end up with two files, a public and a private key:
 . The public key will have the *.pub* extension. This **is** the key that you will send us.
@@ Line 34: / Line 35: @@
 If you're lost, ask Microsoft Customer Service.
 Just kidding, go read the [docs](http://www.chiark.greenend.org.uk/~sgtatham/putty/docs.html).
+# Usage of your SSH key in CorteXlab
+## Important notice
+If you are not familiar with SSH you might not be aware that the keys you just created will be needed whenever you want to connect to the testbed. That means that if you want to connect from another computer (i.e. not the one on which you generated the keys) you will have to copy both keys to this other computer.
+The two files that you must copy are:
+* The private key (default: `~/.ssh/id_rsa`).
+* The public key (default: `~/.ssh/id_rsa.pub`).
+Remember: your SSH private key is strictly confidential and personnal. Thus, it should be handled with care when you proceed with its copying on your computers. Moreover, this is what identifies you as a CorteXlab user and you do not want those to fall into the wrong hands.
+## Having multiple SSH keys
+We **do not support** users having multiple SSH keys yet. But this is definitely a feature that should be implemented in the near future.