SSL Agent

PAM360 allows you 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 PAM360.

  1. Downloading the SSL Agent
  2. Installing the SSL Agent
  3. Managing the SSL Agents 
  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 SSL Agent

The agent used to perform certificate management operations on remote machines is dynamically created by the PAM360 server and is available for download from within the interface. To download the SSL 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 SSL 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 SSL agent as a Windows service:

  1. Move the .zip file downloaded from the PAM360 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.
  4. 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 PAM360 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 PAM360 agent installation directory.
  2. Execute the following command: AgentInstaller.exe start.

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

Steps to stop the agent:

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

3. Managing the SSL Agents

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

To manage SSL agents:

  1. Navigate to Certificates >> Windows Agent.
  2. In the window that opens, you will be able to see a list of SSL agents installed on remote resources along with insights such as Host Name, IP address, User Name, Version, Installed TimeHeartBeat 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 Agent

  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  
    3. If you choose to Discover by  
    4. 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 up to five templates from the dropdown. Mention the Time out(in seconds) and click Discover.

  4. The certificates are successfully discovered and imported into PAM360 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 >> Discovery and select the agent.
  2. Select the Certificate Template 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 dropdown 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 checkbox(es) 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. If you choose the Server Type as Microsoft Certificate Store, select Computer and/or User account to deploy the certificate to the selected account.
    7. Now, select Enable PrivateKey Export from MS Certificate Store after deployment to export private key from the certificate store.
    8. 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. To check the Sync Status using the agent, select the desired certificates and click the Edit button.
    1. Select Sync Check With Agent and click Save.
  8. 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.

  9. To check the Sync Status of the server, select a server and click Check Status on the top pane.
  10. Now, PAM360 will check the Sync Status and will display it on the corresponding server's column.

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.
Top