Key Manager Plus Agent

Password Manager Pro allows users to discover the SSL Certificates deployed across their network through agents. The agent used to perform certificate management operations on remote machines is dynamically created by the Password Manager Pro.

1. Downloading the KMP Agent
2. Installing the KMP Agent
3. Managing the KMP Agent 
4. Discovering SSL Certificates using Agent
5. Signing Certificate(s) using Agent
6. Deploying Certificate(s) using Agent
7. Deploying Certificate(s) in Multiple Servers using Agent
8. Deleting Agent(s)

1. Downloading the KMP Agent

The agent used to perform certificate management operations on remote machines is dynamically created by the Password Manager Pro server and is available for download from within the interface. To download the KMP Windows agent:

1. Navigate to Certificates >> Discovery >> Agent >> Download Windows Agent.
2. From the pop up that opens, download the agent based on your server configuration. Also, copy and save the Install Key in a secure location.

   

2. Installing the KMP Agent

Once you have downloaded the agent, follow the instructions below to install it in the target servers. The downloaded package already contains the configurations necessary to perform the required operations. Just make sure the account in the server in which the agent is installed has sufficient privileges to perform certificate discovery.

Steps to Install KMP Agent as a Windows Service:

1. Move the .zip file downloaded from the Password Manager Pro server to the target server.
2. Unzip its contents and place the file in an unshared folder.
3. Open the command prompt, navigate to the agent installation directory and type the command: AgentInstaller.exe install < Install Key > by supplying the Install Key stored in the secure location.

Note: The Install Key is revoked after being used for a single installation. If you want to perform another installation of the agent, you need to regenerate the Install Key from the Password Manager Pro server and supply it in the agent server.

Steps to Start the Agent as a Windows Service:

1. Open the command prompt and navigate to the Password Manager Pro agent installation directory.
2. Execute the following command: AgentInstaller.exe start.

On successful installation, you can find the KMP agent running as a service in the target server.

Steps to Stop the Agent:

1. Open the command prompt and navigate to the KMP agent installation directory.
2. Execute the following command: AgentInstaller.exe stop

3. Managing the KMP Agent

Key Manager Plus provides administrators insights about agent activity and allows management of agents installed on various target resources.

To manage Key Manager Plus agents,

1. Navigate to Certificates >> Windows Agent.
2. In the window that opens, you will be able to see a list of Key Manager Plus agents installed on remote resources along with insights such as Host Name, IP address, User Name, Version, Installed Time, HeartBeat Interval, Last HeartBeat, and last Operation performed.
3. If you want to delete an agent, you can do so by choosing the agent and clicking Delete from the top menu.

   

4. Discovering SSL Certificates using Agents

1. Navigate to Certificates >> Windows Agent and select the agent.
2. Click Discovery.
3. In the pop-up that appears,
   1. Choose DMZ to discover certificates from servers in the demilitarized zone.
   2. Choose to Discover by  Hostname / IP Address or IP Address Range.
   3. If you choose to Discover by  Hostname / IP Address, mention the Hostname / IP Address, Time out(in seconds), Port and click Discover.
   4. Choose Certificate Store or Microsoft Certificate Authority to perform agent-based discovery of local CA certificates.
   5. If you choose Certificate Store, enter Store name and Time out(in seconds), Port.
   6. To get Store Name, click Get Stores link and select from the drop down and click Discover.
   7. If you choose Microsoft Certificate Authority, select the required checkboxes and enter the required details. If you select Template Name / ODI, mention the template name or click Get Templates to get a list of templates. You can select upto five templates from the drop down. Mention the Time out (in seconds) and click Discover.

      

4. The certificates are successfully discovered and imported into Password Manager Pro centralized certificate repository. You can view them from Certificates >> Windows Agent.
   
5. After certificate discovery, click the Host Name of an agent to view all certificates associated with that particular agent.

   

   

5. Signing Certificate(s) using Agent

1. Navigate to Certificates >> Windows Agent, select the agent and click Sign.
2. Mention the Template Name / ODI or click Get Templates link to get new templates.
3. Mention the Agent Time out in seconds within which the agent should respond. If the agent doesn't respond within the timeout period, the operation will be audited as failed.
4. Select the CSR from the drop down and click Sign.

Now the certificates are successfully signed and will be available to the repository.

6. Deploying Certificate(s) using Agent

1. Navigate to Certificates >> Windows Agent and select the agent.

   

2. Click Deploy and select the required server from the drop-down. 
   1. If you choose Windows (using agent), select the Certificate Group, mention the Path and select the checkboxe(s) certificate and/or JKS/PKCS based on your requirement and click Deploy.
   2. If you choose MS Store (using agent), select the Certificate Group and click Deploy.
   3. If you choose IIS (using agent), select the Certificate Group and click Deploy.
   4. If you choose IIS Binding (using agent), select the Certificate Group, mention the Site Name and click Get Bindings.
   5. Click Manage link to manage the certificate group.
   6. Click Save to save the changes.
3. Now, the certificates will be deployed and will be available under SSL tab.

7. Deploying Certificate(s) in Multiple Servers using Agent

1. Navigate to Certificates >> Certificates tab and click multiple servers icon corresponding to the required certificate.
2. A window opens listing the servers in which the certificate is deployed along with other information such as IP address, Port and certificate validity.
3. The DNS name should be same as the Agent's name and this agent should be running under the DNS server.
4. To modify the Server details, click credentials icon corresponding to the required certificate.
   1. Select the Deployment Type as Agent.
   2. Select the Server Type and select the required Agent.
   3. Mention the Path, and select the required checkbox(es).
   4. If you select Certificate, enter the Certificate File Name.
   5. If you select JKS / PKCS, mention the Store File Name.
   6. Click Save.

      

5. To edit a deployed server, click edit icon corresponding to required certificate.
   1. In the pop-up that appears, you will be able to edit the DNS Name, IP Address and Port.
   2. You can choose to Deploy Certificate to all servers on Auto Renewal. 
   3. Click Save.

   Note: You will be able to deploy certificate to all servers on auto renewal only if the user credentials are available.

6. To auto deploy certificates after renewal, select the desired certificates and click the Edit button.
   1. Select Enable and click Save in the pop-up that appears. 
7. Click Add to Add Deployed Servers. 
   1. In the pop-up that appears, mention the DNS Name, IP Address and Port.
   2. You can choose to Deploy Certificate to all servers on Auto Renewal.
   3. Click Save.
   4. You can also add deployed servers from Certificates >> Certificates >> More >> Add Deployed Server.

Now, the certificates have been successfully deployed using agent. To know more about SSL certificate deployment click here.

8. Deleting Agent(s)

1. Navigate to Certificates >> Windows Agent and select the required Agent(s) to be deleted and click Delete.
2. Click Ok in the pop-up that appears.
3. The certificate will be deleted from the list.