DocumentationRelease Notes
Log In
Documentation

Jump Items

What are Jump Items?

Jump Items are individual systems or devices that are made available for remote access within a Jump Group, enabling administrators to organize and control access to remote systems in a secure manner.

How are Jump Items useful to my organization?

Jump Items allow support representatives to securely access and troubleshoot remote systems, ensuring efficient issue resolution while maintaining control over which systems can be accessed and when.

How do I access the Jump Items page?

  1. Use a Chromium-based browser to sign in to your Remote Support URL.
    This URL is provided in the BeyondTrust welcome email and includes your site URL followed by /login.
  2. From the left menu, click Jump.
    The Jump Clients page opens and displays by default.
  3. At the top of the page, click Jump Items.
    The Jump Items page displays.

Jump shortcuts mass import wizard

Create Jump Shortcuts to start standard support sessions, to start Remote Desktop Protocol sessions or VNC sessions, to Shell Jump to SSH-enabled or Telnet-enabled network devices, or to start Intel® vPro sessions.

ℹ️

Note

Linux Jumpoints can only be used for RDP, SSH/Telnet, and VNC sessions, allowing for credential injection from user or Vault, as well as RemoteApp functionality and Shell Jump filtering. Clustered Jumpoints can only add new nodes of the same OS. You cannot mix Windows and Linux nodes.

When creating a large number of Jump shortcuts, it may be easier to import them via a spreadsheet than to add them one by one in the representative console.

ℹ️

Note

For more information, see Use Jump shortcuts.

Download a template suitable for importing Jump Shortcuts

From the dropdown in the Jump Shortcuts Mass Import Wizard section, select the type of Jump Item you wish to add, and then click Download Template. Using the text in the CSV template as column headers, add the information for each Jump shortcut you wish to import. Optional fields can be filled in or left blank.

Upload Jump Shortcuts mass import template

Once you have completed filling out the template, click Import Jump Shortcuts to upload the CSV file containing the Jump Item information. The CSV file should use the format described in the tables below. The maximum file sized allowed to be uploaded at one time is 5 MB. Only one type of Jump Item can be included in each CSV file.

Local Jump Shortcut help

ParameterDescription
HostnameThe hostname of the endpoint to be accessed by this Jump Item. This string has a maximum of 128 characters.
NameEnter a Name for the Jump Item. This name identifies the item in the session tabs. This string has a maximum of 128 characters.
Jump GroupThe code name of the Jump Group with which this Jump Item should be associated.
When using the import method, a Jump Item cannot be associated with a personal list of Jump Items.
Tag (optional)You can organize your Jump Items into categories by adding a tag. This string has a maximum of 1024 characters.
Comments (optional)You can add comments to your Jump Items. This string has a maximum of 1024 characters.
Jump Policy (optional)The code name of a Jump Policy. You can specify a Jump Policy to manage access to this Jump Item.
Public Portal (optional)The public portal through which this Jump Item should connect.
Customer Present Session Policy (optional)The code name of a session policy. You can specify a session policy to manage the permissions available on this Jump Item when a customer is present.
Customer Not Present Session Policy (optional)The code name of a session policy. You can specify a session policy to manage the permissions available on this Jump Item when a customer is not present.

Remote Jump Shortcut help

ParameterDescription
HostnameThe hostname of the endpoint to be accessed by this Jump Item. This string has a maximum of 128 characters.
JumpointThe code name of the Jumpoint through which the endpoint is accessed.
NameEnter a Name for the Jump Item. This name identifies the item in the session tabs. This string has a maximum of 128 characters.
Jump GroupThe code name of the Jump Group with which this Jump Item should be associated.
When using the import method, a Jump Item cannot be associated with a personal list of Jump Items.
Tag (optional)You can organize your Jump Items into categories by adding a tag. This string has a maximum of 1024 characters.
Comments (optional)You can add comments to your Jump Items. This string has a maximum of 1024 characters.
Jump Policy (optional)The code name of a Jump Policy. You can specify a Jump Policy to manage access to this Jump Item.
Public Portal (optional)The public portal through which this Jump Item should connect.
Customer Present Session Policy (optional)The code name of a session policy. You can specify a session policy to manage the permissions available on this Jump Item when a customer is present.
Customer Not Present Session Policy (optional)The code name of a session policy. You can specify a session policy to manage the permissions available on this Jump Item when a customer is not present.

Local VNC Jump Shortcut help

