Getting Started with Password Manager Pro - MSP Edition

ManageEngine Password Manager Pro is also available in MSP edition, which has been specially designed taking into consideration the requirements of the Managed Service Providers. If you are an MSP wishing to manage the administrative passwords of your clients separately from a single management console or offer password management services to them, you can leverage to the MSP edition.

Passwords can be securely shared between MSP administrators and their respective customers, making sure that users only get access to the passwords they own or ones that are shared with them. The solution offers the flexibility to entrust the control of the password vault to the MSP administrator, the end user or both, as desired.

The MSP edition also follows the basic password entitlement model of Password Manager Pro – that means, at any time, one will be able to view only the passwords that are owned and shared. As MSP admin, while you will be able to view the names of the organizations you manage, you will be able to view the data pertaining to all your customers only if you add their resources or if they share the resources with you. Your customers will be able to view the data belonging to their organization only.

Steps Required

  1. Prerequisites
  2. Installation Steps
  3. Silent Install

    3.1 In Windows

    3.2 In Linux

  4. Adding Users
  5. Adding Organizations

    5.1 Adding Client Organizations

    5.2 Adding Organizations Manually

    5.3 Importing Organizations from CSV

    5.4 Replicating Settings Across Client Orgs

  6. Granting Privilege to Access the Client Organization
  7. MSPOrg

1. Prerequisites

  1. For testing the MSP edition, you need to deploy a separate machine. If you try to install the MSP edition in the same machine where Password Manager Pro is running, it will uninstall the existing Password Manager Pro instance.
  2. Download and install the ManageEngine_PMP_MSP.exe

2. Installation Steps

Click here for detailed steps.

3. Silent Install

A silent install is used to install an application without the need to interact with the UI. This type of installation is helpful for applications with limited installation steps. Before commencing the silent install, certain parameters such as Name, EmailId, Path, etc., are automatically set or manually entered. Execute the commands as instructed below to install the application automatically.

3.1 Steps to Silent Install Password Manager Pro in Windows Server

3.1.1 Primary Server

  1. Download the file ManageEngine_PMP_MSP_64bit.exe.
  2. Download the installation file WindowsPrimaryMSP.iss.
  3. Open WindowsPrimaryMSP.iss file in Notepad and edit Name, MailId (mandatory), Phone, Company, Country (mandatory), and save.
  4. Move WindowsPrimaryMSP.iss file to C:\Windows\.
  5. Open Command Prompt as an administrator and navigate to the ManageEngine_PMP_MSP_64bit.exe file location.
  6. Execute the command: 

    ManageEngine_PMP_MSP_64bit.exe -a -s -f1"C:\Windows\WindowsPrimaryMSP.iss" -f2"C:\Windows\WindowsPrimaryMSP.log"

Password Manager Pro will get installed, and the service will start automatically.

3.1.2 Secondary Server

  1. Download the file ManageEngine_PMP_MSP_64bit.exe.
  2. Download the installation file WindowsSecondaryMSP.iss.
  3. Move WindowsSecondaryMSP.iss file to C:\Windows\.
  4. Open Command Prompt as administrator and navigate to the ManageEngine_PMP_MSP_64bit.exe file location.
  5. Execute the command: 

    ManageEngine_PMP_MSP_64bit.exe -a -s -f1"C:\Windows\WindowsSecondaryMSP.iss" -f2"C:\Windows\WindowsSecondaryMSP.log

Password Manager Pro will get installed, and the service will start automatically.

3.1.3 Steps to Uninstall Password Manager Pro in Windows Server

  1. Download the uninstallation file WindowsUninstallMSP.iss.
  2. Move WindowsUninstallMSP.iss file to C:\Windows\.
  3. Open Command Prompt as administrator and navigate to the ManageEngine_PMP_MSP_64bit.exe file location.
  4. Execute the command:

    ManageEngine_PMP_MSP_64bit.exe -a -s -f1"C:\Windows\WindowsUninstallMSP.iss" -f2"C:\Windows\WindowsUninstallMSP.log"

Password Manager Pro will get uninstalled.

3.2 Steps to Silent Install Password Manager Pro in Linux Server

