DocumentationAPI ReferenceRelease Notes
Documentation

Privileged Remote Access - Getting Started

What is Privileged Remote Access? PRA icon

Privileged Remote Access (PRA) controls how people connect to your most important systems from somewhere else. It gives secure remote access to admins, IT staff, and outside vendors without a VPN.

PRA is part of the BeyondTrust Privileged Access Management (PAM) family and provides three main roles:

  • Access control: Only approved users can reach a system. They get only the level of access they need, and only when they need it.
  • Credential security: Vault stores your privileged passwords and keys. PRA can inject a credential into a session so the user never sees or types the password.
  • Session oversight: PRA records and logs sessions. You get a searchable audit trail, and you can watch a live session and end it if something looks wrong.
ℹ️

For more information, see Welcome to Privileged Remote Access.


🚧

New names for Jump terms

In version 26.1, many Jump terms were renamed to make them clearer. Jump Item is now Asset, and Jumpoint is now Gateway. The features work the same way. Jump Client kept its name. This article uses the new names, with the old name in parentheses the first time. For the full list of terms, see the Privileged Remote Access Glossary.

PRA capabilities and benefits

You can use PRA to do the following:

  • Secure Privileged Remote Access: Give administrators and IT teams secure remote access to servers, desktops, network devices, and databases without broad VPN access to the network.
  • Third-Party & Vendor Access: Provide vendors and external users with controlled, time-bound access only to required systems. Set expiration dates to automatically remove access when no longer needed.
  • Credential Security: Inject stored credentials directly into privileged sessions, allowing users to access systems without seeing or knowing the underlying passwords.
  • Privileged Credential Management: Discover, store, manage, and rotate privileged credentials in the built-in Vault, supporting up to 200,000 accounts.
  • Just-in-Time Access Controls: Require controls such as a ticket number, business justification, manager approval, or multi-factor authentication before granting privileged access.
  • Time-Based Access: Restrict privileged access to approved days and hours, preventing users and vendors from connecting outside authorized windows.
  • Session Control: Control privileged-session activities, including clipboard use, file transfers, screen sharing, and command execution.
  • Broad System & Protocol Support: Secure access to Windows, macOS, Linux, Android, and iOS systems, plus SSH and Telnet devices such as switches, routers, and other infrastructure.
  • Session Recording & Audit: Record privileged sessions and capture activity to audit who accessed a system, what they did, and when.
  • SIEM Integration: Send privileged-session and audit events to SIEM platforms through syslog for centralized monitoring, investigation, and compliance reporting.

Prerequisites

Before you start, you need to make a few decisions. The right answers depend on your organization's size, network, and security rules. This is not a full checklist, but it is a good place to start.

  • Pick your deployment model, Cloud or on-premises. Your choice usually depends on who you want to manage the infrastructure. See Deployment methods below.
  • Choose your site name and set up DNS. Every PRA site has a URL, and that URL is where users and client software connect. Cloud sites get a yoursite.beyondtrustcloud.com address, and you can point your own name at it with a CNAME record. On-premises appliances need a static IP address and a DNS A record.
  • Get an SSL/TLS certificate. PRA needs a valid certificate before BeyondTrust can build your client software. Use a public certificate authority (CA) or your own internal CA. Cloud sites cannot use self-signed certificates. You create the certificate request on the appliance itself, at /appliance > Security > Certificates.
  • Confirm your firewall settings. TCP 443 is required in every deployment. On-premises deployments may need more ports, including STUN and TURN ports for peer-to-peer traffic. Before you file a firewall request, see Network considerations.
  • Decide how users sign in. PRA can use local accounts, or it can connect to a security provider such as Active Directory, LDAP, SAML, Microsoft Entra ID, OpenID Connect, or Kerberos. This choice affects how you create users and group policies.
  • Plan your two-factor authentication. PRA supports TOTP apps and FIDO2 keys, which you turn on in group policies.
  • Plan for retention. Session recordings and text logs are kept for up to 90 days. If the disk fills up, the oldest data is deleted first, even if 90 days have not passed. Use the Integration Client to export data if you need to keep it longer.
