There are different approaches using the Remote Desktop Manager Cyberark PSM Components. Although this guide covers many ways and techniques, it cannot cover every possible avenue. Here are the main approaches and techniques associated with them:
- Initial import
- From CSV (give a CSV template)
- Synchronization (using the Remote Desktop Manager synchronizer entry)
- From Active Directory synchronizer
- From comma-separate values (CSV) synchronizer
- Dynamic utilization
- Quick connect
- Host
Initial import of Cyberark connections from CSV
Create the Cyberark PSM server entry (or multiple)
Select the Connection Mode you elect on the server.- Custom (AD Account with permissions to RDP into the PSM server and an associated account in Cyberark).
- AAM (Passwordless, see this article).
In this example, Custom is in force; Username/domain/password has been populated manually.
Then choose an RDP Template created beforehand, this template defines the setting of the initial connection on the PSM server.
Once the Cyberark PSM Server has been added, get the ID of the new entry (Property – Entry Information).
In our example, the ID is 33628378-d4a6-431f-8438-16b75921aef9.
Create the Cyberark PSM connection template
- Go to File – Templates – Templates.
- Add a new template.
- Select CyberArk PSM Connection (Pro-tip: you can filter in the Search field).
- Give the template a significant name, some of the remaining fields can be filled, but the CSV should be complete enough if filled properly.
Create a CSV file for the import
The fields are mapped like this:
Columns | Description |
---|---|
Name | Name of the entry |
ConnectionType | “CyberArk PSM Connection” |
CyberArkPSM\Component | For RDP: PSM-RDP (several options available) |
CyberArkPSM\CyberArkJumpConnectionID | ID of the Cyberark PSM Server entry |
CyberArkPSM\PrivilegedAccount | Privileged account to use |
Host | End point Hostname/IP |
Import
Once the PSM Server entry has been created, and the CSV File is populated.
- Go to File – Import – Import Session Csv Wizard.
- Browse and select the Csv File created beforehand, and click Next.
- Select Selected template.
- Select the template we created and click Finish. Note: You must tick the Generate Direct Mapping check box.
Synchronization (using the Remote Desktop Manager synchronizer entry)
Both those techniques are used to connect to a third-party repository. The first one will connect to a domain controller and list the servers and computers according to filters and settings.
The general approach and principle of using synchronizers are to keep a list of servers updated from an external information repository, such as Domain Controller, VM host, or even a simple CSV file exported periodically from another system.
Those entries are created following a template, created and configured beforehand.
It’s also granted that the Cyberark PSM integration is already configured and working (PSM Connection and Server Components, Remote Desktop Manager templates, etc.)
From Active Directory synchronizer
This approach will create entries from an LDAP request on a domain controller.
One downside of this setup is that only the Host field will be filled from the synchronizer, the Privileged Account and the component have to either remain empty, or all using the same setting (coming from the template).
Create the PSM connection template
Please refer to Create the Cyberark PSM Connection Template in the previous section.
The template will contain the Privileged account, the PSM Server and Connection Component to use.
Create an Active Directory synchronizer
- Enter the domain related data in the General tab.
- Then in the Settings tab, select your destination folder for the new entries to be created.
- Select the PSM Connection Template.
- Fill in the rest of the options and save.
Then you only have to run the Synchronizer whenever you need to refresh the server list.
From comma-separate values (CSV) synchronizer
This approach is a mix between the CSV import and the synchronizer.
In most cases, the CSV file will be generated from an external system, and then edited/processed to add and complete the information.
Please refer to Create the Cyberark PSM Connection Template from the previous section for an example of a CSV Template.
That makes it more complex, but more flexible.
Create the PSM connection template
Please refer to Create the Cyberark PSM Connection Template in the previous section.
Create a CSV Synchronizer
Enter the file path, the template to use (created beforehand) and the destination folder.
You can then run the synchronizer every time a new version of the CSV file is produced to keep you list updated.
Dynamic utilization
Quick Connect
Via the Quick Connect toolbar, you can open an ad-hoc session by specifying the host and session type. Read more about the Quick Connect function.
A Cyberark PSM Connection template is required beforehand.
- Go to File – Templates – Templates, and add a new template.
- In Host, enter $QUICK_CONNECT$
- Set a privileged account to be used.
- Select the PSM Server that this PSM connection will be using and a Connection component.
This approach would allow you to create multiple templates for PSM connections reflecting several Privileged Accounts and Connection components.
Utilization
Once a template has been created, it will be showing up in the Quick connect list of templates.
You can then type in the Host of the target endpoint, and launch the session.
Host
Take a look at this link to implement using a host for PSM Integration.
Steps are very similar to the Quick connect, the creation of the template is the exact same, except that the Host field will remain empty.
What is actually interesting about this, is that a variable can be used to populate the Privileged account.
In this example, the Custom Field #1 variable is used. Here is the template configuration:
And the Host entry: