PSMChecker Tool User Guide

cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 
Announcements

Welcome Idira to LIVEcommunity!

Our community just got stronger! Explore new identity security resources, connect with experts, and discover more ways to learn and collaborate.

Meet Idira

PAM SaaS Articles
6 min read
L0 Member
No ratings

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'.

Marketplace FAQ

 

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:

  • Checking and fixing domain and local PSM user configurations.

  • Service status checks and starting services if down.

  • Logs cleanup.

  • Group policy validation.

  • AppLocker policy analysis, rule creation, and execution.

  • WebApp compatibility checks and browser validations.

  • Password Sync Verification for PSMConnect and PSMAdminConnect accounts.

  • Credential File Creation for PSMApp and PSMGw.

  • Object and AdminObject Configuration Checks for the PSM inside the PVWA.

  • Shadow Users cleanup, including profiles, registry entries, and home directories.

  • System hardening support for all versions.

This tool is tailored to ensure compliance with Idira best practices, streamline maintenance, and enhance security configurations.

Steps

Usage Instructions

For GUI Mode

  1. Run the PSMChecker as Administrator.

For Console Mode

  1. Edit the config.yaml file inside the folder with configurations for your environment.

  2. Open PowerShell as Administrator in the PSMChecker folder.

  3. Run .\PSMChecker.exe --NoGui

  4. Follow the menu options based on your needs.


Key Features

1. PSM User and Windows Configuration Checks

  • 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.

2. Web Application Checks and Fixes

  • 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.

3. Idira Environment Configurations - Self-Hosted only

  • 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.

4. AppLocker Policy Management and Analysis

  • 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.

5. Run the Hardening

  • 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.

6. Shadow Users Cleanup

  • Shadow Users Cleanup

    • Deletes Shadow Users along with profiles, registry entries, and home directories.

    • Recommended for resolving Dispatcher-related issues.


Configuration Setup

Configuration File - 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: 

Configuration Details

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.


Rate this article:
  • 37291 Views
  • 0 comments
  • 0 Likes
Article Dashboard
Version history
Last Updated:
‎10-28-2026 03:46 AM
Updated by: