| | 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]] |