For the complete documentation index, see llms.txt. This page is also available as Markdown.

Alternate

The Alternate section of a session entry defines other hosts to connect to when the main host is not available, and the alternate (elevated) credentials of the entry. For SSH terminal entries, it also defines how the shell is elevated.

Available for session entries. In the entry properties, select Connection – Alternate. The Alternate host and Credentials groups are not shown for playlists. Not available on macOS. By default, the section is hidden in the simplified view of the properties; select Show all properties to display it.

Alternate host

The list at the top of the group defines how Remote Desktop Manager chooses the host when the session opens:

  • None: uses the host of the entry. The list of alternate hosts is disabled. This is the default value.

  • Ping: pings the host of the entry, then the alternate hosts in order, and connects to the first one that answers.

  • Prompt: asks the user to select a host among the host of the entry and the alternate hosts.

  • Manual: uses the host of the entry. To connect to an alternate host, open the entry with the Open (prompt for host) command.

  • Port scan: scans the port of the host of the entry, then of the alternate hosts in order, and connects to the first one that answers.

When alternate hosts are set, the Open (prompt for host) command is offered for the entry with every mode.

SETTING
DESCRIPTION

Allow custom host

Lets the user type a host that is not in the list. Shown with the Prompt mode.

Open VPN before

Opens the VPN, tunnel or gateway of the entry before testing or offering the alternate hosts. Not shown when the entry uses the Devolutions Gateway type in Connection – VPN/tunnel/gateway.

Alternate hosts

List of alternate hosts, one per line. A host can include a port, such as server2:3390, and variables. The Add host button selects a host from the network; it is disabled when network scans are disabled by policy.

Credentials

Alternate credentials replace the credentials of the entry when the session is opened with elevated credentials, and they provide the values of the $ELEVATED_USERNAME$, $ELEVATED_PASSWORD$ and $ELEVATED_DOMAIN$ variables and of the Type elevated commands. See Add elevated credentials to session entries.

SETTING
DESCRIPTION

Credentials

Source of the alternate credentials. The fields shown under the list depend on the source:

  • None: no alternate credentials. This is the default value.

  • Use session credentials: the credentials of the entry.

  • Username and password: credentials entered in the entry.

  • Linked (vault): a credential entry of the vault. Not offered in the user vault unless the system settings allow credential entries there.

  • My personal credentials: the personal credentials of the user.

  • Inherited: the alternate credentials of the parent folder.

  • My privileged account: the privileged account of the user.

  • Privileged account: a PAM account. Offered with a Remote Desktop Manager PAM license, when the workspace supports PAM and the entry type supports PAM credentials.

  • Linked (user vault) or Find by name (user vault): a credential entry of the user vault, selected or found by name. Offered when the workspace supports the user vault; Linked (user vault) is offered for entries of the user vault.

Elevation settings

Shown for SSH terminal entries. These settings control the Elevate shell command of the terminal, which elevates the session with the alternate credentials.

SETTING
DESCRIPTION

Elevation mode

Defines whether the Elevate shell command is offered in the session: Automatic (offered) or Manual (not offered). The default value is Automatic.

Elevation tool

Command used to elevate the shell: Sudo, None or su. The default value is Sudo. With None, the Elevate shell command is not offered.

Last updated

Was this helpful?