Managing privileged accounts is a mess. Most organizations treat "admin" as a binary state rather than a collection of granular permissions, leading to the inevitable credential sprawl that fuels modern lateral movement attacks. The CyberArk Trustee (Level 1) certification is often dismissed by senior engineers as a "beginner's badge," but that's a mistake. It covers the foundational architecture of the Privileged Access Manager (PAM) solution—specifically the Vault, CPM, PVWA, and PSM—where most architectural debt is created.
If you misconfigure your Safes or mess up your Platform inheritance at this stage, you’re setting yourself up for a massive "yak-shaving" exercise six months down the line when you try to implement automated rotation or session monitoring. This guide breaks down the technical requirements for the Trustee level, focusing on the components that matter in a production environment.
The Core Architecture: More Than a Database
At its heart, the CyberArk Vault (Digital Vault) is a hardened Windows Server. Calling it a database is an insult; it’s a proprietary object-based storage system that uses the Vault Protocol (TCP 1858) for all communications.
Component Breakdown and Communication
The architecture relies on four primary components. If you're prepping for the Trustee exam, you need to understand the flow of data between these, not their names.
- Digital Vault (EPV): The "Source of Truth." It handles encryption, access control, and audit logging. It does not initiate connections; it only listens.
- Password Vault Web Access (PVWA): An IIS-based web interface. This is where OIDC 1.0 and SAML 2.0 integrations live.
- Central Policy Manager (CPM): The "Worker." This service initiates the password changes via plugins (PMTerminal, TPC).
- Privileged Session Manager (PSM): A hardened RDS server that proxies RDP, SSH, and web traffic.
graph TD USER["End User"] -->|"HTTPS/443"| PVWA["PVWA (IIS)"] PVWA -->|"TCP/1858"| VAULT["Digital Vault"] CPM["CPM Service"] -->|"TCP/1858"| VAULT CPM -->|"SSH/RDP/SQL"| TARGET["Target System"] PSM["PSM (RDS)"] -->|"TCP/1858"| VAULT PSM -->|"RDP/SSH"| TARGET subgraph STORAGE ["Storage Layer"] VAULT end
IMPORTANT
The Vault never reaches out to other components. This is a common exam "gotcha." All other components (CPM, PVWA, PSM) must be able to resolve and reach the Vault's IP on port 1858. If you have a firewall between them, that's where your troubleshooting starts.
Identity Integration and Authentication Protocols
While CyberArk has its own internal authentication (CyberArk-Auth), no one uses that for end-users in a real enterprise. You’ll be dealing with LDAP/AD integration or, more likely, SAML 2.0 for Single Sign-On (SSO).
SAML 2.0 Flow in PVWA
When a user hits the PVWA, the browser is redirected to the Identity Provider (IdP). After successful auth, the IdP sends a SAML assertion back to the PVWA.
Unpopular opinion: SAML is showing its age and is notoriously difficult to debug without a browser trace, but for PVWA, it's still the standard. Most engineers forget to map the VaultGroups attribute in the SAML assertion, which leads to "User not defined" errors because the Vault can't authorize the user even if the IdP authenticated them.
Example: SAML Configuration (web.config snippet)
In the PVWA's web.config, you'll often find yourself manually tweaking the wsFederation or custom SAML settings if the UI fails you.
<federatedAuthentication>
<wsFederation passiveRedirectEnabled="true"
issuer="https://idp.example.com/adfs/ls/"
realm="https://pvwa.example.com/PasswordVault/"
requireHttps="true" />
<cookieHandler requireSsl="true" />
</federatedAuthentication>
OAuth 2.1 and REST API
For automation (the "Trustee" level expects you to know the API exists), CyberArk is moving toward OAuth 2.1. If you're writing scripts to onboard accounts, stop using the Logon endpoint with cleartext credentials. Use the Identity-integrated OAuth flow where possible.
Safe Design: The Logical Security Layer
Safes are the primary unit of authorization in CyberArk. A common mistake is creating one Safe per account (too granular) or one Safe for the entire company (not granular enough).
What Works: The Functional Grouping Pattern
Group accounts by:
- Access Level: (e.g., Domain Admins vs. Local Admins)
- Platform Type: (e.g., Linux vs. Windows)
- Rotation Policy: (e.g., Daily vs. 90 days)
| Feature | Internal User | LDAP User | SAML User |
|---|---|---|---|
| Password Managed by Vault | Yes | No (Managed by AD) | No (Managed by IdP) |
| Multi-Factor Support | Limited | Yes (via RADIUS) | Yes (via IdP) |
| Automatic Provisioning | No | Yes (via LDAP Map) | Yes (via JIT) |
TIP
Use the "Rule of Least Privilege" when assigning Safe Members. A "Trustee" should know that giving Manage Safe permissions to a standard user is a massive security footgun. They can effectively grant themselves access to any account in that Safe.
Account Onboarding and Platform Management
Platform management is where the CPM logic lives. A Platform is a set of configuration rules that define how the CPM interacts with a target system.
The CPM Rotation Cycle
The CPM doesn't "change a password." It follows a state machine:
- Change: Generates a new random string based on the Platform's complexity rules (RFC 4086 compliant).
- Verify: Logs into the target system using the current credentials to ensure they work.
- Reconcile: If Verify fails, the CPM uses a "Reconcile Account" (higher privileged) to forcibly reset the password.
Troubleshooting with TPC (Terminal Plugin Controller)
If a password change fails, you need to look at the pm.log or pm_error.log. Most failures are due to shell prompt mismatches. If your Linux server has a custom PS1 prompt like [user@host ~]$, the default Unix platform might fail to recognize it.
# Typical TPC Error - The "I learned this the hard way" moment
# Log shows: "Expect failed: transition not found"
# Fix: Update the platform's 'Shell Prompt' regex to handle your custom shell.
# Regular Expression example for Platform config:
# ([\$#\>:])\s*$
Security Considerations and Common Failures
The Trustee certification emphasizes the "CyberArk Blueprint." This isn't marketing fluff; it's a defensive strategy against credential theft.
The Break-Glass Scenario
What happens when the Vault is down? You need "Master" keys. These are physical keys (CDs or USBs) generated during the VaultServer installation.
- Master Password: Used to log into the Vault locally when all other auth methods fail.
- Recovery Keys: Used to decrypt the database.
CAUTION
If you lose the Master keys, your data is gone. There is no "Forgot Password" link for the Digital Vault. Store these in a physical safe, not on a network drive.
Over-provisioning the PSM
The PSM is a bottleneck. Every session consumes an RDS CAL (Client Access License). If you have 50 concurrent users but only 20 RDS licenses, users will get generic "Protocol Error" messages that are a nightmare to diagnose. Always monitor your PSMServer service health and RDS license usage.
Quick Reference: Essential Commands and Paths
For those sitting the exam or doing a fresh install, these paths and commands are your bread and butter.
Key Config Files
- Vault:
C:\Program Files (x86)\PrivateArk\Server\Conf\DBParm.ini(Main Vault config) - CPM:
C:\Program Files (x86)\Password Manager\Vault\Vault.ini(Connection to Vault) - PVWA:
C:\inetpub\wwwroot\PasswordVault\web.config
CLI Tools
- CAVaultManager: Used for emergency Vault operations (e.g.,
CAVaultManager.exe RecoverStore). - PAReplicate: The tool for backing up the Vault. If you aren't running this daily, you don't have a backup.
Quick Command Cheat Sheet
| Task | Tool/Command |
|---|---|
| Check Vault Service | services.msc -> PrivateArk Server |
| Reset Admin Password | PrivateArk Client -> Tools -> Administrative Tools -> Users |
| Increase Log Level | DBParm.ini -> DebugLevel=High (Requires restart) |
| Test CPM Plugin | Driver.exe (Located in the CPM bin folder) |
Final Thoughts on Implementation Trade-offs
Choosing between Agent-less (standard CyberArk) and Agent-based (Privilege Cloud/EPM) is the biggest decision you'll make. Agent-less is easier to deploy across a thousand servers because you don't have to install software on each target. However, it relies heavily on network connectivity and the CPM's ability to "see" the target.
If you are dealing with air-gapped segments, you'll end up deploying "CPM Proxies" or "Distributed Vaults." This is where the Trustee level ends and the Sentry level begins. For now, focus on mastering the Safe permissions and the CPM rotation logic. If you can't explain the difference between a "Change" and a "Reconcile" operation, you aren't ready for the exam—or for a production environment.
Avoid the temptation to "bikeshed" the UI colors in the PVWA. Spend that time instead on hardening your PSM servers and ensuring your DBParm.ini follows the CIS benchmarks for Windows Server. That’s what keeps the attackers out.
