To enable command-line access to the Connect gateway device, an SSH key for authentication must be uploaded to the gateway. SSH can be enabled in both development and productive modes.

Maximum 3 SSH keys can be used concurrently.

Generate SSH key

On both Windows and Linux, a new SSH key can be created with the command ssh-keygen.

  1. Open a terminal window and move into the SSH directory with cd ~/.ssh. If the directory does not exist, create it with mkdir ~/.ssh.
  1. Type ssh -V to verify that SSH functions are supported.
  1. At the shell prompt, type ssh-keygen -t rsa and press Enter.
  1. Enter a name for the new SSH key file. Leave the passphrase empty by pressing Enter twice.
  • An SSH key pair is created, with the public key in .pub file format.

Add SSH key

  • Logged in as administrator to the Connect gateway, set in Development mode.
  1. In Security > Keys and certificates, go to the SSH keys section.
  1. Select Add key to open an input window.
  1. Copy the entire content of the public SSH key (.pub) file and paste it into the Key field.
  1. Add an identifiable description of the key in the Description field. The SSH key contains a name which appears as a suggestion in the field, but this can be edited.
  1. Save the key by pressing the Save button.
  1. When successfully uploaded, the key description appears in the SSH keys area.

SSH Client

To access the gateway over SSH, the client should have the keys stored in the correct directory. (An alternative file location can be specified with the -i switch.)

The private key - the generated file with the same name as the.pub file, but without file extension - needs to be located in the directory ~/.ssh on Windows or Linux. On both operating systems, an SSH connection can be established from a terminal window by the command

ssh root@<ip_address>

The user must then type the account password to login. Alternatively, a separate SSH client, such as PuTTY, can be used.