| 209 | |
| 210 | [[BR]] |
| 211 | |
| 212 | [[CollapsibleStart(Mac)]] |
| 213 | |
| 214 | 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. |
| 215 | |
| 216 | ==== Generating keys |
| 217 | Generate the public and private keys using the following command |
| 218 | {{{ |
| 219 | ssh-keygen -t rsa |
| 220 | }}} |
| 221 | |
| 222 | 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. |
| 223 | {{{#!shell-session |
| 224 | your_username@Macintosh ~ % ssh-keygen -t rsa -C mac |
| 225 | Generating public/private rsa key pair. |
| 226 | Enter file in which to save the key (/Users/your_username/.ssh/id_rsa): |
| 227 | Created directory '/Users/your_username/.ssh'. |
| 228 | Enter passphrase (empty for no passphrase): |
| 229 | Enter same passphrase again: |
| 230 | Your identification has been saved in /Users/your_username/.ssh/id_rsa. |
| 231 | Your public key has been saved in /Users/your_username/.ssh/id_rsa.pub. |
| 232 | The key fingerprint is: |
| 233 | SHA256:... mac |
| 234 | The key's randomart image is: |
| 235 | ... |
| 236 | }}} |
| 237 | |
| 238 | [[BR]] |
| 239 | ==== Uploading your public key to you COSMOS account |
| 240 | To upload you public key to your cosmos account, do the following: |
| 241 | 1. Go to [https://wiki.cosmos-lab.org/cPanel/accountManagement/adminAuthKeys Profile] and sign in with your COSMOS username and password |
| 242 | |
| 243 | 2. Click on "Change My Profile" option in the left side menu |
| 244 | |
| 245 | 3. Click the "Choose File" button next to "Public key file" |
| 246 | |
| 247 | 4. Navigate to where your '''public key file''' is stored (typically /Users/your_username/.ssh). Note: because the .ssh folder begins with a period, it is hidden in the file browser by default. You can press "command"+"shift"+"." to show hidden files and folders in the file browser. |
| 248 | |
| 249 | 5. Select the .pub file corresponding to the key you wish to use for COSMOS access |
| 250 | |
| 251 | 6. Click "Open" |
| 252 | |
| 253 | 7. Click the "Update Profile" button |
| 254 | |
| 255 | 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. |
| 256 | |
| 257 | [[Image(wiki:UserGuide/RemoteAccess/SSH:ControlPanel.jpg, width=700)]] |
| 258 | |
| 259 | [[BR]] |
| 260 | ==== Configuring your SSH client |
| 261 | 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. |
| 262 | |
| 263 | To test your setup, open a command-line terminal and (replacing ''your_orbit_username'' with your own ORBIT username) type: |
| 264 | {{{ |
| 265 | ssh your_orbit_username@gw.orbit-lab.org |
| 266 | }}} |
| 267 | You should be prompted to enter your key file passphrase and be able to successfully connect. |
| 268 | |
| 269 | Type {{{exit}}} and press the Enter key to end the SSH session. |
| 270 | |
| 271 | |
| 272 | [[BR]] |
| 273 | ==== Common issues and how to solve them |
| 274 | * TODO |
| 275 | [[CollapsibleEnd]] |