Jump Items: Mass Import Jump Shortcuts and Manage Jump Item Settings

Jump > Jump Items

Jump Shortcuts Mass Import Wizard

Through a Jumpoint, Jump shortcuts can be created to start a standard access session, to start a Remote Desktop Protocol session with a Windows system, to Jump to a website on a remote browser, to Shell Jump to an SSH-enabled or Telnet-enabled network device, to connect to a VNC server, or to make a TCP connection through a Protocol Tunnel Jump.

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 access console.

Download Template

From the dropdown in the Jump Shortcuts Mass Import Wizard section of the /login interface, 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. If any required fields are missing, import fails. Optional fields can be filled in or left blank.

Import Jump Shortcuts

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

Local Jump Shortcut

Field Description
Jump Group

The code name of the Jump Group with which this Jump Item should be associated.

Note: 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

You can add comments to your Jump Items. This string has a maximum of 1024 characters.

Jump Policy

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.

Name

The name of the endpoint to be accessed by this Jump Item. This name identifies the item in the session tabs. This string has a maximum of 128 characters.

Hostname

The hostname of the endpoint to be accessed by this Jump Item. This string has a maximum of 128 characters.

Endpoint Agreement Policy (optional)

The value accept automatically accepts the endpoint agreement if it times out and allows the session the start. The value reject automatically rejects the endpoint agreement and stops the session from starting. The value no_prompt does not show an endpoint agreement even if the feature is configured. This field has no effect if the global endpoint agreement is not enabled. For more information about the global setting, please see Jump Items: Mass Import Jump Shortcuts and Manage Jump Item Settings.

Name

The name of the endpoint to be accessed by this Jump Item. This name identifies the item in the session tabs. This string has a maximum of 128 characters.

Remote Jump Shortcut

Field Description
Jump Group

The code name of the Jump Group with which this Jump Item should be associated.

Note: 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.

Name

The name of the endpoint to be accessed by this Jump Item. This name identifies the item in the session tabs. This string has a maximum of 128 characters.

Hostname

The hostname of the endpoint to be accessed by this Jump Item. This string has a maximum of 128 characters.

Jumpoint

The code name of the Jumpoint through which the endpoint is accessed.

Endpoint Agreement Policy (optional)

The value accept automatically accepts the endpoint agreement if it times out and allows the session the start. The value reject automatically rejects the endpoint agreement and stops the session from starting. The value no_prompt does not show an endpoint agreement even if the feature is configured. This field has no effect if the global endpoint agreement is not enabled. For more information about the global setting, please see Jump Items: Mass Import Jump Shortcuts and Manage Jump Item Settings.

Remote VNC Jump Shortcut

Field Description
Jump Group

The code name of the Jump Group with which this Jump Item should be associated.

Note: 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.

Name

The name of the endpoint to be accessed by this Jump Item. This name identifies the item in the session tabs. This string has a maximum of 128 characters.

Hostname

The hostname of the endpoint to be accessed by this Jump Item. This string has a maximum of 128 characters.

Jumpoint

The code name of the Jumpoint through which the endpoint is accessed.

Port (optional)

A valid port number from 100 to 65535. Defaults to 5900.

Remote RDP Jump Shortcut

Field Description
Jump Group

The code name of the Jump Group with which this Jump Item should be associated.

Note: 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.

Name

The name of the endpoint to be accessed by this Jump Item. This name identifies the item in the session tabs. This string has a maximum of 128 characters.

Hostname

The hostname of the endpoint to be accessed by this Jump Item. This string has a maximum of 128 characters.

Jumpoint

The 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.

Display Size (optional)

The resolution at which to view the remote system. Can be primary (default - the size of your primary monitor), all (the size of all of your monitors combined), or XxY (where X and Y are a supported width and height combination - e.g., 640x480).

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

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.

