PowerShell module that simulates realistic Secret Server user activity for lab and demo environments. AD-authenticated users perform randomized actions against an on-prem Delinea Secret Server instance, generating audit trail data that looks like real-world usage.
# Import the module (from the repo root)Import-Module .\RobOtters.psd1
# Create the databaseInitialize-RODatabase# Configure your Secret ServerSet-ROConfig-Key 'SecretServerUrl'-Value 'https://yourserver/SecretServer'Set-ROConfig-Key 'DefaultDomain'-Value 'YOURDOMAIN'# Add a simulated userAdd-ROUser-Username 'svc.sim01'-Password 'P@ssw0rd!'-Domain 'YOURDOMAIN'# Test connectivityTest-ROConnection-Username 'svc.sim01'# Run a cycleStart-ROCycle- User simulation with configurable action weights -- Configuration
- Automatic password rotation and auth failure recovery -- Password Management
- Export/import for environment portability -- Export & Import
- User access snapshots -- Access Snapshots
- Secret Server reports from SQL templates -- Reports
| Command | Description |
|---|---|
| Initialize-RODatabase | Create or upgrade the SQLite database |
| Add-ROUser | Register a simulated AD user |
| Remove-ROUser | Remove a simulated user |
| Get-ROUser | List simulated users |
| Set-ROUser | Update user properties |
| Start-ROCycle | Run a simulation cycle |
| Get-ROActionLog | Query the action history |
| Get-ROConfig | Read configuration values |
| Set-ROConfig | Set a configuration value |
| Test-ROConnection | Test Secret Server authentication |
| Get-ROAccess | View user access snapshots |
| Export-ROConfig | Export configuration and users to JSON |
| Import-ROConfig | Import configuration and users from JSON |
git clone https://github.com/jagger/SSSimulatedUsers.git RobOtters
Import-Module .\RobOtters\RobOtters.psd1Download from GitHub, extract, and import:
Import-Module .\RobOtters\RobOtters.psd1Copy the module folder to a directory in $env:PSModulePath, then:
Import-Module RobOtters- Windows Server 2016+ with PowerShell 5.1+
- Active Directory domain with user accounts for simulation
- PSSQLite module
- Delinea Secret Server with REST API enabled
See Getting Started for a full walkthrough.
All settings are stored in the Config SQLite table. Key settings:
| Key | Default | Description |
|---|---|---|
| SecretServerUrl | (placeholder) | Secret Server base URL |
| DefaultDomain | LAB | AD domain name |
| MinActionsPerCycle | 0 | Min actions per user per cycle |
| MaxActionsPerCycle | 15 | Max actions per user per cycle |
| PasswordRotationDays | 14 | Days between password rotations |
See Configuration for the full list of 11 config keys, action weight customizations, and category controls.
| Problem | Fix |
|---|---|
| PSSQLite not found | Install-Module PSSQLite -Scope CurrentUser |
| SecretServerUrl not configured | Set-ROConfig -Key SecretServerUrl -Value '...' |
| Auth failed | Test-ROConnection -Username X and check password |
| 0 actions in scheduled task | Users may be outside active hours; use -Force or adjust times |
See Troubleshooting for the full guide.
RobOtters/
+-- RobOtters.psd1 # Module manifest
+-- RobOtters.psm1 # Dot-source loader
+-- Register-ROTask.ps1 # Task Scheduler registration
+-- assets/ # Images
+-- Data/ # Schema, seed data, SS reports
+-- Docs/ # Guides and command reference
+-- Public/ # 13 exported commands
+-- Private/
| +-- Actions/ # 19 Secret Server action functions
| +-- Api/ # REST client + OAuth2
| +-- Data/ # SQLite helpers
| +-- Engine/ # Cycle orchestration
| +-- Logging/ # File + DB logging
+-- Scripts/ # Migration utilities
+-- Logs/ # Daily rotating logs (gitignored)
+-- Tests/ # Pester tests
See CONTRIBUTING.md for guidelines.