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 can | Where it is covered |
|---|---|
| Read people, roles and groups on People, including what each role grants | Roles and Permissions, Permissions by Role |
| Read every connector, agent, policy and approval, and Desktops | Connectors, Approvals in the Console |
| Read Request log, Desktop activity, Session watch and Policy decisions for every agent | Request Log, Policy Decisions |
| Read guardrail posture, alerts, history, Proving Ground runs, Session investigator results and judges | Posture and History |
| Export guardrail evidence, and open a Proving Ground run's shareable report | Evidence Export, A Shareable Report |
| Read Settings → Gateway settings, Theme, Data management and Data classification | Gateway Settings, Data Management |
| Open the API reference | Finding 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
- Read the controls AgentPass enforces, each stated for a reviewer. See Security Controls.
- Check who holds what, on the Roles tab of People. See Look at What a Role Grants.
- Check each record category's retention window. See Categories and Events.
- Check where records leave the gateway. See Where Your Data Goes.
- Export the guardrail evidence pack from Guardrails → Posture. See Evidence Export.
- Open a Proving Ground run's report. See A Shareable Report.
- Sample approvals, with who decided and how. See Review a Request's Details.
- Sample policy decisions. See Read the List.
- Sample requests, and open one in full. See Request Detail.
- Ask the access review program owner for the latest results. See Export the Results.
Where to Go Next
| If you want to | Go to |
|---|---|
| Read the request record in your SIEM | Send the Request Log to Your SIEM |
| Keep audit data longer than the gateway does | Long-Term Audit and Telemetry |
| Understand what an access review covers | Running Agent Access Reviews |
| Read a session end to end | Agent Session Forensics |
Related
- Security Controls — every control AgentPass enforces, for a reviewer
- Permissions by Role — every permission each role holds, by product area
- Get Started as a Security Analyst — the role that triages and contains