Differences

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

--- ssh_key_help [2014/03/27 10:39] – bguillon
+++ ssh_key_help [2025/05/14 14:03] (current) – cmorin
@@ 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
+## Linux/Unix/MacOS
 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 the quite crude Putty tool suite. Indeed, you need to use the Puttygen tool to generate a SSH key pair.
+On modern Windows versions (10 and above), an openSSH implementations should be directly available, allowing for the same key creation process as in Linux/MacOS:
+<code>
+you@yourpc:~$ ssh-keygen -t rsa [-f <output_keyfile>]
+</code>
+If it is not available, the SSH key generation can be a little bit more difficult, 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 34: @@
 {{ ::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 46: / Line 53: @@
 * 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.
+Remember: your SSH private key is strictly confidential and personal. 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.