ParameterDescription
HostnameThe hostname of the endpoint to be accessed by this Jump Item. This string has a maximum of 128 characters.
Port (optional)A valid port number from 100 to 65535. Defaults to 5900.
NameEnter a Name for the Jump Item. This name identifies the item in the session tabs. This string has a maximum of 128 characters.
Jump GroupThe code name of the Jump Group with which this Jump Item should be associated.
When using the import method, a Jump Item cannot be associated with a personal list of Jump Items.
Tag (optional)You can organize your Jump Items into categories by adding a tag. This string has a maximum of 1024 characters.
Comments (optional)You can add comments to your Jump Items. This string has a maximum of 1024 characters.
Jump Policy (optional)The code name of a Jump Policy. You can specify a Jump Policy to manage access to this Jump Item.
Public Portal (optional)The public portal through which this Jump Item should connect.
Session Policy (optional)The code name of a session policy. You can specify a session policy to manage the permissions available on this Jump Item.

Remote VNC Jump Shortcut help

ParameterDescription
HostnameThe hostname of the endpoint to be accessed by this Jump Item. This string has a maximum of 128 characters.
JumpointThe code name of the Jumpoint through which the endpoint is accessed.
Port (optional)A valid port number from 100 to 65535. Defaults to 5900.
NameEnter a Name for the Jump Item. This name identifies the item in the session tabs. This string has a maximum of 128 characters.
Jump GroupThe code name of the Jump Group with which this Jump Item should be associated.
When using the import method, a Jump Item cannot be associated with a personal list of Jump Items.
Tag (optional)You can organize your Jump Items into categories by adding a tag. This string has a maximum of 1024 characters.
Comments (optional)You can add comments to your Jump Items. This string has a maximum of 1024 characters.
Jump Policy (optional)The code name of a Jump Policy. You can specify a Jump Policy to manage access to this Jump Item.
Public Portal (optional)The public portal through which this Jump Item should connect.
Session Policy (optional)The code name of a session policy. You can specify a session policy to manage the permissions available on this Jump Item.

Remote RDP Jump Shortcut help

ParameterDescription
HostnameThe hostname of the endpoint to be accessed by this Jump Item. This string has a maximum of 128 characters.
JumpointThe code name of the Jumpoint through which the endpoint is accessed.
Username (optional)The username to sign in as.
Domain (optional)The domain the endpoint is on.
Quality (optional)The quality at which to view the remote system. Can be low (2-bit gray scale for the lowest bandwidth consumption), best_perf (default - 8-bit color for fast performance), perf_and_qual (16-bit for medium quality image and performance), best_qual (32-bit for the highest image resolution), or video_opt (VP9 codec for more fluid video). This cannot be changed during the remote desktop protocol (RDP) session.
Console Session (optional)1: Starts a console session.
0: Starts a new session (default).
Ignore Untrusted Certificate (optional)1: Ignores certificate warnings.
0: Shows a warning if the server's certificate cannot be verified.
NameEnter a Name for the Jump Item. This name identifies the item in the session tabs. This string has a maximum of 128 characters.
Jump GroupThe code name of the Jump Group with which this Jump Item should be associated.
When using the import method, a Jump Item cannot be associated with a personal list of Jump Items.
Tag (optional)You can organize your Jump Items into categories by adding a tag. This string has a maximum of 1024 characters.
Comments (optional)You can add comments to your Jump Items. This string has a maximum of 1024 characters.
Jump Policy (optional)The code name of a Jump Policy. You can specify a Jump Policy to manage access to this Jump Item.
Public Portal (optional)The public portal through which this Jump Item should connect.
Session Policy (optional)The code name of a session policy. You can specify a session policy to manage the permissions available on this Jump Item.

Local RDP Jump Shortcut help

ParameterDescription
HostnameThe hostname of the endpoint to be accessed by this Jump Item. This string has a maximum of 128 characters.
Username (optional)The username to sign in as.
Domain (optional)The domain the endpoint is on.
Quality (optional)The quality at which to view the remote system. Can be low (2-bit gray scale for the lowest bandwidth consumption), best_perf (default - 8-bit color for fast performance), perf_and_qual (16-bit for medium quality image and performance), best_qual (32-bit for the highest image resolution), or video_opt (VP9 codec for more fluid video). This cannot be changed during the remote desktop protocol (RDP) session.
Console Session (optional)1: Starts a console session.
0: Starts a new session (default).
Ignore Untrusted Certificate (optional)1: Ignores certificate warnings.
0: Shows a warning if the server's certificate cannot be verified.
NameEnter a Name for the Jump Item. This name identifies the item in the session tabs. This string has a maximum of 128 characters.
Jump GroupThe code name of the Jump Group with which this Jump Item should be associated.
When using the import method, a Jump Item cannot be associated with a personal list of Jump Items.
Tag (optional)You can organize your Jump Items into categories by adding a tag. This string has a maximum of 1024 characters.
Comments (optional)You can add comments to your Jump Items. This string has a maximum of 1024 characters.
Jump Policy (optional)The code name of a Jump Policy. You can specify a Jump Policy to manage access to this Jump Item.
Public Portal (optional)The public portal through which this Jump Item should connect.
Session Policy (optional)The code name of a session policy. You can specify a session policy to manage the permissions available on this Jump Item.

