Administration | AI Agent Security

A setting changed in the wrong place can quietly empty an inventory, stop traffic inspection, or leave enforcement off on every endpoint. The Administration page is where you set the defaults every endpoint follows, get the certificate endpoints must trust, and see who changed which setting and when.

Scope of this guide

This guide explains the Administration page: users, the fleet default settings, the Windows driver process exclusions, your tenant trust anchor, the audit trail, and the appearance options. It does not cover setting a value on a single endpoint or tag.

Prerequisites

  • You have administrator access to the tenant.

Open the Administration page

Go to Settings > Administration.

Tabs

TabDescription
UsersLists who has access to the tenant, and lets you add and remove users.
Fleet defaultsSets the values every endpoint uses unless one of its tags, or the endpoint itself, sets the setting.
Trust anchorHolds your tenant root certificate, which endpoints must trust before the agent can inspect traffic.
Audit trailRecords every change to a fleet, tag, or endpoint setting, newest first.
AppearanceControls which modules appear in your sidebar and whether the chatbot is on.

Users

The Users tab lists everyone with access to the tenant, with their Email, Name, Role, and Status.

The Users tab listing the users in the tenant

Add a user

  1. Select Add User.
  2. Enter the person's address in the Email field. This is the only required field.
  3. Enter their First Name and Last Name.
  4. Select Create User.

The confirmation shows a temporary password. It is shown only once, so copy it and share it with the user securely. To close the dialog without adding anyone, select Cancel or the X.

The Add User dialog

About roles

The Role field is set to Admin and cannot be changed. Additional roles are coming in a future release.

Every user you add is an administrator, with full access to the tenant. There is no way to give someone read-only access, or to let them review sessions without also letting them change policies, revoke endpoints, and add further users.

Two things follow from this:

  • Add users deliberately. Each one can change anything in the tenant.
  • Separation of duties rests on your own practice. Where your process depends on one person requesting an exception and another approving it, the product does not enforce that split.

Reset a password or remove a user

Each row has two actions at its right end:

ButtonDescription
Reset passwordGenerates a new temporary password. The user must change it the next time they sign in.
Remove userRemoves the user's access to the tenant.

Fleet defaults

The Fleet defaults tab sets the values every endpoint uses. As the tab puts it: "Values set here apply to every endpoint unless one of its tags, or the endpoint itself, sets the setting." A fleet default is a starting point, not a fleet-wide guarantee.

The Fleet defaults tab

How a row works

Each setting is a row with a pin toggle at its left, the setting name and description in the middle, and the control at its right.

  • Not pinned means endpoints use the built-in default. The control shows that default but is greyed out and locked, and the row shows a Default badge.
  • Pinned means every endpoint gets the value you set here, unless one of its tags or the endpoint sets its own. The row shows a Directly modified badge, with who pinned it and when.

Select the information icon beside a setting name to see which value applies and where it comes from. Select the Directly modified badge to open the Audit trail tab filtered to that setting.

Change a setting

  1. Select the pin toggle on the row, so it reads as pinned.
  2. Set the toggle, or enter the value you want.
  3. Select Apply on that row.

Each setting applies on its own. Changing several means selecting Apply on each one.

To return a setting to its built-in default, select the pin toggle again to unpin it.

Enforcement

SettingDescription
Specific policy allow eventsRecords an event when one of your policies explicitly allows an action.
Baseline allow visibilityAlso records actions that no policy matched and were allowed by default.
TLS inspectionDecrypts and inspects HTTPS traffic on managed endpoints, so AI prompts and the destinations they reach are visible. Endpoints your organization does not manage stay off. Applies to programs started after the endpoint's next settings check-in. A program already running keeps its setting until it restarts.
Windows traffic redirectForces AI-agent network traffic through the local inspection proxy on Windows endpoints, even for tools that ignore proxy environment variables. Required to inspect or block command-line tools such as aws.exe.
TLS interception detectionRecognizes AI tools by the network destinations they reach rather than by process name alone, and brings their traffic under TLS interception once inspection is on.

The two allow-recording settings overlap. Baseline allow visibility records the specific-policy allows as well, so turning off Specific policy allow events on its own changes nothing. Both must be off to stop recording allows.

Baseline allow visibility is high volume. It records every action that no policy matched, which in an allow-by-default environment is most of what happens. Leave it on when you need complete visibility, and expect the event counts on the Events page to reflect it.

