Preparing the SSH client on an AIX host Getting started with the Command-Line Interface Issuing CLI commands from a PuTTY SSH Client system

This task provides step-by-step instructions about how to prepare the SSH client on an AIX host.

Context

When using AIX hosts, SSH logins are authenticated on the SAN Volume Controller cluster using the RSA based authentication supported in the OpenSSH client available for AIX. This scheme is based on public-key cryptography, using a scheme known commonly as RSA. In this system (as in similar OpenSSH systems on other host types) the encryption and decryption is done using separate keys. This means it is not possible to derive the decryption key from the encryption key. Initially, the user creates a public/private key pair for authentication purposes. The server (which is the SAN Volume Controller cluster in this case) knows the public key, and only the user (or the AIX host) knows the private key. Physical possession of the public key allows access to the cluster, so this must be kept in a protected place (typically in the /.ssh directory on the AIX host, with restricted access permissions).

The SAN Volume Controller cluster uses the following mechanism to establish that the AIX host is to be trusted, for example, that the AIX host possesses the private key.

When you log in, from the AIX host to the SAN Volume Controller cluster, the SSH program on the SAN Volume Controller cluster tells the AIX host which key pair it would like to use for authentication. The AIX server checks if this key is permitted, and if so, sends the user (actually the SSH program running on behalf of the user) a challenge, a random number, encrypted by the user's public key. The challenge can only be decrypted using the proper private key. The user's client (for example, the AIX host) then decrypts the challenge using the private key, proving that he/she knows the private key but without disclosing it to the server (for example, the SAN Volume Controller cluster) or to anyone who might be intercepting the transmissions between the AIX host and the SAN Volume Controller cluster.

The main steps in setting up a RSA key pair on the AIX host and the SAN Volume Controller cluster are as follows (detailed instructions are given in subsequent paragraphs):

  1. Create an RSA key pair by running the ssh-keygen program on the AIX host.
  2. Store the private key from this key pair on the AIX host, in the /.ssh directory.
  3. Place the public key on the SAN Volume Controller cluster and associate this key with an 'admin' or 'service' type user.

At this point, you may then use the 'ssh' or 'scp' utilities on the AIX host to establish an SSH session with the SAN Volume Controller cluster or to perform Secure Copy operations between the AIX host and the SAN Volume Controller cluster.

Steps

Perform the following steps to set up a RSA key pair on the AIX host and the SAN Volume Controller cluster:

  1. Create an RSA key pair by running the ssh-keygen program on the AIX host. This is best done in the $HOME/.ssh directory. This process will generate two user named files. Suppose the user selects the name 'key', then the files will be named 'key' and 'key.pub'.
  2. Store the private key from this key pair on the AIX host, in the '$HOME/.ssh directory', in the '$HOME.ssh/identity file'. In the simplest case, this means replacing the contents of the 'identity' file with the contents of the 'key' file. If multiple keys are to be used however, then all of these keys must appear in the 'identity' file. This step places the private key on the host.
  3. Move the public key, 'key.pub' to the master console of the SAN Volume Controller cluster of interest. Typically this might be done with ftp however the master console may have ftp disabled for security reasons, in which case an alternative method would be required (for example, a secure copy between the application host and the master console ). Then, using the SAN Volume Controller Console, and the SAN Volume Controller Web interface, select the 'Maintain SSH Keys' panel, and transfer the key.pub to the cluster. Select an access level of 'administrator' or 'service' as appropriate. In this example, we will assume the key was associated with an administrative ID and that the cluster IP name is 'mycluster'. This step places the public key on the cluster.
  4. You can now access the cluster from the AIX host, using ssh commands similar to the following:
    ssh admin@mycluster
    ssh admin@mycluster svcinfo lsnode

Refer to your clients documentation for SSH on your host system for more host specific details of this procedure.

Related topics Getting started with the Command-Line Interface Issuing CLI commands from a PuTTY SSH Client system

(C) Copyright International Business Machines Corporation 2003, 2004