Enable Remote Connection to/from CloudShell Portal

This section explains how to enable end-users to connect to their devices and VMs from resources, services and Apps in CloudShell sandboxes. To achieve this, you need to associate the QualiX machine with the remote access terminals you want to make available in CloudShell Portal. You can also create your own custom terminals (for example, to a specific website) - see Customize Remote Access Terminals.

For secure connections, see Enable SSL Connection to/from CloudShell Portal.

Notes: In order to connect to a device or VM from CloudShell Portal, the resource of the element must include the User and Password attributes. To learn how to add the attributes, see Prepare and Reserve Blueprint.

To connect using a service, the service must include an Address.

To enable remote connection from CloudShell Portal:

1. In Quali server, open the following file in a text editor:

   C:\ProgramData\QualiSystems\Settings\Global\ServerUniversalSettings.xml

2. Under the <ConfigurationSection name="LinkApplications"> tag, replace the lines of the relevant remote access terminals (Telnet, SSH, RDP, VNC) with the lines in this code sample:

   <key name="Telnet" pattern="http://<CloudShell Portal Host>:<CloudShell Portal Port>/Qx/connect?qualix=<VM IP>&amp;qualixType=https&amp;telnet{qid}&amp;qtoken={qtoken}&amp;hostname={Address}&amp;protocol=telnet&amp;port=23&amp;username={User}&amp;password={Password}" icon-key="Telnet" /> <key name="SSH" pattern="http://<CloudShell Portal Host>:<CloudShell Portal Port>/Qx/connect?qualix=<VM IP>&amp;qualixType=https&amp;ssh{qid}&amp;qtoken={qtoken}&amp;hostname={Address}&amp;protocol=ssh&amp;port=22&amp;username={User}&amp;password=secure" icon-key="SSH" /> <key name="RDP" pattern="http://<CloudShell Portal Host>:<CloudShell Portal Port>/Qx/connect?qualix=<VM IP>&amp;qualixType=https&amp;rdp{qid}&amp;qtoken={qtoken}&amp;hostname={Address}&amp;protocol=rdp&amp;port=3389&amp;username={User}&amp;password={Password}&amp;security=any&amp;ignore-cert=true" icon-key="RDP" /> <key name="VNC" pattern="http://<CloudShell Portal Host>:<CloudShell Portal Port>/Qx/connect?qualix=<VM IP>&amp;qualixType=https&amp;vnc{qid}&amp;qtoken={qtoken}&amp;hostname={Address}&amp;protocol=vnc&amp;port=5900&amp;username={User}&amp;password={Password}" icon-key="VNC" />

   Note: The qtoken & qid keys are automatically filled out by the server and are related to CloudShell security enhancements. You do not need to configure anything related to these keys.

3. Replace <CloudShell Portal Host> with the CloudShell Portal hostname or DNS name, and <CloudShell Portal Port> with the CloudShell Portal port.

   Note: For remote connections to devices from CloudShell, the Portal server value (for example, Portal's IP) specified here must be the same one used to log into CloudShell. Using a different value, like the hostname, will prompt the sandbox end user to log into CloudShell again to access the device.

4. Replace <VM IP> with the IP of the QualiX Server or Docker swarm host machine (if deploying QualiX over Docker).

5. To find the IP of the VM, at the system prompt, run the ifconfig command. If you are using vSphere, VMware Tools also provides the machine's IP address (located in the vSphere Summary tab).

   For example, a configured SSH terminal:

   <key name="SSH" pattern="http://localhost:85/Qx/connect?qualix=192.168.42.166&amp;qualixType=https&amp;ssh{qid}&amp;qtoken={qtoken}&amp;hostname={Address}&amp;protocol=ssh&amp;port=22&amp;username={User}&amp;password=secure" icon-key="SSH" />

6. Save the file.
7. Restart the Quali Server service to apply the changes.