Changes between Version 20 and Version 21 of User Guide/Remote Access/SSH

Timestamp:

Apr 5, 2023, 5:08:14 PM (14 months ago)

Author:

jkol

Comment:

—

User Guide/Remote Access/SSH

@@ -107 +107 @@
 
 [[CollapsibleStart(Windows)]]
+Select your SSH client:
+
+[[CollapsibleStart(PowerShell)]]
+These instructions assume that you are using the built-in SSH client provided in Windows !PowerShell.
+
+==== Generating Keys
+ 1. Open a !PowerShell terminal.
+
+ 2. Enter the following command at the prompt:
+{{{#!shell-session
+ssh-keygen.exe
+}}}
+ Follow the prompts to generate your SSH key pair. For security reasons, we recommend entering a passphrase for your key. An example of the output you will see is shown below.
+{{{#!shell-session
+PS C:\Users\local_user> ssh-keygen
+Generating public/private rsa key pair.
+Enter file in which to save the key (C:\Users\local_user/.ssh/id_rsa):
+Enter passphrase (empty for no passphrase):
+Enter same passphrase again:
+Your identification has been saved in C:\Users\local_user/.ssh/id_rsa.
+Your public key has been saved in C:\Users\local_user/.ssh/id_rsa.pub.
+The key fingerprint is:
+SHA256:/sR9z7I0dW40cKcUabv2yv7VAAkLy+snm4tpt9UW6qg local_user@local-pc
+The key's randomart image is:
++---[RSA 3072]----+
+|        . .   .. |
+|       . . o .o. |
+|        o . oo.o.|
+|         .   o+o.|
+|        S   . oo+|
+|       S . + .o=+|
+|        + * +.+.=|
+|      .o.@ . +.=o|
+|     .Eo*oo  .==+|
++----[SHA256]-----+
+}}}
+
+==== Uploading your public key to you COSMOS account
+ ''NOTE: Internet Explorer is not supported for Control Panel operations (including key upload)''
+
+ To upload you public key to your cosmos account, do the following:
+ 1. Go to [https://wiki.cosmos-lab.org/cPanel/accountManagement/adminAuthKeys Profile] and sign in with your COSMOS username and password
+
+ 2. Click on "Change My Profile" option in the left side menu
+
+ 3. Click the "Choose File" button next to "Public key file"
+
+ 4. Navigate to where your '''public key file''' is stored (in the previous example it would be something like C:\Users\local_user\.ssh\id_rsa.pub)
+
+ 5. Select the public key file you wish to use for COSMOS access
+
+ 6. Click "Open"
+
+ 7. Click the "Update Profile" button
+
+ As a side note, expect to see a default auto generated public key in the list (ends with @internal1). This is used for SSH access between machines inside the COSMOS network. Please do NOT delete this key.
+
+ [[Image(ControlPanel.jpg, width=700)]]
+
+[[BR]]
+==== Configuring your SSH client
+
+ Under normal circumstances, as long as the private key file is located in the C:\Users\local_user\.ssh\ folder, the command line SSH client will use the correct key when connecting.
+
+ To test your setup, open a !PowerShell terminal and (replacing your_cosmos_username with your own COSMOS username) type:
+{{{#!shell-session
+ssh your_cosmos_username@gw.cosmos-lab.org
+}}}
+
+ You should be prompted to enter your key file passphrase and be able to successfully connect.
+
+ If necessary, you can also manually specify the path to your private SSH key as follows:
+{{{#!shell-session
+ssh -i C:\Users\local_user\.ssh\id_rsa your_cosmos_username@gw.cosmos-lab.org
+}}}
+
+ Type exit and press the Enter key to end the SSH session.
+
+[[CollapsibleEnd]]
 
 [[CollapsibleStart(PuTTY)]]
 These instructions assume that you are using [https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html PuTTY] as your SSH client.
 
-==== Generating keys
+==== Generating Keys
  In PuTTY, the key generation is handled by a separate program named ''puttygen.exe''. If you installed PuTTY via the installer, there should be an icon for PuTTYgen in your Start menu, otherwise [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html download it from here].