Shell Jump Shortcut help

ParameterDescription
HostnameThe hostname of the endpoint to be accessed by this Jump Item. This string has a maximum of 128 characters.
JumpointThe code name of the Jumpoint through which the endpoint is accessed.
Username (optional)The username to sign in as.
ProtocolCan be either ssh or telnet.
Port (optional)A valid port number from 1 to 65535. Defaults to 22 if the protocol is ssh or 23 if the protocol is telnet.
Terminal Type (optional)Can be either xterm (default) or VT100.
Keep-Alive (optional)The number of seconds between each packet sent to keep an idle session from ending. Can be any number from 0 to 300. 0 disables keep-alive (default).
NameEnter a Name for the Jump Item. This name identifies the item in the session tabs. This string has a maximum of 128 characters.
Jump GroupThe code name of the Jump Group with which this Jump Item should be associated.
When using the import method, a Jump Item cannot be associated with a personal list of Jump Items.
Tag (optional)You can organize your Jump Items into categories by adding a tag. This string has a maximum of 1024 characters.
Comments (optional)You can add comments to your Jump Items. This string has a maximum of 1024 characters.
Jump Policy (optional)The code name of a Jump Policy. You can specify a Jump Policy to manage access to this Jump Item.
Session Policy (optional)The code name of a session policy. You can specify a session policy to manage the permissions available on this Jump Item.
Public Portal (optional)The public portal through which this Jump Item should connect.

Intel vPro Shortcut help

ParameterDescription
HostnameThe hostname of the endpoint to be accessed by this Jump Item. This string has a maximum of 128 characters.
JumpointThe code name of the Jumpoint through which the endpoint is accessed.
NameEnter a Name for the Jump Item. This name identifies the item in the session tabs. This string has a maximum of 128 characters.
Jump GroupThe code name of the Jump Group with which this Jump Item should be associated.
When using the import method, a Jump Item cannot be associated with a personal list of Jump Items.
Tag (optional)You can organize your Jump Items into categories by adding a tag. This string has a maximum of 1024 characters.
Comments (optional)You can add comments to your Jump Items. This string has a maximum of 1024 characters.
Jump Policy (optional)The code name of a Jump Policy. You can specify a Jump Policy to manage access to this Jump Item.
Public Portal (optional)The public portal through which this Jump Item should connect.

ℹ️

Note

For more information, see Use Jump shortcuts.

Jump Item settings

Simultaneous Jumps

For Jump Client, Local Jump, Remote Jump, Local VNC, Remote VNC, Intel vPro

Set this option to Join Existing Session to provide a way for multiple users to gain access to the same Jump Item without an invitation to join an active session by another user. The first user to access the Jump Item maintains ownership of the session. Users in a shared Jump session see each other and can chat.

If Join Existing Session is selected, there is an option to apply the setting to copies of Jump Clients.

  • If checked, a user can join a session that was started from another copy of a Jump Client in a different Jump Group. Session permissions are based on the original Jump Client that started the session.
  • If not checked, a user cannot join a session that was started from another copy of a Jump Client, unless it is the same Jump Group.

Set this option to Disallow Jump to ensure only one user can Jump to a Jump Item at a time. Only an invitation by the user who originated the session can allow for a second user to access the session.

For Remote RDP, Local RDP

Set this option to Start New Session to provide a way for multiple users to gain access to the same Jump Item without an invitation to join an active session by another user. For RDP, multiple users may gain access to a Jump Item, but each starts an independent session.

Set this option to Disallow Jump to ensure only one user at a time can Jump to a Jump Item. Only an invitation by the user who originated the session can allow for a second user to access the session.


©2003-2025 BeyondTrust Corporation. All Rights Reserved. Other trademarks identified on this page are owned by their respective owners. BeyondTrust is not a chartered bank or trust company, or depository institution. It is not authorized to accept deposits or trust accounts and is not licensed or regulated by any state or federal banking authority.