SecureApp Type The SecureApp launch method. Can be "none", "remote_app" (to use RDP's built-in RemoteApp functionality), "remote_desktop_agent" (to use Bomgar's Remote Desktop Agent), or "remote_desktop_agent_credentials" (to use Bomgar's Remote Desktop Agent with Credential Injection). If "remote_desktop_agent" or "remote_desktop_agent_credentials" are chosen then the Bomgar Remote Desktop Agent must be installed on the remote system.>
Remote Executable Path The path to the remote executable that will be launched using the Bomgar Remote Desktop Agent. This can only be used if the SecureApp Type uses the Bomgar Remote Desktop Agent.
Remote Executable Parameters A space-separated list of parameters to pass to the remote executable that will be launched using the Bomgar Remote Desktop Agent. Parameters with spaces can be quoted using double-quotes. This can only be used if the SecureApp Type uses the Bomgar Remote Desktop Agent.
Credential Type The type of credentials that will be injected into the remote executable. This value will depend on the password vault from which credentials are retrieved. This value can only be used if the SecureApp Type uses the Bomgar Remote Desktop Agent with Credential injection.
Target System The type of credentials that will be injected into the remote executable. This value will depend on the password vault from which credentials are retrieved. This value can only be used if the SecureApp Type uses the Bomgar Remote Desktop Agent with Credential injection.
Remote App Name (optional) The RemoteApp program name. This string has a maximum of 520 characters.
Remote App Parameters (optional) A space-separated list of parameters to pass to the RemoteApp. Parameters with spaces can be quoted using double-quotes. This string has a maximum of 16000 characters.

Shell Jump Shortcut

Field Description
Jump Group

The code name of the Jump Group with which this Jump Item should be associated.

Note: 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.

Name

The name of the endpoint to be accessed by this Jump Item. This name identifies the item in the session tabs. This string has a maximum of 128 characters.

Hostname

The hostname of the endpoint to be accessed by this Jump Item. This string has a maximum of 128 characters.

Jumpoint

The code name of the Jumpoint through which the endpoint is accessed.

Username (optional)

The username to sign in as.

Protocol

Can 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).

Protocol Tunnel Jump Shortcut

Field Description
Jump Group

The code name of the Jump Group with which this Jump Item should be associated.

Note: 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.

Name

The name of the endpoint to be accessed by this Jump Item. This name identifies the item in the session tabs. This string has a maximum of 128 characters.

Hostname

The hostname of the endpoint to be accessed by this Jump Item. This string has a maximum of 128 characters.

Jumpoint

The code name of the Jumpoint through which the endpoint is accessed.

TCP Tunnels

The list of one or more tunnel definitions. A tunnel definition is a mapping of a TCP port on the local user's system to a TCP port on the remote endpoint. Any connection made to the local port causes a connection to be made to the remote port, allowing data to be tunnelled between local and remote systems. Multiple mappings should be separated by a semicolon.

Example: auto->22;3306->3306

In the example above, a randomly assigned local port maps to remote port 22, and local port 3306 maps to remote port 3306.

Local Address (optional)

The address from which the connection should be made. This can be any address within the 127.x.x.x subrange. The default address is 127.0.0.1.

Web Jump Shortcut

Field Description
Jump Group

The code name of the Jump Group with which this Jump Item should be associated.

Note: 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.

Jumpoint

The code name of the Jumpoint through which the endpoint is accessed.

Name

The name of the endpoint to be accessed by this Jump Item. This name identifies the item in the session tabs. This string has a maximum of 128 characters.

URL

The URL of the website. The URL must begin with either http or https.

Verify Certificate (optional)

1: The site certificate is validated before the session starts; if issues are found, the session will not start.
0: The site certificate is not validated.

Endpoint User Agreement

Enable Endpoint User Consent Configuration for Applicable Jump Items

Enable a dropdown in the access console which allows endpoint user agreement options to be configured for individual Jump Items.

Title

Customize the title of the agreement. The end-user sees this in the title bar of the prompt. You can localize this text for any languages you have enabled. To revert to the default text, delete the text from the field and then save the blank field.

Text

Provide the text for the agreement. You can localize this text for any languages you have enabled. To revert to the default text, delete the text from the field and then save the blank field.

Acceptance Timeout

If the user does not accept the agreement within the set Acceptance Timeout, the agreement is either accepted or rejected as determined by the Jump Item properties.

Jump Item Settings

Simultaneous Jumps for Jump Client, Local Jump, Remote Jump, Remote VNC, and Shell Jump

Set Simultaneous Jumps 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.

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.

This setting applies to the following Jump Item types: Jump Client, Local Jump, Remote Jump, Remote VNC, and Shell Jump.

Simultaneous Jumps for Remote RDP

Set Simultaneous Jumps 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 Remote 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.

This setting applies to Remote RDP Jump Item types only.