Key Manager Plus Agent 

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

1. Overview

Key Manager Plus 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 Key Manager Plus server.

2. Downloading the Agent

1. Navigate to Discovery >> Agents >> Download Windows Agent. You can also download the agent from SSL >> Windows 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.

3. Installing the Agent

Once you have downloaded the agent from Key Manager Plus' web interface, follow the instructions below to install it in the target servers. The downloaded package already contains the necessary configurations needed 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.

To install Key Manager Plus agent as a Windows service,

1. Move the zip file downloaded from Key Manager Plus server to the target server.
2. Unzip its contents and place the file in an unshared folder.
3. Then, open the command prompt, navigate to the agent installation directory and type the following command: AgentInstaller.exe install <Install Key> by supplying the Install Key stored in the secure location.
4. 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 Key Manager Plus server and supply it in the agent server.

To start the agent as a Windows service,

1. Open the command prompt and navigate to the Key Manager Plus agent installation directory.
2. Then execute the following command: AgentInstaller.exe start
3. On successful installation, you can find the Key Manager Plus agent running as a service in the target server.

To stop the agent,

1. Open the command prompt and navigate to the Key Manager Plus agent installation directory.
2. Then execute the following command: AgentInstaller.exe stop

4. Managing the 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 SSL >> 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 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.

5. Discovering SSL Certificates using Agents

1. Navigate to SSL >> 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 dropdown and click Discover.
   7. If you choose Microsoft Certificate Authority, select the required checkboxes and enter the required details, mention the Time out(in seconds) and click Discover.

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

6. Signing Certificate(s) using Agent

1. Navigate to SSL >> Windows Agent and select the required agent.
2. Click Sign.
3. Select the Certificate Template or click Get Templates link to get new templates.
4. 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.
5. Select the CSR from the dropdown and click Sign.

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

7. Deploying Certificate(s) using Agent

1. Navigate to SSL >> 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.

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

1. Navigate to SSL >> 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.
5. Select the Server Type(using agent) and select the required Agent.
6. Mention the Path, and select the required checkbox(es).
7. If you select Certificate, enter the Certificate File Name.
8. If you select JKS / PKCS, mention the Store File Name.
9. Click Save.

9. Deleting Agent(s)

1. Navigate to SSL >> 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.