Skip to main content
Version: 11.5.0

Get Started as an Auditor

Role: Auditor. The console shows the role you work in beside your name, at the top right.

Who This Is For​

You check that AgentPass is configured and operated the way your organization says it is. You read everything and change nothing: who holds which role, what the policies say, what agents did, and how long records are kept.

What You Can Do​

You canWhere it is covered
Read people, roles and groups on People, including what each role grantsRoles and Permissions, Permissions by Role
Read every connector, agent, policy and approval, and DesktopsConnectors, Approvals in the Console
Read Request log, Desktop activity, Session watch and Policy decisions for every agentRequest Log, Policy Decisions
Read guardrail posture, alerts, history, Proving Ground runs, Session investigator results and judgesPosture and History
Export guardrail evidence, and open a Proving Ground run's shareable reportEvidence Export, A Shareable Report
Read Settings → Gateway settings, Theme, Data management and Data classificationGateway Settings, Data Management
Open the API referenceFinding Your Way Around the Console

Someone else does this: an administrator runs access reviews and exports their results, and sets up where records leave the gateway. Ask the review's owner for an access review export.

How It Works for You​

The console shows recent activity. Each record category keeps its data for a window the platform sets, which Settings → Data management shows. Audit records, such as changes to data management settings, policy modes, directory provisioning and access reviews, are kept indefinitely.

For records beyond the console's window, and for the audit trail itself, read the copies your administrator sends out of the gateway: export files, a log stream to your SIEM, or the Forensics Store.

Guardrails carries a Preview tag in the console.

If you hold more than one role, choose Auditor under Role in the account menu. See Work in More Than One Role.

Your First Hour​

  1. Read the controls AgentPass enforces, each stated for a reviewer. See Security Controls.
  2. Check who holds what, on the Roles tab of People. See Look at What a Role Grants.
  3. Check each record category's retention window. See Categories and Events.
  4. Check where records leave the gateway. See Where Your Data Goes.
  5. Export the guardrail evidence pack from Guardrails → Posture. See Evidence Export.
  6. Open a Proving Ground run's report. See A Shareable Report.
  7. Sample approvals, with who decided and how. See Review a Request's Details.
  8. Sample policy decisions. See Read the List.
  9. Sample requests, and open one in full. See Request Detail.
  10. Ask the access review program owner for the latest results. See Export the Results.

Where to Go Next​

If you want toGo to
Read the request record in your SIEMSend the Request Log to Your SIEM
Keep audit data longer than the gateway doesLong-Term Audit and Telemetry
Understand what an access review coversRunning Agent Access Reviews
Read a session end to endAgent Session Forensics