🚧

Important

Your license file contains your site DNS name and your SSL certificate. If you change either one later, BeyondTrust Support has to rebuild your software, and you must wait 24 to 48 hours for clients to pick up the new certificate. Get these two things right before you deploy.

Deployment methods

You can deploy PRA in the cloud, or on-premises on a BeyondTrust B Series Appliance.

PRA Cloud

With PRA Cloud, BeyondTrust hosts runs for you, so you do not manage servers, storage, or the operating system. Your site runs on a single-tenant instance in the BeyondTrust cloud, with a 99.9% monthly uptime commitment.

BeyondTrust applies critical security updates for you, and you can pull other software updates whenever you want from the Updates page. Cloud sites use port 443 only, which keeps your firewall changes small.

Cloud customers sign in through Pathfinder, the shared BeyondTrust console at app.beyondtrust.io. Pathfinder is not a separate hosting model. It is a single front door for your BeyondTrust products, and it handles users and identity providers for all of them.

ℹ️

For more information, see Welcome to Privileged Remote Access Cloud and Pathfinder.

On-premises (B Series Appliance)

The B Series Appliance is a self-contained system that includes the operating system, the database, and the PRA software, already installed and configured. You run it in your own data center. You can buy it as physical hardware, or run the SRA Virtual Appliance on VMware, Hyper-V, Nutanix AHV, Red Hat OpenShift, Azure, or AWS.

An on-premises appliance has a second web interface at /appliance, where you manage the hardware, networking, storage, encryption, and base software. You control your own updates, backups, network placement, and clustering.

BeyondTrust recommends placing the appliance in a DMZ if you need to reach systems outside your network.

Compare the two methods

The following table describes what each deployment method provides.

PRA CloudOn-premises (B Series Appliance)
Cloud-hostedPhysical or virtual appliance you host
No appliance networking or storage to manageYou manage IP addresses, storage, and encryption
Limited /appliance interfaceFull /appliance interface
Critical updates applied by BeyondTrustYou choose when to install every update
99.9% uptime commitment from BeyondTrustUptime is your responsibility
BeyondTrust takes infrastructure snapshotsYou are responsible for infrastructure recovery
Port 443 onlyPort 443 plus additional ports
Self-signed certificates not allowedSelf-signed certificates allowed for testing only
Clustering deployed by BeyondTrustYou configure Atlas clustering and failover
Choose from published cloud regionsChoose your own data center
ℹ️

Configuration backups

In both deployment models, you download your own configuration backup from /login > Management > Software. Back up your Vault encryption keys at the same time. You need both files to restore your configuration to a new appliance.

PRA essentials

When you set up PRA, you build a small set of objects that control who can reach what. Add these during initial setup so access control and auditing work from day one.

NameDescription
EndpointAny remote computer or device on a network. This includes Windows, macOS, and Linux systems, mobile devices, and SSH or Telnet devices such as Cisco switches.
Asset (formerly Jump Item)A single system or device that you have set up in PRA for remote access. An Asset stores the address, the connection type, and the policies that apply. For more information, see Assets.
Asset Group (formerly Jump Group)A collection of Assets. Asset Groups do two things: they keep your list organized, and they control access. For example, the help desk can reach one group, and the network team can reach another. For more information, see Asset Groups.
Asset Role (formerly Jump Item Role)A set of permissions that says what a user can do with an Asset. This includes starting a session, creating or deleting Assets, moving them, and editing their settings. For more information, see Asset Roles.
Asset Policy (formerly Jump Policy)A rule that says when and under what conditions an Asset can be used. You can require a ticket number, a written reason, manager approval, or two-factor authentication. You can also limit access to a schedule, send email when a session starts, and turn recording off. For more information, see Asset Policies.
Jump ClientA small program you install on a remote system. It keeps a secure connection open to the appliance, so you can reach that system at any time, no matter what network it is on. Use Jump Clients for systems you access often. For more information, see Jump Client guide.
Gateway (formerly Jumpoint)A connection point you install on one computer inside a remote network. It acts as a tunnel to many other systems on that network, so you do not have to install software on each one. For more information, see Gateway guide.
Connection type (formerly Jump Method)How PRA connects to an Asset. Options include Remote RDP, Shell for SSH and Telnet, Remote VNC, Website, and Protocol Tunnel for databases and other TCP traffic. For more information, see Use Assets.
VaultThe built-in place where PRA stores privileged credentials. Vault can discover accounts, hide passwords from users, inject them into sessions, and rotate them on a schedule. For more information, see Vault.
Credential injectionA feature that pushes a stored credential into a session for the user. The user gets access without ever seeing the password. For more information, see Credential injection.
Asset AssociationThe setting on a Vault account that says which Assets the credential can be injected into. It keeps each credential from showing up on every system. For more information, see Asset Association options.
Account groupA collection of shared Vault accounts. Use account groups to grant access to many accounts at once and apply one account policy to all of them. A shared account can belong to only one group. For more information, see Account groups.
Account policyThe rules for a Vault account, such as whether the password rotates after checkout and how often it rotates on a schedule.
Group policyThe main way you grant permissions in PRA. A group policy defines what a group of users can do, and which Teams, Gateways, Asset Groups, and Vault accounts they belong to. Assign users to group policies instead of editing accounts one at a time. For more information, see Group policies.
Session policyThe rules for what happens inside a session. This covers screen sharing, copy and paste, file transfer, allowed shell commands, registry access, and more. For more information, see Session policies.
TeamA group of users organized for daily work, with Team Members, Team Leads, and Team Managers. Each team gets its own queue in the access console. For more information, see Teams.
Vendor groupA group for outside users, such as a contractor or a software vendor. Vendor groups have their own expiration dates, approval steps, and an optional portal where vendors register themselves. For more information, see Vendors.
Access inviteA one-time invitation that lets an outside person join a single session with limited permissions. For more information, see Access invite.

Asset types

Not every Asset is reached the same way. Some need software on the target system, and some need a Gateway on the target network. Knowing the difference helps you plan your rollout.

Asset typeHow PRA reaches itNeeds a GatewayNeeds a Jump Client
Jump ClientSoftware installed on the remote system keeps a connection open to the appliance.NoYes
Local JumpThe user's own computer connects directly to a Windows system on the same network.NoNo
Remote Jump, Remote RDP, Remote VNCThe session travels through a Gateway on the remote network.YesNo
Shell (SSH or Telnet)The session travels through a Gateway to a network device or server.YesNo
WebsiteA remote browser session runs through a Gateway. This is a paid add-on.YesNo
Protocol TunnelA tunnel through a Gateway carries TCP traffic, including database connections.YesNo
External AssetThe Asset comes from Password Safe rather than from PRA. All external Asset sessions use a Gateway.YesNo

Tip

Use Jump Clients for systems you access often, or systems that move between networks such as laptops. Use a Gateway when you need to reach many systems on one network and cannot install software on each of them.

The /login interface versus the access console

PRA has two interfaces, and they serve different people. Knowing which one to open saves a lot of time.

InterfaceDescription
/loginThe web admin interface, at your site URL plus /login. Administrators use it to create users and group policies, build Asset Groups and policies, deploy Jump Clients and Gateways, manage Vault, and run reports.
Access consoleThe application your users run to do the work. They use it to start sessions, browse the Assets they are allowed to reach, inject credentials, transfer files, and chat. It comes as a desktop app, a web version in the browser, and a mobile app. For more information, see Access console interface.

On-premises deployments have a third interface, /appliance, which you use to configure networking, storage, certificates, and base software. Cloud deployments have a smaller version of this interface.