3.2.1 Primary Server

  1. Download the file ManageEngine_PMP_MSP_64bit.bin for Linux.
  2. Download the installation file LinuxPrimaryMSP.txt.
  3. Open LinuxPrimaryMSP.txt in notepad.
  4. Mention the user installation directory's path (USER_INSTALL_DIR) and file overwrite's (-fileOverwrite_) path.
  5. Save and move LinuxPrimaryMSP.txt to home directory.
  6. Open the Console and navigate to ManageEngine_PMP_MSP_64bit.bin file location 
  7. Execute the command:

    chmod a+x ManageEngine_PMP_MSP_64bit.bin

  8. Execute the command: 

    ./ManageEngine_PMP_MSP_64bit.bin -i silent -f /home/LinuxPrimaryMSP.txt

Password Manager Pro will get installed.

3.2.2 Secondary Server

  1. Download the file ManageEngine_PMP_MSP_64bit.bin for Linux.
  2. Download the installation file LinuxSecondaryMSP.txt.
  3. Open LinuxSecondaryMSP.txt in notepad.
  4. Mention the user installation directory's path (USER_INSTALL_DIR) and file overwrite's (-fileOverwrite_) path.
  5. Save and move LinuxSecondaryMSP.txt to home directory.
  6. Open the console and navigate toManageEngine_PMP_MSP_64bit.bin file location 
  7. Execute the command:

    chmod a+x ManageEngine_PMP_MSP_64bit.bin

  8. Execute the command: 

    ./ManageEngine_PMP_MSP_64bit.bin -i silent -f /home/LinuxSecondaryMSP.txt

Password Manager Pro will get installed.

4. Adding Users (MSP org)

The MSP administration process starts with the User Management. The first step is to add users to your MSP organization. You should designate one administrator as Account Manager for each of your client organizations. Click on this link to add users for your client organizations.

5. Adding Organizations

5.1 Adding Client Organizations

After adding users, you need to add your client organizations. Navigate to Admin >> Organizations >> Organizations to add your client organizations. The organizations to be managed by the MSP should be registered with Password Manager Pro here.

You can manually add the client organizations one-by-one or import all the organizations in bulk from a CSV file.

