How to edit PSM-SSH session parameters via registry

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 Self-Hosted Articles
3 min read
L1 Bithead
No ratings
You can control the parameters of the PSMSSHClient.exe (the component in the PSM that responsible for SSH connections) from the registry.

In v7.0 and higher, the connection client is run by a windows user that is mapped to a vault user that is requesting the session. That windows user is called shadow user. Each shadow user has it's own profile on the PSM server (Computer - Properties - Advanced System Settings - User Profiles - Settings). Customized putty settings must be configured under the default user profile of the PSM server so they can be used when new shadow users connect.
 

Steps

Important notes:

1) R&D has not tested all configuration changes to the PuTTY registry settings.
2) This process would make the PSM-SSH Client a 'customized' connection component, and would not be covered under Idira support.

Do the following on the PSM server with Administrative rights:
1. Prepare the default PuTTy Session settings that will be used.
a. Install a standalone PuTTy on PSM or another machine.  
b. Launch PuTTy

c. Make the required settings that you desire, for example changing the Terminal>Keyboard>Function Keys settings to “Xterm R6”
d. Click on session again, then select on Default Settings and Save.
ka3Vy000009Tx2yIAC__eid=ka3Vy000009Tx2y&feoid=00N2J000009R3kv&refid=0EM2J000002iZju.png

d. Launch Registry and go to HKEY_CURRENT_USERS/Software/SimonTatham/PuTTY/Default%20Settings
e. Export these settings, save as a file. For example: DefaultPuTTy.reg
f. Edit the .reg file, update the key location to [HKEY_USERS\DefaultPuTTy\Software\SimonTatham\PuTTY\Sessions\Default%20Settings]

2. Next we will import this new setting to the default user profile.
a. Backup the registry of the PSM Server.
b. Open the Microsoft Windows Registry Editor and load a new hive that points to the default user's NTUSER.DAT by selecting HKEY_USERS then in the File menu the option Load Hive. Browse to and open C:\Users\Default\NTUSER.DAT (You may not be able to find NTUSER.DAT in the folder. Simply type into the filename box from C:\Users\Default and select Open.
c. Name the new hive DefaultPuTTy. The name DefaultPuTTy should be used as it is referring to a name in the exported reg file done previously.
d. Merge (or run) the attached DefaultPuTTy.reg file that was created as per the instructions above. The simplest way is by double clicking on the DefaultPuTTy.reg file.
e. You will now see in the DefaultPuTTy hive in RegEdit and new keys in ~/Software/SimonTatham/PuTTY/Default%20Settings.
f. Once you've completed your changes Select the hive name under HKEY_Users then unload it by selecting from the File menu the option Unload Hive. You will see the DefaultPuTTy hive is gone. The changes are applied to the NTUSER.DAT file so new profiles will use the settings.

3. Before testing a new connection, we need to remove the ShadowUsers profiles
a. Go into Computer - Properties - Advanced System Settings - User Profiles - Settings. Delete all entries with PSM- and followed by numbers. Do not delete PSMConnect and PSMAdminConnect accounts.
b. Now we can try the PSM-SSH connection. The new settings will be inherited.

Rate this article:
  • 10146 Views
  • 0 comments
  • 0 Likes
Article Dashboard
Version history
Last Updated:
‎11-05-2026 12:10 PM
Updated by: