Users & security

What is the Users page?

The Users page allows administrators to manage individual user accounts, including creating, editing, and deleting accounts. It provides detailed control over user-specific settings, permissions, and roles within the Privileged Remote Access environment.

How is the Users page useful to my organization?

The Users page enables administrators to customize access and permissions for each user, ensuring security and proper role alignment. It also allows for efficient user management, helping to maintain compliance and support operational needs.

How do I access the Users page?

1. Use a Chromium-based browser to sign in to your Privileged Remote Access URL.
   This URL is provided in the BeyondTrust welcome email and includes your site URL followed by /login.
2. From the left menu, click Users & Security.
   The Users page opens and displays by default.

User accounts

View information about all users who have access to your B Series Appliance, including local users and those who have access through security provider integration.

Add user, edit, delete

Create a new account, modify an existing account, or remove an existing account. You cannot delete your own account.

Search users

Search for a specific user account based on username, display name, or email address.

Security provider

Select a security provider type from the dropdown to filter the list of users by security provider.

Synchronize

Synchronize the users and groups associated with an external security provider. Synchronization occurs automatically once a day. Clicking this button forces a manual synchronization.

Reset failed login attempts and unlock account

If a user has one or more failed login attempts, click the Reset button for their user account to reset the number back to zero.

If a user becomes locked due to too many failed consecutive login attempts, click the Unlock Account button for their user account to reset the number back to zero and unlock their account.

Add or edit user

Username

Unique identifier used to log in.

Display name

User's name as shown in team chats, in reports, etc.

Email address

Set the email address to where email notifications are sent, such as password resets or extended availability mode alerts.

Password

Password used with the username to log in. The password may be set to whatever you choose, as long as the string complies with the defined policy set on the /login > Management > Security page.

Email password reset link to user

When checked, admins can send a password reset link to a user.

Must reset password at next login

If this option is selected, then the user must reset their password at next login.

Password never expires

Check this box to set the user's password to never expire.

Password expiration date

Set a date for the password to expire.

Memberships

Group policy memberships

Listing of the group policies to which the user belongs.

This section allows you to search or select from a dropdown of Available Group Policies, and Add the policy to the user. Policies selected for the user display in a list which can be filtered.

The user can be removed from one or more group policies by selecting the policy or policies and clicking Remove. The default policy cannot be selected.

Unsaved changes to the list are identified as Addition or Removal. Changes can be undone by selecting the policy or policies and clicking Undo.

If the user is a member of multiple group policies, the priority of the policies can be modified by selecting one or more policies and clicking Priority, at the upper right of the list.

Group policies selected for a user can be edited by clicking the name of the policy in the list.

ℹ️

Note

Other memberships do not display while a new user is being created. Once the new user has been saved, the other memberships appear, listing any to which the user may have been added, with links for updating these memberships and for reviewing or editing details about the memberships.

Team memberships

Listing of the teams to which the user belongs.

Jumpoint memberships

Listing of the Jumpoints which the user can access.

Jump Group memberships

Listing of the Jump Groups to which the user belongs.

Vault account group memberships

Listing of the Vault Account Groups to which the user belongs.

Account settings

Two Factor Authentication

Two factor authentication (2FA) uses an authenticator app to provide a time-based, one-time code to login to the administrative interface, as well as the access console. If Required is selected, the user is prompted to enroll and begin using 2FA at the next login. If Optional is selected, the user has the option to use 2FA, but it is not required.

Account Expiration

When the Account Expiration is selected, the Account Never Expires checkbox appears. When the setting is not selected, an account expiration date must be set which causes the account to expire after a set date.

Account Enablement

When the Account Enablement is selected, the Account Disabled appears. The Account Disabled allows you to disable the account so the user cannot log in.

ℹ️

When you disable the account, it does not delete the account.

Comments

Add a comment to help identify the purpose of this object.

General permissions

Administration

Administrative privileges

Grants the user full administrative rights.

Vault Administrative Privileges

When you select Vault Administrative Privileges, the Allowed to Administer Vault checkbox appears. This setting enables the user access to the Vault.

Endpoint Automation Administrative Privileges

When you select Endpoint Automation Administrative Privileges, the Allowed to Administer Endpoint Automation checkbox appears. This setting enables the user access to Endpoint Automation.

Password Setting

When you select Password Setting, the Allowed to Set Passwords checkbox appears. This setting enables the user to set passwords and unlock accounts for non-administrative local users.

Jumpoint Editing

When you select Jumpoint Editing, the Allowed to Edit Jumpoints checkbox apperas. This setting enables the user to create or edit Jumpoints. This setting does not affect the user's ability to access remote computers via Jumpoint, which is configured per Jumpoint or group policy.

Team Editing

When you select Team Editing, the Allowed to Edit Teams checkbox appears. This setting nables the user to create or edit teams.

Jump Group Editing

When you select Jump Group Editing, the Allowed to Edit Jump Groups checkbox appears. This setting enables the user to create or edit Jump Groups.

Canned Script Editing

When you select Canned Script Editing, the Allowed to Edit Canned Scripts checkbox appears. This setting enables the user to create or edit canned scripts for use in screen sharing or command shell sessions.

Custom Link Editing

When you select Custom Link Editing, the Allowed to Edit Custom Links checkbox appears. This setting enables the user to create or edit custom links.

Reporting

Session and Team Report Access

When you select Session and Team Report Access, the Allowed to View Access Session Reports section appears. The Allowed to view access session recordings checkbox appears and enables the user to view video recordings of screen sharing sessions and command shell sessions.

Vault Report Access

When you select Vault Report Access, the Allowed to View Vault Reports section appears. This setting enables the user to view his or her own vault events or all Vault events.

Syslog Report Access

When you select Syslog Report Access, the Allowed to View Syslog Reports checkbox appears. This setting enables the user to download a ZIP file containing all syslog files available on the appliance. Admins are automatically permissioned to access this report. Non-admin users must request access to view this report.

Access permissions

Access Permissions

When you select Access Permissions, the Allowed to access endpoints checkbox appears. When you select the Allowed to access endpoints, the Session Management settings display. This setting enables the user to use the access console in order to run sessions. If endpoint access is enabled, options pertaining to endpoint access are also available.

Session management

Allowed to share sessions with teams which they do not belong to

Enables the user to invite a less limited set of user to share sessions, not only their team members. Combined with the extended availability permission, this permission expands session sharing capabilities.

Allowed to invite external users

Enables the user to invite third-party users to participate in a session, one time only.

Allowed to enable extended availability mode

Enables the user to receive email invitations from other users requesting to share a session even when they are not logged into the access console.

Allowed to edit the external key

Enables the user to modify the external key from the session info pane of a session within the access console.

Remove User from session after inactivity

Sets the time to remove a user from an inactive session.

User to user screen sharing

Allowed to show screen to other users

Enables the user to share their screen with another user without the receiving user having to join a session. This option is available even if the user is not in a session.

Allowed to give control when showing screen to other users

Enables the user sharing their screen to give keyboard and mouse control to the user viewing their screen.

Jump Technology

Allowed Jump Item Methods

Enables the user to Jump to computers using the following:

• Jump Clients
• Local Jump on the local network
• Remote RDP (via a Jumpoint)
• Shell Jump (via a Jumpoint)
• Protocol Tunnel Jump (via a Jumpoint)
• Remote Jump (via a Jumpoint)
• Remote VNC (via a Jumpoint)

Jump Item Roles

A Jump Item Role is a predefined set of permissions regarding Jump Item management and usage.

The Default role is used only when Use User's Default is set for that user in a Jump Group.

The Personal role applies only to Jump Items pinned to the user's personal list of Jump Items.

The Teams role applies to Jump Items pinned to the personal list of Jump Items of a team member of a lower role. For example, a team manager can view team leads' and team members' personal Jump Items, and a team lead can view team members' personal Jump Items.

The System role applies to all other Jump Items in the system. For most users, this should be set to No Access. If set to any other option, the user is added to Jump Groups to which they would not normally be assigned, and in the access console, they can see non-team members' personal lists of Jump Items.

ℹ️

Note

A new Jump Item Role called Auditor is automatically created on new site installations. On existing installations it has to be created. This role only has a single View Reports permission enabled, giving admins the option to grant a user just the permission to run Jump Item reports, without the need to grant any other permission.

Session permissions

Session policy

Set the prompting and permission rules that should apply to this user's sessions. Choose an existing session policy or define custom permissions for this user. If Not Defined is set, the global default policy is used. These permissions may be overridden by a higher policy.

Description

View the description of a pre-defined session permission policy.

Screen sharing

Screen sharing rules

Select the representative's and remote user's access to the remote system:

• If Not Defined is set, this setting is set by the next lower priority policy. This setting may be overridden by a higher priority policy.
• Deny: This setting disables screen sharing.
• View Only: This setting allows the representative to view the screen.
• View and Control: This setting allows the representative to view and take action on the system. If this is selected, Allow Endpoint Restrictions appears and can be set to avoid interference by the remote user:
  • None: This setting does not set any restrictions on the remote system.
  • Display, Mouse, and Keyboard: This setting disables these inputs. If this is selected, the Automatically request a privacy screen on session start check box appears. This setting ensures a privacy screen is applicable only for sessions started from a Jump Client, a Remote Jump Item, or a Local Jump Item. It is recommended to use privacy screen for unattended sessions. The remote system must support privacy screen.

Clipboard Synchronization Direction

This setting selects how clipboard content flows between users and endpoints. The settings are the following:

• Not allowed: The user is not allowed to use the clipboard, no clipboard icons display in the access console, and cut and paste commands do not work.
• Allowed from User to Endpoint: The user can push clipboard content to the endpoint but cannot paste from the endpoint's clipboard. Only the Send clipboard icon displays in the access console.
• Allowed in Both Directions: Clipboard content can flow both ways. Both Push and Get clipboard icons display in the access console.

