- Access exclusive content
- Connect with peers
- Share your expertise
- Find support resources
Our community just got stronger! Explore new identity security resources, connect with experts, and discover more ways to learn and collaborate.
The PSMChecker tool can be downloaded from the Idira Marketplace.
To access the Marketplace, in your Idira tenant, navigate to Setup Space > Ecosystem Hub > Marketplace and search for 'PSMChecker'.
PSMChecker is a comprehensive tool designed to simplify troubleshooting and resolve PSM issues in Idira PAM systems. It automates diagnostics, validates configurations, and provides remediation options for common PSM-related problems.
Key error scenarios addressed by PSMChecker include:
Session Errors: "The session could not be established securely."
Process Issues: "PSMSC036E - No Process was found for image PSMInitSession.exe."
File Access Errors: "The system cannot find the file specified."
Program Launch Failures: "This initial program cannot be started: PSM@xxxxxxxx."
Specific Error Codes: PSMCP087E, PSMRC011E, PSMDU018E
Logger Errors:
PSMRD013E - "Failed to initialize logger."
PSMRD012E - "Failed to create logfile (Error%) Code (1, -1)."
Browser Initialization Errors: "Failed to initialize web browser."
WebApps Errors: "General error occurred."
In addition to addressing these issues, PSMChecker supports advanced features such as:
This tool is tailored to ensure compliance with Idira best practices, streamline maintenance, and enhance security configurations.
For GUI Mode
For Console Mode
Edit the config.yaml file inside the folder with configurations for your environment.
Open PowerShell as Administrator in the PSMChecker folder.
Run .\PSMChecker.exe --NoGui
Follow the menu options based on your needs.
User Account Checks
Detect and fix locked or disabled PSM users.
Identify and resolve users set to change their password on next logon.
Service Configuration
Verify PSM service runs as Local System user and fix if not.
Start PSM service if it is down.
Permissions and Group Validation
Ensure required "Log On To" permissions for PSM users.
Confirm PSM users are in the Remote Desktop Users local group.
Ensure PSM users have the necessary "Log On To" permissions in Active Directory (for domain users), adding the PSM if needed.
Permission Validation
Checks if PSM users have permissions on the Logs\Components folder to prevent errors like:
PSMRD013E Failed to initialize logger.
PSMRD012E Failed to create logfile (Error%) Code (1, -1).
RemoteApp Publishing Fix
Detects and resolves issues where PSMInitSession is not published as a RemoteApp.
Corrects any misconfigured TSAppAllowList registry keys pointing to PSMInitSession.exe.
Group Policy Validation
Ensures the PSM Shadow Users group is in the "Allow log on locally" policy.
Notify about "Start a program on connection" GPOs.
Ensure PSM users are part of "Allow log on through Remote Desktop Services."
Checks for Group Policies like:
"Interactive Logon: Machine Inactivity Limit" and "Screen Saver Timeout."
Notifies if they are not undefined or set to 0, recommending changes.
Service Status Checks
Verifies and fixes the status of the following services:
Secondary Logon service.
AppLocker service (Application Identity).
Log Cleanup Management
Checks log directories (Logs\Components and Logs\Components\Old).
Prompts deletion of logs if count exceeds 5,000 and recommends keeping it below 10,000.
Environment and Folder Configuration
Validate Environment tab settings.
Fix permissions for Components and Recordings folders.
Security and Registry Checks
Disable Network Level Authentication (NLA) if enabled.
Check and fix RDP-TCP registry key values.
Web App Configuration
Check Web Driver compatibility for Chrome and Edge versions.
Verify if Chrome and Edge are 32-bit.
Check and fix UAC status if enabled.
Notify about Web Dispatcher version and recommend updates if available.
Analyze AppLocker restrictions and notify if Chrome, Edge, or their drivers are blocked.
Password Sync Verification
Checks password sync between PSMConnect and PSMAdminConnect.
Provides options to reset mismatched passwords.
Object and AdminObject Checks
Verifies if the correct Object and AdminObject are configured inside PVWA for the current PSM.
Notifies and guides users on necessary changes.
Credential File Creation
Automates the creation of PSMApp and PSMGw credential files.
AppLocker Policy Management
Switch between 'Audit only' and 'Enforce rules' modes.
Clear existing policies.
Execute AppLocker scripts.
Block Analysis and Rule Creation
Analyzes AppLocker blocks for PSMConnect, PSMAdminConnect, and PSM Shadow Users (last 2 hours).
Allows rule creation for detected blocks based on user selection.
Automatically updates PSMConfigureAppLocker.xml with new rules.
Re-runs AppLocker scripts with updated rules.
System Hardening Support
Compatible with all versions:
Version 13.2 and below: Edits the script.
Version 14.0 and above: Uses the new Hardening string.
Supports both PSMHardening.ps1 and PSMConfigureAppLocker.ps1.
Shadow Users Cleanup
Deletes Shadow Users along with profiles, registry entries, and home directories.
Recommended for resolving Dispatcher-related issues.
config.yaml
# PSMChecker Configuration File
# User Guide:
# https://community.cyberark.com/s/article/PSMChecker-Tool-User-Guide
# --------------------------------------------------------------------
# PSMConnect Configuration
# --------------------------------------------------------------------
PSMConnect:
# Set to "Yes" if PSMConnect is a domain account, "No" if local.
Domain_Account: Yes
# Provide the username without the domain name.
Username: PSMConnect
# Set to "Yes" if in a different domain, "No" if in the same domain.
User_On_Different_Domain: No
# Provide the domain name only if in a different domain. Leave empty if not applicable.
Domain_Name:
# --------------------------------------------------------------------
# PSMAdminConnect Configuration
# --------------------------------------------------------------------
PSMAdminConnect:
# Set to "Yes" if PSMAdminConnect is a domain account, "No" if local.
Domain_Account: Yes
# Provide the username without the domain name.
Username: PSMAdminConnect
# Set to "Yes" if in a different domain, "No" if in the same domain.
User_On_Different_Domain: No
# Provide the domain name only if in a different domain. Leave empty if not applicable.
Domain_Name:
PSMConnect
Domain_Account: "Yes" if PSMConnect is a domain account, "No" if local.
Username: Provide the username without the domain name.
User_On_Different_Domain: "Yes" if in a different domain, "No" if in the same domain.
Domain_Name: Provide only if PSMConnect is in a different domain.
PSMAdminConnect
Domain_Account: "Yes" if PSMAdminConnect is a domain account, "No" if local.
Username: Provide the username without the domain name.
User_On_Different_Domain: "Yes" if in a different domain, "No" if in the same domain.
Domain_Name: Provide only if PSMAdminConnect is in a different domain.