Windows: Adding a new SSH key to your QCS account (Using PuTTY)

PuTTYgen is an open-source utility and can be downloaded here. You will use PuTTYgen to generate SSH keys for use in PuTTY. Download the exectuable files (.exe). You will not need to "install" PuTTYgen, because it is a standalone application.

Generating SSH keys for use with PuTTY

  1. Launch PuTTYgen by double-clicking on the .exe file

  2. For Type of key to generate, select RSA

  3. In the Number of bits in a generated key field, specify either 2048 or 4096 (increasing the bits makes it harder to crack the key by brute-force methods);

  4. Click Generate

  5. Optionally, you may enter a name for your key pair in the Key comment field, and add a passphrase in the Key passphrase field.

  6. Click the Save public key button, select a location to save it to, and repeat with the Save private key button.

  7. Copy your public key from the text area labeled Public key for pasting into OpenSSH authorized_keys file

Next, after copying your public key as indicated for your system above, you will paste it into your QMI.

Open your JupyterLab Interface from the QCS dashboard and open a terminal window. Paste your public key to ~/id_rsa.pub using an editor such as vim and then add it to ~/.ssh/authorized_keys.

# Copy your public key to the ~/id_rsa.pub file in your QMI
# For example, `vim ~/id_rsa.pub`
cat ~/id_rsa.pub >> ~/.ssh/authorized_keys
# confirm key was added
more ~/.ssh/authorized_keys
rm ~/id_rsa.pub

To connect to your QMI from the terminal of your local computer, select which operating system you're currently using and follow the instructions below.