5.2 Adding Organizations Manually

  1. Navigate to Admin >> Organizations >> Organizations.

  2. Click Add Organization.

  3. In the pop-up that opens, specify a name for the organization being added.
  4. Display Name:The name with which you wish to identify the organization being added.
    • Only alphanumeric characters without empty spaces are allowed here.
    • The name should be a single word.
    • The name that you enter here will appear in the drop-down at the top right hand side of Password Manager Pro GUI.
    • In addition, the display name will appear in Password Manager Pro login URL.

    (For example, if you assign 'xyz' as the display name, the login URL for the organization will be https://:/xyz).

  5. Account Manager: You can designate any administrator at your end (MSP) as the Account Manager for the organization being added. As the name indicates, the account manager will be the point of contact for the organization being managed and will have privileges to add and manage resources on behalf of the organization. The Account Manager with the role Admin in Password Manager Pro will be able to manage the users of the organization too. You can designate only one account manager per organization being managed. The same administrator can be made the account manager for multiple client organizations.
  6. Fill-in other details like Department, Location etc. as required.

5.3 Importing Organizations from CSV

You can import multiple organizations from a CSV file using the import wizard. The CSV should have entries regarding organization name, display name and other details in comma separated form. The entry for each organization should be in a new line. All the lines in the CSV file should be consistent and have the same number of fields. CSV files having extensions .txt and .csv are allowed.

To import organizations,

  1. Navigate to Admin >> Organizations >> Organizations >> Import From File.

  2. In the pop-up that opens,
    1. Choose the file format.
    2. Browse and select the CSV file containing the organizations details.
    3. Click Next.

    4. In the pop-up that appears, you can choose the field in the CSV file to map them with the corresponding attributes of the client organizations.
    5. Click Finish.

The result of each imported client organization will be logged in as an audit trail in the Audit tab.

5.4 Replicating Settings Across Client Orgs

Password Manager Pro allows MSP admins to replicate resource/user group structure and the settings across all managed client organizations.

Note: Please note that the option to replicate settings across client orgs is applicable only for the Enterprise edition of Password Manager Pro.

To set this up, follow the steps:

  1. Navigate to Admin >> Organizations >> Replicate Settings Across Client Orgs.
  2. Select the required options using the check-boxes.
  3. Click Save to save changes.

Listed below are some group structure and/or settings that can be applied to all client organizations as they are present in the MSP org.

  1. User groups across all client orgs.
  2. User group settings across all client orgs.
  3. Resource groups across all client orgs.
  4. Resource group to user group share settings across all client orgs.
  5. Replicate the resource/account level additional fields across all client orgs.
  6. User roles across all client orgs Overwrite/Rename (Append - MSP at the last).
  7. Resource types across all client orgs.
  8. Password policies across all client orgs.
  9. Audit operation type settings across all client orgs.
  10. Audit purge settings across all client orgs.

6. Granting Privilege to Access the Client Organization

In addition to designating an administrator as Account Manager, you can grant access privileges to the client organization to any other member of your MSP organization. An administrator with this permission will be granted admin privileges within the client organization. Similarly, if permission is granted to a password administrator or a password user, they will have their respective privileges.

Password Manager Pro requires approval before managing a client organization to ensure greater security. An administrator at the MSP can initiate organization access for a client organization, but they need to be approved by some other administrator at the MSP. It is not possible to approve the request by the one who initiates it or the one for whom it is being initiated. This is to ensure that no administrator can acquire manage permission for themselves or grant that privilege to anyone else without the approval of another administrator. This essentially means that the MSP organization should have a minimum of three administrators to carry out this process.

For example, assume the scenario when Admin A wants to provide access to Admin B for organization ABC. In this case, both Admin A (the proposer) and Admin B (the admin designate) cannot approve the access permission. Another admin, say Admin C, will have to approve the client organization request.

To mange client organizations at user/user group level, do the steps that follow:

  1. Log in to your MSP account and navigate to the Users/User Groups tab.
  2. Click the User Actions/Actions drop down icon beside the desired user/user group and select Manage Organization Access.

  3. In the pop-up that opens, select the required client organizations from the Organization List for which the user/user group to provided with access and move it right to the Grant Access section.
  4. Select the name of the request approver and click Save.

Once the administrator approves the request, the user/user group will get access to the client organization.

You can also perform the following operations from the Organization page by clicking the Actions icon beside the desired organization:

  • Manage user organization access
  • Manage user group organization access
  • Grant permission to the user organization access requests
  • Grant permission to the user groups organization access requests

You can also generate report for a client organization to know more about the users and user groups managed in it. To do this, navigate to Admin >> Organizations >> Organizations and click the report icon beside the desired client organization. In the window that opens, you will get the list of users and user groups managed at different levels.

7. MSPOrg (The default org)

By default, one organization named MSPOrg will be available. This default org is basically your organization (MSP’s organization). The passwords that you add here will pertain to your own organization and not that of your clients.

7.1 How to Manage Password for Client Organizations?

Once the organization is added, you will see the list of organizations being managed by you (i.e for which you have manage permission or for which you are the account manager) on the top band of the Password Manager Pro GUI Select Organization.

Select the required organization and proceed with resource addition. You can then share the passwords with your clients. On the other hand, if you are providing Password Management Service, you will ask your client to add passwords themselves.

7.2 How to access any specific client org?

You can access your MSP org as usual by accessing the URL https://<PMP-Host-Name>:7272/. You can select the required client organization from the top band of the Password Manager Pro GUI.

7.3 How do your clients access Password Manager Pro?

After creating an organization, you clients can connect to their organization and view/manage passwords by typing the URL as explained below:

https://<Host Name:<port>/<Name of the org>

For instance, assume that the name of the organization of your client is ‘abc’ and Password Manager Pro is running on the host “pmphost”, then the URL to connect to an organization will be: https://pmphost:7272/abc

For information on how to perform various password management features, refer to the respective sections of the help documentation.

7.4 How to delete a client organization?

You can be eligible to delete a client organization in Password Manager Pro only if you are an MSPOrg administrator. Additionally, you should also have any of the following privileges:

  1. Be the Account Manager of the client organization you want to delete.
  2. Hold Manage Organization permission for the client organization you want to delete.

To delete an organization,

  1. Navigate to Admin >> Organizations >> Organizations.

  2. Locate the client organization that you want to delete, click on Actions icons beside it, and select Delete Organization from the drop down menu. 

  3. Click OK to confirm deletion.

Note that deleting a client organization will also delete all resources and users added under it. 
Top