🚧

Important

The /appliance and /login credentials are separate. Changing one does not change the other. Your /login credentials are also what you use to sign in to the access console.

Initial setup

🚧

Important

Complete these steps to get PRA working. The steps are ordered because each one depends on the one before it.

1. Sign in

Use a supported browser to sign in to your PRA site.

  • Cloud on Pathfinder: Go to app.beyondtrust.io and sign in, then open Privileged Remote Access.
  • Standalone Cloud: Go to your site URL followed by /login. Your URL is in the BeyondTrust welcome email.
  • On-premises: Go to your appliance URL followed by /login. The first sign-in uses the default administrator account, and you must change the password right away.
🚧

Important

You must sign in as an administrator to complete the rest of these steps.

2. Install your SSL certificate and license

You do this before anything else because you cannot download client software without it.

  1. Go to /appliance > Security > Certificates.
  2. Create a certificate request, and send it to your certificate authority.
  3. Import the signed certificate, along with the intermediate and root certificates. Many CAs do not send the root certificate, so ask for it.
  4. Send your site name, the root certificate, and your appliance details to BeyondTrust Support so they can build your license package. Never send a private key.
  5. When Support notifies you, install the license and base software packages from /appliance > Updates.

Cloud sites already have a certificate for yoursite.beyondtrustcloud.com, so you only do this if you want to use your own hostname. Let's Encrypt is also supported in both models.

ℹ️

For more information, see SSL certificates.

3. Connect your identity source and create users

Next, decide how people sign in.

  1. Go to Users & Security > Security Providers, and add your provider. Use Test settings to check it before you save.
  2. Assign a default group policy to the provider. Every user who signs in from an outside identity source must belong to at least one group policy.
  3. Go to Users & Security > Users to add any local accounts you still need.

In Pathfinder, you manage users and SAML identity providers at the platform level instead, under Administration. The Security Providers page inside PRA is read-only.

ℹ️

Some settings, such as how users are provisioned, cannot be changed after you save the provider. Review your settings carefully.

For more information, see Security providers.

4. Create group policies

Group policies are how you grant permissions in PRA. Create them before you create Assets, so you have somewhere to assign access.

  1. Go to Users & Security > Group Policies, and click to add a policy.
  2. Set Account Settings, including whether TOTP or FIDO2 is required.
  3. Set General Permissions, such as whether members are administrators or can manage Vault.
  4. Set Access Permissions, including which connection types members can use.
  5. Add members. You can add local users, or whole groups from your security provider.
🚧

Important

When a user belongs to more than one group policy, the policy lower in the list wins, unless a higher policy marks the setting as Final. To understand how the order of group policies and session policies works, see Understanding session and group policies.

5. Build Asset Roles, Asset Policies, and Asset Groups

Create these three objects in this order, because each one is used by the next.

  1. Asset Roles. Go to Asset Management > Asset Roles. Create roles that match the jobs people do. A read-only Auditor role ships with the product.
  2. Asset Policies. Go to Asset Management > Asset Policies. Create policies for your access rules, such as requiring approval or limiting access to business hours.
  3. Asset Groups. Go to Asset Management > Asset Groups. Create a group, give it a code name, and list the users and group policies allowed to use it. Assign each one an Asset Role.

6. Deploy Jump Clients, install a Gateway, or both

Now connect PRA to your systems.

To deploy Jump Clients:

  1. Go to Asset Management > Jump Clients, and start the Mass Deployment Wizard.
  2. Choose the Asset Group. This is the only required field.
  3. Set how long the installer stays valid, and choose the Asset Policy and session policy you want applied.
  4. Distribute the installer. You can send a link, run a script, or push the Windows MSI with a tool such as Intune, SCCM, or Group Policy.

To install a Gateway:

  1. Go to Asset Management > Gateway, and add a Gateway.
  2. Name it, set the platform, and turn on the connection types you need, such as SSH or Protocol Tunnel.
  3. Download and run the installer on a computer inside the target network. The installer link expires in 7 days.