Health reporting

SettingDescription
Heartbeat intervalHow often each endpoint checks in to report that it is healthy. Accepts 10 to 3600 seconds.

Visibility

SettingDescription
Scan intervalHow often each endpoint runs its discovery scans. Accepts 30 to 86400 seconds. A change applies to the next scan, not to one already running.
Process discoveryInventories the processes running on each endpoint as workloads.
Credential discoveryFinds credentials stored on each endpoint, and the identities they grant access to.
MCP discoveryFinds the MCP servers that AI coding tools on each endpoint are configured to use.
Skill discoveryFinds the agent skills installed for AI coding tools on each endpoint.
Coding transcript captureCaptures the assistant messages and reasoning from AI coding sessions, so their prompts and responses are visible.

The discovery settings are what populate the Visibility pages. Turning MCP discovery or Skill discovery off empties the corresponding inventory over time, so an inventory that looks clean may only mean discovery is off.

Other

SettingDescription
MCP tool inspection enabledAdjudicates MCP tool calls inline at the endpoint's inspection proxy, blocking calls your policies deny before they reach the server. Applies to MCP clients whose HTTPS traffic the proxy inspects.
MCP observed emit enabledRecords which MCP servers AI coding tools actually call, once per session and server, so servers reached without a configuration entry still appear on the MCP Servers page.
Uninspected signal enabledRecords TLS connections that could not be decrypted and inspected, so gaps in visibility are surfaced rather than silent. Off by default.
Hook shadow sample bpsHow often endpoints check upcoming policy changes against current policies on live coding-agent activity, in hundredths of a percent. Set -1 for automatic, 0 for off, or a value from 1 to 10000 to turn sampling on.
Probe enabledSamples the first connections to hosts the agent does not recognize.
Probe budget connectionsThe most connections sampled for one unrecognized host before it is let through without sampling. Accepts 1 to 64.

Enforcement planes

SettingDescription
Process execution planeTurns on enforcement for processes as they start.
File access planeTurns on enforcement for file access. This plane produces a high volume of file-open events.
Restricted file auditAudits file opens on the restricted set of files that matter for credentials.
Network connect planeTurns on enforcement for outbound network connections.

Telemetry

SettingDescription
Telemetry dedup TTL (seconds)How long a baseline file-open event is suppressed after it is first seen. Accepts 1 to 3600 seconds.
Telemetry dedup capacityHow many entries the suppression list holds. Accepts 100 to 1000000.
Drop directory-open telemetryDiscards file-open events for directories, which are rarely useful.

Break-glass

SettingDescription
Enforcement master switchTurns enforcement on or off on the endpoint. Turning it off disables every enforcement plane. Requests that no rule permits stay refused, and built-in safety limits still apply.
Audit ceiling (stop blocking)Records every matching rule as an audit instead of blocking, requiring approval, or ending the process, on every enforcement plane. Off by default.

The break-glass settings exist for an emergency, such as a policy blocking work across the fleet. Pinning either one at the fleet level changes enforcement on every endpoint that does not set its own value, so record why in your change process and unpin it once the emergency is over.

Windows traffic redirect rollout

When the tenant has Windows endpoints, a Windows traffic redirect rollout panel below the settings tracks the redirect, such as 2 of 29 Windows endpoints have the redirect armed.

FigureDescription
ArmedEndpoints where the redirect is active.
Pending restartEndpoints that will arm at their next agent restart.
Declined (corp proxy)Endpoints that did not arm because they are on a corporate-proxy-only network with TLS inspection off. The endpoint fails safe rather than break outbound traffic.
Set to onEndpoints where the setting is on, whether or not they have armed yet.

Roll this setting out to a few endpoints first using per-endpoint values, watch the Armed count climb, then turn it on fleet-wide.

Do not arm browsers (Chrome, Edge, and Firefox). Their traffic is routed, but the inspection certificate is not trusted, so their connections break. AI coding agents such as Node, Python, curl, and git are safe.

To roll back, turn the redirect off. Endpoints disarm at their next sync or restart.

Windows driver process exclusions

The Windows driver process exclusions panel at the bottom of the tab carves specific processes out of specific driver features on every Windows endpoint that uses this list. Only administrators can change it.

