Customize Remote Access Terminals

You can both customize the default access terminals, and add and customize your own access terminals in order to access your devices remotely from CloudShell Portal. You can also control which access terminals are available for which sets of equipment, and more.

In this article:

• Adding new remote access terminals
• Customizing access terminals based on specific equipment
• Setting the QualiX remote connection browser's title

Adding new remote access terminals

To add new remote access terminals:

1. Go to the C:\ProgramData\QualiSystems\Settings\Global\ServerUniversalSettings.xml file.

2. Under the <ConfigurationSection name="LinkApplications"> tag, add the new remote access terminals.

   For example, to grant access to a webpage of a device, copy one of the default access terminals (for example, RDP/Telnet as shown in the Enable Remote Connection to/from CloudShell Portal), and simply change the settings described in the following steps.

3. Perform the following steps in the line of the appropriate remote access terminals:
4. Change the entire pattern value to be the URL of the desired webpage.

5. Change the name and icon-key to be the name you want to display for the remote access terminal in CloudShell Portal (for example Web).

   For example: <key name="Web" pattern="http://quali.com" icon-key="Web" />

   The specified link (in this case Web) is displayed in the More Options list in CloudShell Portal (together with the predefined links to the default access terminals):

   

   When you click the (“Web”) link in an active sandbox, the desired URL (quali.com for example) is displayed.

Customizing access terminals based on specific equipment

This section explains how to create an access terminal to a specific device. This is done by setting, in the remote access terminal, the name of an attribute that is on the resource so that when connecting to the device, the attribute value on the resource will be used.

To customize access terminals according to particular sets of equipment:

1. In Quali server, open the following file in a text editor C:\ProgramData\QualiSystems\Settings\Global\ServerUniversalSettings.xml file.

2. Embed attributes in the connection string in order to make it flexible according to the device from which you are trying to open an access terminal.

   You may embed any attribute inside the connection string in order to make it dynamic and based on the device from which you need the access. Any attribute you have existing in CloudShell Resource Manager Client may be referenced inside the connection string by placing it inside curly brackets {}.

   For example, you can edit:

   <key name="Web" pattern="http://quali.com" icon-key="Web" />

   with dynamic attributes like this:

   <key name="Web" pattern={web_URL_attribute} icon-key="{website name attribute}" />

3. Save the file.

4. In Resource Manager Client, create and attach your custom attribute to the resource models/families for which you would like to use the customized connection string.

   To customize the common access terminals to specific sets of equipment,  do the following:

   1. For each access to the device, create a unique set of attributes:

      • {access type} User (for example, SSH User)
      • {access type} Password (for examle, SSH Password)
   2. Attach the attributes to the specific resource models for which you would like to have this access option.

5. Save your changes.

6. Return to the ServerUniversalSettings.xml file, and add the attributes in {} inside the matching connection string. .

   For example, attributes SSH User and SSH Password:

   <key name="SSH" pattern="https://192.168.56.7:83/Qx/connect?qualix=192.168.84.41&amp;qualixType=https&amp;ssh{qid}&amp;qtoken={qtoken}&amp;hostname={Address}&amp;protocol=ssh&amp;port=22&amp;username={SSH User}&amp;password={SSH Password}" icon-key="SSH" />

7. Keep the original User and Password attributes in a resource model if you need some server-side operations on it (connecting routes/auto load, etc.).
8. Restart the Quali Server service to apply the changes.

Setting the QualiX remote connection browser's title

It is possible to customize the title of the browser tab that opens when clicking the remote access link.

To set the caption of the browser tab:

1. Use the title tag to specify a CloudShell string attribute on the resource.

   The attribute's value will be used as the browser tab's title.

   For example, Tag Title:

   <key name="SSH" pattern="https://192.168.56.7:83/Qx/connect?qualix=192.168.84.41&amp;qualixType=https&amp;ssh{qid}&amp;qtoken={qtoken}&amp;hostname={Address}&amp;protocol=ssh&amp;port=22&amp;username={SSH User}&amp;password={SSH Password}&amp;title={Tag Title} "icon-key="SSH" />

2. Restart the Quali Server service.

   This is how the title should look (assuming the attribute's value on the resource is "new title"):