🚧

Important

The Gateway platform and clustering settings cannot be changed after you save. Choose them carefully.

ℹ️

For more information, see Jump Client guide and Gateway guide.

7. Set up Vault and credential injection

With systems connected, store the credentials people need.

  1. Go to Vault > Accounts, and add your shared accounts. You can enter them by hand, or run a discovery job under Vault > Discovery to find them.
  2. Group related accounts under Vault > Account Groups, and apply an account policy to control rotation and checkout.
  3. Set Asset Association on each account so the credential is only offered on the Assets it applies to. For more information about Asset Association, see Asset Association options.
  4. Give users the Inject role, or Inject and Checkout if they also need to check the credential out. Assign these through group policies.
ℹ️

Vault discovery for domain accounts runs through a Windows Gateway. Local Windows account discovery runs through Jump Clients. If your credentials live in an outside vault such as Password Safe, you also need the BeyondTrust Endpoint Credential Manager (ECM).

For more information, see Vault and Discovery.

Asset Association options

Asset Association controls which Assets a Vault account can be injected into. Without it, every credential in Vault would appear as a choice on every system, and your users would have to pick the right one from a long list.

You set it when you add or edit an account. Go to Vault > Accounts, then click Add. To change an account you already have, find it in the grid, click the ellipsis, and select Edit. Asset Association is a section on that page. The same section appears on the account group page, which is what makes the inherited option work.

Choose one of the following types.

TypeWhat it does
Inherited from the Account GroupUses the associations set on this account's account group. This is the simplest choice if you already organized your accounts into groups.
Any AssetsThe account can be injected into any session where the account type applies.
No AssetsThe account can never be injected. Use this for a credential people only check out.
Assets Matching CriteriaThe account can only be injected on Assets you name directly, or on Assets that match the filters you set.

If you choose Assets Matching Criteria, you can pick Assets from the list and click Add Asset. You can also filter on four Asset attributes: Name, Hostname / IP, Tag, and Comments. Assets you pick and Assets that match a filter are combined, not replaced. Each attribute holds up to 32 values, and each value can be up to 64 characters.

Filters accept these patterns.

PatternResult
valueMatches the field exactly.
value*Matches the start of the field.
*valueMatches the end of the field.
*value*Matches if the field contains the value.
ℹ️

Asset Association controls credential injection only. It does not control who can see or check out an account. The Inject and Inject and Checkout roles do that.

Credential injection works with the Jump Client, Remote RDP, Remote Jump, SSH, Database Connection, and Website connection types. It does not work with personal Assets, or with TCP tunnel and IP tunnel database connections.

8. Configure session policies

Session policies control what users can do once they are connected.

  1. Go to Users & Security > Session Policies, and add a policy.
  2. Set Availability to say where the policy can be applied: to users, to Assets, or to access invites.
  3. Set your permissions. Leave a permission as Not Defined if you want a lower policy to decide it.
  4. Use the Session Policy Simulator to confirm the result before you roll it out.
ℹ️

For information on how the order of session policies and group policies works, see Understanding session and group policies.

9. Install the access console

Finally, get your users the app they will actually use.

  1. Go to Consoles & Downloads.
  2. Choose the platform and download the access console.
  3. For a large rollout, install the MSI silently with msiexec.

The desktop console has every feature but only runs on the computer it was downloaded to. The privileged web access console runs in any browser, but it does not include features that need deep access to the operating system.

ℹ️

Users must sign in to the desktop console at least once before you upgrade the appliance. Otherwise the console cannot update itself.

For more information, see Consoles and downloads.

10. Back up your configuration

Go to /login > Management > Software, set a backup password, and download your configuration backup. Download your Vault encryption keys as a separate file. Repeat this every time you change your settings. You need both files to restore PRA to a new appliance.

Next steps


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