User Manual
To save a configuration .xml file (for backup or for importing into other SDT Connector clients) select
File
> Export Preferences
and select the location to save the configuration file
To import a configuration select
File > Import Preferences
and select the .xml configuration file to be
installed
5.7
SDT Connector Public Key Authentication
SDT Connector can authenticate against an SSH gateway using your SSH key pair rather than requiring
you to enter your password. This is known as public key authentication.
To use public key authentication with SDT Connector, first you must add the public part of your SSH key
pair to your SSH gateway:
1.
Ensure the SSH gateway allows public key authentication, this is the default behavior
2.
If you do not already have a public/private key pair for your client PC (the one running SDT
Connector on) generate them using ssh-keygen, PuTTYgen or a similar tool. You may use RSA
or DSA, but it is important that you leave the passphrase field blank:
•
PuTTYgen: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
•
OpenSSH: http://www.openssh.org/
•
OpenSSH (Windows): http://sshwindows.sourceforge.net/download/
3.
Upload the public part of your SSH key pair (this file is named id_rsa.pub or id_dsa.pub) to the
SSH gateway, or otherwise add to .ssh/authorized keys in your home directory on the SSH
gateway
4.
Next, add the private part of your SSH key pair (this file is named id_rsa or id_dsa) to SDT
Connector. Click
Edit > Preferences > Private Keys > Add
, locate the private key file and click
OK
You do not have to add the public part of your SSH key pair, it is calculated using the private key.
SDT Connector uses public key authentication when connecting through the SSH gateway (console
server). You may have to restart SDT Connector to shut down any existing tunnels that were established
using password authentication.
If you have a host behind the console server that you connect to by clicking the SSH button in SDT
Connector you may also wish to configure access to it for public key authentication as well. This
configuration is independent of SDT Connector and the SSH gateway. You must configure the SSH client
that SDT Connector launches (e.g. Putty, OpenSSH) and the host's SSH server for public key
authentication. You are using SSH over SSH, and the two SSH connections are separate.