An excluded process is invisible to the features you choose for it, on every Windows endpoint in the tenant that uses the list. Exclude a process only when a driver feature is causing a real problem with it, such as a backup tool that fails when its file opens are intercepted.

ColumnDescription
PatternThe process image the exclusion matches, such as C:\TestApp\ for a whole folder or *\backup.exe for an image by name anywhere.
File, Hook, TLS, Net, SNI, ExecWhether the exclusion applies to file-open interception, hook DLL injection, TLS transparent redirect, network connect interception, inline SNI capture, and process-exec interception. Hover over a heading for its full name.
NoteWhy the process is excluded.

To add an exclusion:

  1. Select Add exclusion.
  2. Enter the Process image pattern.
  3. Under Features to exclude, select at least one feature.
  4. Enter a Note that says why the process is excluded.
  5. Select Add exclusion to close the dialog.
  6. Select Save.

The list is not saved until you select Save. Select Discard to drop your unsaved changes. When some endpoints use their own exclusion list, the panel says how many, and a save here does not reach them.

Trust anchor

The Trust anchor tab holds your tenant root CA, the root certificate every AI Agent Security agent installs into an endpoint's trust store. It is what makes the agent's TLS interception trusted without a prompt on each device.

You create the anchor once and it secures every agent you deploy. The deploy wizard reuses this same anchor, so you do not generate a new one per deployment.

The Trust anchor tab

Get the certificate

OptionDescription
Download .cerDownloads the certificate as a .cer file.
Copy PEMCopies the certificate in PEM format to your clipboard.
Your MDMChooses the device management tool the macOS profile is built for: Jamf Pro, Microsoft Intune, Iru (formerly Kandji), or Other. Jamf Pro gets a signed profile; the others get plain XML.
Download Configuration Profile (macOS)Downloads a .mobileconfig profile containing the certificate, built for the tool you chose.

Expand Certificate details to see the certificate's Subject, Expires, Tenant, and SHA-256 fingerprint.

Use the format your distribution method expects: the configuration profile for a macOS device management tool, the .cer file for Intune or Group Policy on Windows, and PEM where you need to paste the certificate into a configuration file.

Audit trail

The Audit trail tab records who changed fleet, tag, and endpoint settings, and when, newest first. It records settings changes only.

Filter the audit trail

Enter a value in any of the boxes above the list. The filters combine.

FieldDescription
Setting keyThe setting to show, by its key.
ActorWho made the change.
FromThe first date to include.
ToThe last date to include.

Column reference

ColumnDescription
WhenWhen the change was made.
Changed byThe user or process that made the change.
SettingThe setting that changed.
ScopeWhere the change applies: Fleet default, a tag name, or an endpoint name. Select an endpoint name to open that endpoint.
ActionWhat was done to the setting.
Old valueThe value before the change.
New valueThe value after the change.

Appearance

The Appearance tab controls how the interface looks for you.

The Appearance tab
SettingDescription
AI Coworkers OnlyFocuses the interface on AI coworker management and hides non-AI pages from the sidebar.
CharlesGPT chatbotTurns on the conversational assistant. When off, the widget at the bottom right shows only the feedback form.

Module visibility

The Module visibility table controls which modules appear in your sidebar.

ModuleDescription
DashboardThe Dashboard page.
VisibilityThe inventory pages: AI agents, MCP servers, LLM endpoints, agent skills, and endpoints.
IntelligenceThe Events and AI Sessions pages.
ProtectionThe Policies and Exception Requests pages.

Set a module's Visible toggle to show or hide it. Select Reset to defaults to restore the original selection. Settings is always visible.

These settings affect only you. Hiding a module does not restrict anyone's access to it. Use this to reduce clutter, not to control what people can reach.

Verify the results

After adding a user, confirm they appear on the Users tab with the email address you entered.

After changing a fleet default, confirm the row shows the value you set and a Directly modified badge, then check the Audit trail tab for the change. For Windows traffic redirect, check the rollout figures. Endpoints move from Pending restart to Armed only as their agents restart, so the change is not immediate.

Next steps

  • Review the Users list periodically and remove anyone who no longer needs access.
  • Download your tenant certificate from Trust anchor in the format your device management tool expects.
  • Roll out Windows traffic redirect to a few endpoints before enabling it fleet-wide.

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