SSH Keys for Windows Users

Back to documentation index

Windows does not come with a SSH client. We will walk through the steps required for Windows users to generate and install a SSH key using PuTTYgen. PuTTY is a widely used suite of ssh client programs for Windows. The private portion of the key pair is stored on the client (Windows) machine and the public part is uploaded to the POD cluster from the portal.

For a more thorough introduction to SSH or public/private key concepts, visit www.openssh.org.


This guide, including screenshots, provides Here is a guide with screenshots on the following:
1. Creating a new key pair
2. Adding the key to your POD account
3. Running Pageant, a key management agent
4. Logging into your login node's shell using your ssh key
5. Managing files on your login node via winscp or filezilla

Not all of these steps are required. You may already have a key file you'd like to use. Before we start, you should download the following programs:
Putty: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
winscp: http://winscp.net/download/winscp556setup.exe
-or-
filezilla: http://sourceforge.net/projects/filezilla/files/FileZilla_Client/3.9.0.6/FileZilla_3.9.0.6_win32-setup.exe/download


Section 1: Creating a new key pair


1. Start PuTTYgen and generate a new public/private key pair or import an openssh key by opening Conversions/Import key:

Image title


2. After you generate or import an openssh key, save the private key.

Image title


3. Keep the key in a safe place.

Save SSH Key


Section 2: Adding the Key to Your POD Account

1. From PuTTYgen, highlight all of the public key, Make sure you get the beginning that starts with ssh-rsa and ends with the key-comment that is usually rsa-key-$date by default:

Image title


2. Log in to the POD portal and click on Manage SSH Keys. Click Add an SSH Key and paste the public key to upload:

POD Portal SSH Keys 1

3. You should then see the ssh key added to your account:

POD Portal SSH Keys 2


Section 3:  Running Pageant, Key Management Program

1. From your POD account, click Manage My Login Nodes and get the IP address:

POD Portal Login Nodes

2. Load the program Pageant:

Pageant

3. Add your private key that you saved to Pageant:

Pageant - load key

4. You should see your key on the list. You should make sure this matches the fingerprint of the key listed on the POD Portal.
Pagaent - Key Fingerprint

Section 4: Logging into Your Login Node's via SSH

Make sure Pageant is running!

1.  Run Putty and put in your login node into the Host Name. You can also save the session:

PuTTY Configuration

2. The first time you connect, a security alert will pop up, click yes to accept the host key:

PuTTY Security Alert

3. A window will pop up asking you what username to login as. Type in your username from your POD System Account. It should then authenticate you via pageant:

PuTTY - Connected

Section 5a: Managing Files on Your Login Node via WinSCP

Make sure Pageant is running!

1. Open WinSCP and put your login node into the Host name section. For File protocol, use either SCP or SFTP. Type in your username from your POD System Account and leave password blank. You can also save this login:

WinSCP Login

2. The first time you connect, a security alert will pop up, click yes to accept the host key:

WinSCP Warning

3. It should then log in and authenticate you via pageant:

WinSCP Auth Success

4. Your computer files are on the left and your POD files are on the right:

WinSCP Commander

Section 5b: Managing Files on Your Login Node via FileZilla

Make sure Pageant is running!

1. Open FileZilla and put your login node into the Host and your username from your POD System Account. Leave password blank and make sure port is set to 22. You can quickconnect or optionally save this login:

FileZilla Login

2. Your computer files are on the left and your POD files are on the right:

FileZilla