Changes between Version 7 and Version 8 of User Guide/Remote Access/SSH

Timestamp:

Nov 15, 2019, 3:26:26 PM (5 years ago)

Author:

nilanjan

Comment:

—

User Guide/Remote Access/SSH

@@ -212 +212 @@
 
 [[CollapsibleStart(Mac)]]
- '''Mac instrucstions are currently under development. We apologize for the inconvenience.'''
+
+Mac OS has a native command line ssh client that can be used to remotely log into consoles. From the Finder select Applications -> Utilities -> Terminal to open a command line terminal.
 
 ==== Generating keys ====
- TODO
+Generate the public and private keys using the following command
+{{{
+ssh-keygen -t rsa
+}}}
+
+Follow the prompt to save the keys in the default location, use a passphrase for additional security. Once your keys are saved successfully, a 'randomart' will be generated.
+{{{
+your_username@Macintrash ~ % ssh-keygen -t rsa -C mac
+Generating public/private rsa key pair.
+Enter file in which to save the key (/Users/your_username/.ssh/id_rsa): 
+Created directory '/Users/your_username/.ssh'.
+Enter passphrase (empty for no passphrase): 
+Enter same passphrase again: 
+Your identification has been saved in /Users/your_username/.ssh/id_rsa.
+Your public key has been saved in /Users/your_username/.ssh/id_rsa.pub.
+The key fingerprint is:
+SHA256:sclFUKMVPUAUBEk+Qa3MZhLv3qfo/BWY+B5huCajS5U mac
+The key's randomart image is:
++---[RSA 2048]----+
+|       o*X%=     |
+|      ...=..o    |
+|       ==..  .   |
+|      .oBO o     |
+|      E=S = .    |
+|     .  .+ . .   |
+|    . o.o.o .    |
+|   . . =.o.o.    |
+|    o. .+.+o     |
++----[SHA256]-----+
+}}}
 
 [[BR]]
@@ -226 +256 @@
  3. Click the "Choose File" button next to "Public key file"
  
- 4. Navigate to where your '''public key file''' is stored (typically /home/your_username/.ssh)
+ 4. Navigate to where your '''public key file''' is stored (typically /Users/your_username/.ssh)
 
  5. Select the .pub file corresponding to the key you wish to use for COSMOS access
@@ -240 +270 @@
 [[BR]]
 ==== Configuring your SSH client ====
- TODO
+ Under normal circumstances, as long as the private key file is located in the /Users/your_username/.ssh/ folder, the command line SSH client will use the correct key when connecting.
+
+ To test your setup, open a command-line terminal and (replacing ''your_orbit_username'' with your own ORBIT username) type:
+{{{
+ssh your_orbit_username@gw.orbit-lab.org
+}}}
+ You should be prompted to enter your key file passphrase and be able to successfully connect.
+
+ Type {{{exit}}} and press the Enter key to end the SSH session.
+
 
 [[BR]]