Using the SSH Command Set

The SSH command set contains commands that

SSH is one of the most successful applications that provides strong cryptographic protections today. It is certainly the first and so far only cryptographic application to become so ubiquitous as to replace its insecure predecessor (telnet).

Despite this success, SSH can be tricky to deploy and not through any fault of the design of the application. Configuring SSH access to a machine that you are accessing via SSH is an inherently tricky task: Any error in the configuration may render the machine unavailable.

Another major weakness in the use of SSH is that following best practices for key management such as using a different authentication key on each client device is tedious at best. Most worrying of all is the fact that much of the advice given on 'how to configure SSH' is written from the perspective of how to get SSH to work rather than how to make an SSH configuration secure.

Most people who use SSH reguilarly have developed a set of scripts to perform routine administrative tasks. But while writing a script is a trivial task, debugging and checking for security vulnerabilities is certainly not.

Transferring configuration and administration tasks to the Mesh provides an approach that is considerably more robust than a shell script is likely to provide and is far more likely to attract the third party review necessary to build confidence in its security.

Since SSH authentication is bidirectional, an SSH profile is used to manage two separate sets of public keys.

Client Authentication keys
Public keypairs used to authenticate a client to a host. These are the keys whose private components are stored in user local storage and whose public components appear in generate the authorized_keys file.
Host Authentication keys
Public keypairs used to authenticate a host to a client. These are keys whose private components are stored in a system wide storage and whose public components appear in the known_hosts file.

Creating an SSH profile

The `ssh create` command adds an SSH profile named `ssh` to a Mesh account:

Alice> ssh create
ERROR - The feature has not been implemented

Since the command creates a new application catalog, the command must be given to an administration device.

Client Configuration

Adding an SSH profile causes a public keypair to be created for use with SSH. To make use of this keypair for device authentication with legacy applications typically requires the public and/or private keys to be extracted in a format supported by the application.

The `ssh private` command extracts the private key required top configure an SSH client:

Alice> ssh private ssh-key.public
ERROR - The feature has not been implemented

The `ssh public` command extracts the public key required top configure an SSH client:

Alice> ssh public ssh-key.public
ERROR - The feature has not been implemented

If a script is being used to automate this process, the best practice is for the script to first generate a random nonce and request that the private key file be extracted encrypted under the nonce which can be discarded after the key is successfully installed. [Not currently supported.]

Configuring authentication entries on hosts and clients

The `ssh merge client` command is run on a host to update mesh key entries in the `authorized_keys` file using information from the specified mesh portal.

For example, if the `authorized_keys` file has an entry for Alice's Mesh profile (``), the corresponding profile is fetched and the corresponding SSH device public keys added:

Alice> ssh merge client

The `ssh merge host` command reads the `known_hosts` file on a client machine and adds the listed hosts to the user's ssh catalog.

Alice> ssh merge host

Client Key management

SSH keys belonging to the user that are not part of the Mesh profile may be added using the `ssh add client` command.

Alice> ssh add client

The list of known clients may be returned in various formats using the `ssh show client` command.

Alice> ssh show client

Host Key Management

The `ssh add host` command adds specific host entries to the user's SSH profile.

Alice> ssh add host

The current list of known hosts in the SSH catalog is returned by the `ssh show known` command.

Alice> ssh show host

Additional Devices

Whenever an SSH profile is created, a separate keypair is created for every device connected to the profile. This mitigates the consequences of a device being lost or stolen. The device key for the compromised device can be removed from the profile without affecting any other device. Investigation of possibly unauthorized logins can be focused on those from the compromised device alone.

The `device auth /ssh` command is used *from an administration device* to enable use of ssh on the machine:

Alice> device auth Alice2 /ssh

Once the device has been authorized, the client machine can start using SSH immediately:

Alice> ssh show host