Application Sharing Restrictions

This option limits access to specified applications on the remote system with either. There are three values:

• None
• Allow only the listed executables: Allows you to specify executables to allow as appropriate to your objectives.
• Deny only the listed executables: Allows you to specify executables to deny as appropriate to your objectives.

You may also choose to allow or deny desktop access.

ℹ️

Note

• This feature applies only to Windows operating systems.
• The Add New Executable button only displays when the Application Share Restriction permission is enabled.

Add new executables

When you add executables, you have one of two choices:

• Enter file names or SHA-256 hashes, one per line: Manually enter the executable file names or hashes you wish to allow or deny. Click Add Executable(s) when you are finished to add the chosen files to your configuration.
  You may enter up to 25 files per dialog. If you need to add more, click Add Executable(s) and then reopen the dialog.
• Browse for one or more files: Choose executable files to automatically derive their names or hashes. If you select files from your local platform and system in this manner, use caution to ensure that the files are indeed executable files. No browser level verification is performed.
  • Choose either Use file name or Use file hash (advanced) to have the browser derive the executable file names or hashes automatically.
    Click Add Executable(s) when you are finished to add the chosen files to your configuration. You may enter up to 25 files per dialog. If you need to add more, click Add Executable(s) and then reopen the dialog.

ℹ️

Note

This option is available only in modern browsers, not in legacy browsers.

Allowed endpoint restrictions

Sets the option for the user to suspend the remote system's mouse and keyboard input. The user may also prevent the remote desktop from being displayed.

Annotations

Annotation rules

Enables the user to use annotation tools to draw on the remote system's screen. If Not Defined is enabled, this option is set by the next lower priority policy. This setting may be overridden by a higher priority policy.

File transfer

File Transfer Rules

Enables the user to upload files to the remote system, download files from the remote system, or both. If Not Defined is enabled, this option is set by the next lower priority policy. This setting may be overridden by a higher priority policy.

Accessible paths on the endpoint's filesystem

Allow the user to transfer files to or from any directories on the remote system or only specified directories.

Accessible paths on user's filesystem

Allow the user to transfer files to or from any directories on their local system or only specified directories.

Command shell

Shell Rules

Enables the user to issue commands on the remote computer through a virtual command line interface. If Not Defined is enabled, this option is set by the next lower priority policy. This setting may be overridden by a higher priority policy. Configure command filtering to prevent accidental use of commands that can be harmful to endpoint systems.

ℹ️

Note

Command shell access cannot be restricted for Shell Jump sessions.

Allowed Executable Command Patterns

Enables the user to search for a regex pattern that matches a shell prompt. For filtering to work, the Recognized Shell Prompts section on the Jump > Jump Item page must be set and only filter commands in a Shell Jump session.

System information

System Information Rules

Enables the user to see system information about the remote computer. If Not Defined is enabled, this option is set by the next lower priority policy. This setting may be overridden by a higher priority policy. You also have the option to set system information actions.

• Allowed to use system information actions: Enables the user to interact with processes and programs on the remote system without requiring screen sharing. Kill processes; start, stop, pause, resume, and restart services; and uninstall programs.

Registry access

Registry Access Rules

Enables the user to interact with the registry on a remote Windows system without requiring screen sharing. You have the ability to do the following actions:

• View, add, delete and edit keys
• Search and import/export keys

Canned scripts

Canned Script Rules

Enables the user to run canned scripts that have been created for their teams. If Not Defined is enabled, this option is set by the next lower priority policy. This setting may be overridden by a higher priority policy.

Session Termination Behavior

When the access session ends, automatically

Controls what action to happen when session ends. The following options are:

• Not Defined
• Do Nothing
• Lock the computer
• Logout the user (Only works on Windows hosts).

Allow users to override this setting per session

You can allow a user to override the session termination setting from the Summary tab in the console during a session.

Availability settings

Login schedule

Restrict user login to the following schedule

Set a schedule to define when users can log into the access console. Set the time zone you want to use for this schedule, and then add one or more schedule entries. For each entry, click Add Schedule Entry to set the start day and time and the end day and time.

If, for instance, the time is set to start at 8 am and end at 5 pm, a user can log in at any time during this window but may continue to work past the set end time. They are not, however, allowed to log back in after 5 pm.

Force logout when the schedule does not permit login

If stricter access control is required, check this option. This forces the user to log out at the scheduled end time. In this case, the user receives recurring notifications beginning 15 minutes prior to being disconnected. When the user is logged out, any owned sessions follow the session fallback rules.

User account report

Export detailed information about your users for auditing purposes. Gather detailed information for all users, users from a specific security provider, or just local users. Information collected includes data displayed under the "show details" button, plus group policy and team memberships and permissions, and passwordless authentication registration and last usage.