DocumentationAPI ReferenceRelease Notes
Documentation

Options | PRA Pathfinder

What are Options?

Options are settings that configure how Assets behave.

How are Options useful to my organization?

Options enhance security and consistency by letting administrators configure how Assets behave once, site-wide, instead of setting the same behavior on each Asset individually.

How do I access the Options page?

  1. Sign into app.beyondtrust.io.
    The BeyondTrust Home page displays.
  2. From the left menu, click Privileged Remote Access > Asset Management.
    The Asset Management page opens and the Assets tab displays by default.
  3. Click the Options tab.
    The Options page displays.

The Options page

An image of the Asset Options page.
  1. Left menu: Easy access to all pages in Privilege Remote Access, including Status, Consoles & Downloads, My Account, Configuration, Asset Management, Vault, Console Settings, Users & Security, Reports, Management, and Appliance pages.
  2. Status: Opens the Status page.
  3. Header: Change your tenant site, manage your profile, and access documentation.
  1. Endpoint User Agreement: The endpoint agreement prompts the end user to allow the Asset to run.
  2. Asset settings: Set Asset settings.
  3. Shell Filtering: Restricts which commands can be executed

Endpoint User Agreement

The endpoint agreement prompts the end user to allow the Asset to run. To enable the endpoint agreement:

  1. Certain fields in the Email Notification template and Email Approval template are capable of storing content in multiple languages. Click Select a language to edit from the dropdown to edit in that language.
  2. Click the Enable Endpoint User Consent Configuration for Applicable Assets checkbox.
  3. Add a Title and Text.
  4. Add a Timeout value. The default value is 60 seconds.
  5. Be sure to Save each change.
An image of the Endpoint User Agreement configuration screen. The screen includes options to enable Endpoint User Consent Configuration for Applicable Assets, input fields for Title and Text, and an Acceptance Timeout setting with a default value of 60 seconds
ℹ️

The Endpoint Agreement only applies to Jump Clients, Remote Assets, and Local Assets.

Asset settings

Simultanous connections

Simultanous connections provide a way for multiple users to gain access to the same Asset without having to be invited to join an active support session by another user.

  1. By using the For Jump Client, Local Jump, Remote Jump, Remote VNC field, you can create new sessions. The options you can choose are the following:
Value NameDescription
Join Existing Session

Provides a way for multiple users to gain access to the same Asset without an invitation to join an active session by another user. The first user to access the Asset maintains ownership of the session. Users in a shared session see each other and can chat. Users can join a session that was started from another copy of a Jump Client in a different Asset Group. Session permissions are based on the original Jump Client that started the session.

Once the first user is in a session, subsequent users will be able to enter the session. The first user will receive a notification that another user has joined the session, but the first user will not have an opportunity to deny access before other user joins.

If this setting is not selected, a user cannot join a session that was started from another copy of a Jump Client, unless it is the same Asset Group.

DisableEnsures only one user can connect to an Asset at a time. Only an invitation by the user who originated the session can allow for a second user to access the session.
  1. From the For Remote RDP field, you can create new sessions which connect to a specific RDP Asset. The options you can choose are the following:
Value NameDescription
Start a New SessionProvides a way for multiple users to gain access to the same Asset without an invitation to join an active session by another user. For RDP, a new independent session will start for each user which connects to a specific RDP Asset, and the RDP configuration on the endpoint will control any further behavior regarding simultaneous RDP connections.
DisableEnsures only one user at a time can connect to an Asset. Only an invitation by the user who originated the session can allow for a second user to access the session.
  1. From the External Tools section, select the appropriate checkboxes to use external tools (that is, bring your own tools (BYOT)) with a Remote RDP or Shell sessions. If selected, this enables a user to run the local RDP client vs the one embedded in the Access console.
An image of the Asset Settings configuration page. The settings include options for Simultanous connections, and specific configurations for Jump Client, Local Jump, Remote Jump, and Remote VNC (set to "Disallow Jump"), as well as Remote RDP (set to "Start New Session"). The page also includes External Tools settings with checkboxes for allowing users to open Remote RDP Assets and Shell Sessions using an external tool.

Shell Filtering

The Shell feature restricts which commands can be executed. It works in conjunction with the values that are configured for an individual on the Command Shell section of the Users & Security > Users page. For groups of users, you can set up session policies on the Users & Security > Session Policies page.

Shell Prompt Matching Validation

A part of the Shell feature is being able to tell when your shell is at a prompt, so regex pattern is used that matches a shell prompt, and a default one that works almost anywhere is given.

Shell Filtering interface with two sections. The first section, labeled "Recognized Shell Prompts," has a text box containing the regular expression .*[>#%\$] and a "Save" button. The second section, labeled "Shell Prompt Matching Validation," has an empty text box and a "Check" button.

©2003-2026 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.