Contents
There are several ways to access the Charon-SSP AWS Instance.
SSH Command-Line Access
During the configuration of your instance you should have created a security group allowing at the minimum SSH access to the instance. If this has been done correctly, you can use SSH from the command-line or from a tool such as PuTTY to access the command-line of the charon user on the Charon-SSP instance.
If you select your instance in the instance list and then click on Connect, you will see the instructions for connecting via SSH.
In particular, you will see
- the name of the private key that must be used to connect to the instance, and
- the public DNS name of the instance.
The following image shows an example:
Note that the file permissions of the private key file must be set such that the file is only readable by the user. In the example above, the permissions are set to 400. This means that the only access is read-access by the user.
To connect to the instance as the user charon, use the following command:
$ ssh -o ServerAliveInterval=30 -i <path-to-your-private key> charon@ <AWS-public-IP-address> |
The parameter ServerAliveInterval
will protect the connection from timing out.
Below, you see sample output of a login:
$ ssh -o ServerAliveInterval=30 -i ./we-test-key2.pem charon@3.81.64.139 Last login: Tue May 21 05:34:33 2019 from myhost.example.com [charon@ip-172-31-38-252 ~]$ pwd /home/charon
Note that this account only allows a very limited subset of commands. In particular, commands that are required to set up an SSH tunnel (e.g., ip, iptables, sysctl) are allowed.
File transfer using SFTP
The SSH security group definition is also used to allow SFTP access to the Charon-SSP AWS instance. This allows file transfers to and from the Charon-SSP AWS instance. The user for file transfers is the storage user.
To connect to the instance as the user storage, use the following command:
$ sftp -i <path-to-your-private-key> storage@ <AWS-public-IP-address> |
Below you see sample output of a connection:
$ sftp -i ./we-test-key2.pem storage@3.81.64.139 Connected to storage@3.81.64.139. sftp> pwd Remote working directory: / sftp> ls storage
Connecting with the Charon-SSP Manager
To manage Charon-SSP and the emulated SPARC systems, you must connect to the Charon-SSP AWS instance with the Charon-SSP Manager. The Charon-SSP Manager is the main interface to all important functions of the Charon-SSP software.
Prerequisites:
- The Charon-SSP Manager must be installed on your local system.
- The Security Group on your local system must at least allow SSH access. This allows the built-in SSH tunneling of the Charon-SSP Manger to work. Should you not use SSH tunneling, you must open up additional ports (9091 for the Manager communication, any ports used for the emulated system serial console ports, and ports used for the graphical emulation). However, if the connection runs over the Internet, Stromasys recommends strongly to use SSH tunneling. Otherwise, your Charon-SSP cloud instance and any emulated systems running on it can easily be compromised.
- The public key installed in
.ssh/authorized_keys
of the charon user of the Charon-SSP AWS instance must be copied to the local system. The Charon-SSP Manager needs this key to set up SSH tunneling. - Public IP address of the Charon-SSP AWS instance.
Copy the Public Key to the Local System
To copy the Charon-SSP AWS public key to the local system, perform the following steps:
Step | Detail / Command |
---|---|
Use SSH to login to your Charon-SSP instance from your local system. | $ ssh -o ServerAliveInterval=30 -i <path-to-your-private key> charon@ <AWS-public-IP-address> |
On the Charon-SSP host, display the public key and copy the content. | $ cat ~/.ssh/authorized_keys |