Manage SSL Certificates

Overview

Create, discover and store SSL certificates in the centralized repository of Password Manager Pro (PMP). Raise requests for new certificates and domain additions to the existing certificates. You receive notifications when the certificates are about to expire, to help you with their timely renewal. 

Use Password Manager Pro to:

  1. Create, discover, or import self-signed or CA issued certificates in the network.
  2. Generate Certificate Signing Request (CSR).
  3. Add requests for new certificates or adding a sub domain to an existing certificate.
  4. Receive notifications when certificates are about to expire.

(Applicable from PMP version 10404 onwards)
Prerequisite:

PMP performs SSL certificate discovery and SSL certificate deployment by initiating a remote connection to the target machines. To allow PMP to do that, complete the below steps:

1. Download the .zip folder from this link and extract the remcom.exe file from the .zip folder.
2. Copy and paste the remcom.exe file into the <PMP Installation Folder>/bin directory.

Steps to Manage SSL Certificates

  1. Discovering certificates in your network
    1.1 Discovering SSL Certificates on Demand
    1.2 Discovering SSL Certificates from SMTP Servers
    1.3 Discovering SSL Certificates deployed to Load Balancers
    1.4 Discovering SSL Certificates using the Key Manager Plus (KMP) Agent
    1.5 Discovering SSL Certificates Automatically through Schedules
    1.6 Discovering SSL Certificates Hosted on AWS (ACM & IAM)
    1.7 Discovering Certificates Mapped to User Accounts in Active Directory
  2. Creating Self-Signed Certificates
  3. Generating CSRs
    3.1 Managing CSR
  4. Certificate Signing
    4.1 Microsoft Certificate Authority
    4.2 Microsoft CA with Agent
    4.3 Sign with Root CA
    4.4 Auto Renewal
  5. Importing Certificates
  6. Deleting Certificates
  7. Certificate Requests
    7.1 Adding Certificate Request
    7.2 Certificate Request Status
    7.3 Terminating the Certificate Request Life-Cycle
  8. Customizing Expiry Notification Schedule
  9. Tracking Domain Expiration through WHOIS Lookup
  10. SSL Certificate Group
    10.1 Creating Certificate Groups
    10.2 Editing Certificate Groups
    10.3 Deleting Certificate Groups

1. Discovering Certificates in your Network

You can automatically discover all the certificates available in your network using Password Manager Pro, irrespective of the CA. You can discover the certificates anytime as needed or periodically based on scheduled tasks. The discovery options are quite flexible - you can discover certificates from a single server or multiple servers, and from multiple ports, at one go.

1.1 Discovering SSL Certificates On Demand

To discover the certificates manually:

  1. Go to Certificates >> Discovery >> Certificates.
  2. Select an option for the type of discovery.
  3. Hostname/IP address – Enter the name or IP address of the server from which the SSL certificates are to be discovered.
  4. IP address range – Specify an IP range and discover all the SSL certificates available in the servers falling under the range.
  5. From file – If you have a list of the servers in which certificates are available in your network saved as a text file, it can be loaded directly and all these certificates can be discovered.
  6. Subnet – Use this option to discover resources from specific subnetworks within an IP range.
  7. In SSL Hostname discovery, if you want the host name to resolve to a specific IP address, provide the IP address after host name separated by colon (:) as shown below:
    example.com:172.168.203.56.
    Same format can be provided in From file discovery as well.

Note: The file to be imported must be a text file containing the Host Name or IP addresses of individual servers, entered as separate lines. Enter the ports to scan on each server, separated by a space, entered on separate lines as illustrated in the below table. If you do not specify any port, SSL certificates using the default port 443 will be discovered.


0.0.0.0

6565

test-username-10

443

192.168.20.20 7272

  1. For bulk discovery using IP address range and Subnet options, there is an Exclude IP Address field that allows you to exclude specific resources from being discovered. Specify the IP addresses of the resources that need to be excluded one below another. 
  2. Specify values for the Time out and the Port options.
    1. Time out: Refers to the number of seconds the application tries to discover the certificates (each). The default value is 5 seconds.
    2. Port: It refers to the port on the end terminal used for SSH communication. Port 443 is used by default for SSL certificates.
  3. Notes:

    1. You can specify multiple ports separated by commas for the discovery of SSL certificates in a single discovery instance.
    2. During SSL discovery or when manually adding certificates to the PMP repository, you can exclude specific certificates by providing their details (common name and serial number) under Admin >> SSL Certificates >> Excluded Certificates. The specified certificate will be excluded from being imported into the PMP certificate repository during discovery or manual addition.
  4. Click Discover. You will be redirected to the Discovery Status page where the status of the current discovery instance is updated.

1.2 Discovering SSL Certificates from SMTP Servers

You can discover SSL certificates used by mail servers present in your network and consolidate them in Password Manager Pro's centralized certificate repository. To perform mail server certificate discovery:

  1. Navigate to Certificates >> Discovery >> Mail Server Certificate.
  2. Provide the Hostname / IP address from which the certificate is to be discovered and specify the port number. You can specify multiple port values by separating them with commas.
  3. Click Discover. On successful discovery, the certificates are fetched from the specified resources and added to Password Manager Pro's repository.

1.3 Discovering SSL Certificates Deployed to Load Balancers

Password Manager Pro allows you to discover SSL certificates deployed to load balancers, within your network, and consolidate them in its secure, centralized repository. As of now, Password Manager Pro supports discovery of certificates from Linux-based load balancers only (i.e., Nginx, F5, etc) and the process is tunnelled via SSH. To perform load balancer certificate discovery:

  1. Navigate to Certificates >> Discovery >> Load Balancer.
  2. Specify the Server Name, Port, User Name, Credential Type, Password and Path.
  3. You can opt for a key-based authentication for password-less resources by choosing the Select Key option. Upload the private key associated with the required user account and specify the key passphrase.
  4. Once you have provided the user credentials, specify the path to the folder in the server from where the certificates have to be discovered.
  5. Choose certificates from the Discover certificate list and click Discover. The certificates are successfully discovered and imported into Password Manager Pro's centralized certificate repository. You can view them from the Certificates tab. The Discover certificate list option fetches all the certificates available in the specified path and helps you choose certificates that you wish to discover and import.
  6. Certificate files with the extensions .keystore and .pfx are not automatically imported into the certificate repository; they require their passphrases to be provided in order to be imported into Password Manager Pro. To import these files, click JKS / PKCS at the top-right corner of the window. In the window that pops up, choose the certificate file(s) that you wish to import and click Import from the top menu. In the pop up that opens, provide the file passphrase(s) and again click Import.
  7. The chosen certificate files are successfully imported and added to Password Manager Pro's certificate repository.

1.4 Discovering SSL Certificates using the Key Manager Plus (KMP) Agent

You can discover SSL certificates deployed across your network using the KMP agent right from the Password Manager Pro web interface. This functionality enables you to download and deploy KMP Windows agent to target systems. It also allows you to discover and import the certificates from those systems into a centralized certificate repository directly from the Password Manager Pro web interface. The server(s) in which the agent is deployed is connected to the Password Manager Pro server via a secure HTTPS connection.

Discovering  certificates through the KMP agent is helpful in the following scenarios:

  1. When the administrative credentials of the target server(s) required to perform the discovery operation are not available in the Password Manager Pro server.
  2. When you have to discover the certificates from servers that Password Manager Pro doesn't have direct access to say, for instance, the servers in demilitarized zones (DMZs). In such cases, the agent is usually installed in an intermediate jump server which has the permission to access the remote servers and pass on the required information to the Password Manager Pro server.

To discover the SSL certificates using the KMP agent, you need to download and install the agent first. Follow the steps below:

Steps to perform SSL certificate discovery through Key Manager Plus agent:

  1. Navigate to Certificates >> Discovery >> Agent.
  2. Choose the type of discovery you want to perform—Domain-based, Certificate Store or certificates issued by Microsoft Certificate Authority.
  3. Select the required agent from the drop down to perform the operation.
  4. If the agent is busy, wait and try again after sometime.
  5. For Microsoft CA discovery, you can choose to exclude expired / revoked certificates or perform discovery based on issue date or certificate template using the filters provided.
  6. Click Discover.

The certificates are discovered from the servers in which the agent is installed and imported into Password manager Pro's certificate repository.

1.5 Discovering SSL Certificates Automatically through Schedules

SSL Certificate discovery can also be scheduled to occur at periodic intervals.

  1. Navigate to Admin >> SSH/SSL Config >> Schedule.
  2. Click the Add Schedule button.
  3. In the Add Schedule window, enter a name for the schedule and select the type of schedule as SSL Discovery.
  4. Specify the start and end IP addresses and the port on the end terminal to check for SSL certificates.
  5. Select the recurrence type – hourly, daily, weekly, monthly, or once only. Set the starting time, date, or day corresponding to the option chosen.
  6. Enter the email addresses of the users to be notified. The email settings can be configured from the Settings >> Mail Server Settings tab.
  7. Click the Save button.

You will get a message confirming addition of a new schedule.

1.6 Discovering SSL Certificates Hosted on AWS (ACM & IAM)

Password Manager Pro enables you to discover, import, and configure expiry notifications for SSL certificates hosted in the following Amazon Web Services: AWS Certificate Manager (ACM) and AWS Identity and Access Management (IAM).

Follow the steps below to discover and import SSL certificates from ACM / IAM into Password Manager Pro.

Step 1: Configure AWS credentials in Password Manager Pro

To add your AWS credentials in Password Manager Pro,

  1. Navigate to Certificates >> Discovery >> AWS >> Manage AWS Credential and click Add.
  2. In the Create AWS Credentials window that opens, provide the Credential Name, Description, Access Key and Secret Key.
  3. Use the Test Login option and check if the login is successful. You will be notified if the login is successful
  4. Then click Save. The credentials are successfully saved in Password Manager Pro.

Step 2: Discovery and Import

  1. Switch to Certificates >> Discovery >> AWS tab.
  2. Choose the appropriate AWS Credentials from among the ones configured in Password Manager Pro or provide your Access Key and Secret Key.
  3. Choose the required AWS Service from which certificates need to be imported: ACM or IAM.
  4. To import certificates from ACM, select ACM under AWS service and choose the service Region.
  5. Click Discover.
  6. Certificates are discovered from resources in the selected region and imported into Password Manager Pro.
  7. To import certificates from IAM, specify the required AWS User Name(s) or use the List AWS User Names option to retrieve the usernames. Choose the required usernames and click Discover.
  8. You can also choose to import server certificates for the corresponding AWS users by checking the Include Server Certificate option.

User certificates are imported into Password Manager Pro.

1.7 Discovering Certificates Mapped to User Accounts in Active Directory

Password Manager Pro helps you discover and manage the certificates mapped to user accounts in Active Directory.

To perform AD user certificate discovery,

  1. Navigate to Certificates >> Discovery >> AD User Certificate.
  2. Select the required Domain Name, which forms part of the AD from the drop-down.
  3. Specify the DNS name of the domain controller. This domain controller will be the primary domain controller.
  4. In case, the primary domain controller is down, secondary domain controllers can be used. If you have secondary domain controllers, specify their DNS names in comma separated form. One of the available secondary domain controllers will be used. When you use SSL mode, make sure the DNS name specified here matches the CN (common name) specified in the SSL certificate for the domain controller.
  5. Enter a valid user credential (user name and password) of an user account within the particular domain. Then enter the users / user groups / OUs in which you want to perform the certificate discovery and click Import. To perform certificate discovery for groups/OUs as a whole, choose Groups/OU tree Import type and select the required groups from the drop down list.
  6. Password Manager Pro also provides an option to import AD users while performing the certificate discovery. Enable the check box Import AD users to import those AD user accounts into Password Manager Pro for which the certificate discovery is done.
  7. The discovered certificates automatically get added to the certificate repository of Password Manager Pro.

1.7.1 Managing Certificates from MS Certificate Store and Local CA

Password Manager Pro helps you request, acquire, discover, consolidate, track and manage certificates from MS Certificate Store and those issued by Local certificate authority. Before importing / acquiring certificates from MS Certificate Store and Local CA, ensure that you use your domain administrator account as Password Manager Pro' service logon account.

  1. Navigate to Certificates >> Discovery >> MS Certificate Store.
  2. To discover and import certificates issued by Microsoft CA alone, select Microsoft Certificate Authority option from the drop down. In the process, you can choose to exclude expired / revoked certificates by de-selecting the check-boxes below.
  3. To discover all the certificates from MS certificates store, choose Certificate Store type from the dropdown menu.
  4. Specify the other details such as the name of the Windows domain controller machine and domain admin credentials.
  5. Specify the certificate store name from which the certificates are to be discovered and imported.
    i.e., Following format to be used while specifying the certificate store name:\\server_name\store_name
    e.g., server_name\Root (To discover certificates from trusted root certification authorities)
    server_name\My (To discover personal certificates)
  6. Or you can also click Get stores to fetch the list of stores available in the Windows Domain Controller and choose the required certificate store that you want to discover.
  7. Click Discover.

You can view the discovered certificates in Certificates tab.

Notes:

  1. During Windows Certificate Store discovery, if the target server name is not specified, choosing Get Stores option will list down all the certificate stores available in the local host.
  2. To discover certificates issued by a particular MSCA, select Type as Microsoft Certificate Authority from the drop-down, enter the Server Name, required credentials, and enter an MSCA name in the Microsoft Certificate Authority text box. Please note that this text box will be visible only if your Password Manager Pro server is installed in a Windows Server machine.


To request and acquire certificates stored in Local CA from Password Manager Pro, you have to initially generate a certificate signing request, then get it signed from the local certificate authority using the steps mentioned below:

  1. Navigate to Certificates >> CSR and click Create.
  2. In the Create CSR window that opens, fill in the domain details, organization details, choose the key algorithm, key size, signature algorithm, keystore type and specify the validity (days) and keystore password and click Create.

  3. If you want to generate a CSR from an already existing key, choose Create CSR From Private Key option and specify the key location, password and click Create. 
  4. The CSR will be generated and you can view it from Certificates >> CSR tab.

You can also get the CSR signed from Microsoft Certificate Authority directly from Password Manager Pro itself.

  1. Navigate to Certificates >> CSR tab, select the required CSR and click Sign from the options available above the CSR table view.  
  2. In the dialog box that opens, provide the name of the server that runs the internal certificate authority, CA name and choose the certificate template based on your requirement. Click Sign.
  3. The CSR is signed and the issued certificate can be viewed from the Certificates tab.

1.7.2 The Centralized Certificate Repository

All the discovered SSL certificates, those that are discovered manually as well as those discovered through scheduled discovery operations are automatically added to the centralized repository of Password Manager Pro. You can view these certificates under the Certificates >> Certificates option in the user interface.

1.7.3 Exporting Private Key/Keystore file

Password Manager Pro allows you to identify and export the private keys / keystore files of SSL certificates stored in the certificate repository. You can also export certificates in other formats such as PKCS12/PFX or PEM format. Click the Keystore icon () enabled beside the certificates for which the private keys are managed using Password Manager Pro.

To export the private key or the certificate file:

  1. Navigate to Certificates >> Certificates.
  2. Click the Keystore icon () beside the certificate for which you need to export the private key.
  3. From the dropdown, choose from the following options as per your requirement:
    1. Export Keystore / JKS: The keystore file of the selected certificate will be downloaded.
    2. Export PKCS12/PFX: The selected certificate will be downloaded in the PFX format.
    3. Export PEM: The selected certificate will be downloaded in the PEM (Privacy Enhanced Mail) format.
    4. Export Private Key: The private key of the selected certificate will be downloaded.
  4. The corresponding certificate is downloaded in the selected format.

1.7.4 Tracking and Managing Various Certificate Versions

Sometimes, there occurs a situation where you have to use different certificates on different end-servers for the same domain. Under such circumstances, it is necessary for you to track the usage and expiry of all these certificates individually even though they represent a common domain. Monitoring various such certificate versions manually is daunting and error-prone. Password Manager Pro helps you simultaneously track and manage the usage and expiry of various certificate versions from a single window.

To Track Certificate Versions:

  1. Navigate to Certificates tab.
  2. Click the Certificate history icon () present in the right corner of the table view, corresponding to the required certificate.
  3. In the certificate history window that opens, choose the certificate version you wish to manage and click the certificate settings icon. Click Manage Certificate.
  4. The particular certificate version is set for managing and Password Manager Pro starts tracking the usage and expiry individually for that version. 
  5. Repeat the same procedure for all the certificate versions that you wish to manage.

1.7.5 Updating Servers with Latest Certificate Versions

In case of wildcard certificates or single SSL certificate deployed to multiple servers, it is necessary to keep track of servers in which the certificate is deployed and also check if the latest certificate version is in use. Password Manager Pro helps you ensure this.

  1. Navigate to Certificates >> Certificates tab.
  2. Click the Certificate History icon () corresponding to the required certificate.
  3. A window opens listing the various versions of the certificate. Ensure that the latest version of the certificate is set as the main certificate. If not, click the () icon beside the required version to set that version of certificate as main certificate in the Password Manager Pro repository.
  4. Then again, navigate to Certificates >> Certificates tab and click Multiple servers icon () corresponding to the required certificate.
  5. A window opens listing the servers in which the certificate is deployed along with other information such as IP address, port and certificate validity.
  6. If any of the servers listed has an older / expired version of the certificate, update it with the latest version immediately. Select the server and then click Deploy. Refer to the detailed deployment procedure here.

Also, you can edit details pertaining to a particular certificate or delete irrelevant certificates by selecting the certificate and clicking the More dropdown.

2. Creating Self-Signed Certificates

Password Manager Pro allows administrators to create their own self-signed certificates using Java keytool. These certificates are automatically imported into the Password Manager Pro repository on successful creation.

To create a self-signed certificate using Password Manager Pro:

  1. Navigate to the Certificates >> Certificates >> Create.
  2. Enter the details of the organization and certificate validity, and select the Key Algorithm and LengthSignature Algorithm, and enter a key Store Password in the Create certificate tab.
  3. Choose the Validity Type as Days and specify the number of days for which the certificate will be valid.
  4. To create an ephemeral certificate with limited validity period, choose the Validity Type as Hours or Minutes and provide the validity period. The certificate will expire after the specified time.
  5. You can denominate the certificate to be generated as a root certificate by enabling the Generate root certificate check-box. 
  6. To add optional properties to the new certificate, click Advanced Options to expand the menu. Here, there are two categories of options, Key Usage and Extended Key Usage. Select the required options to set the preferred flags for the certificate to denote the purpose for which the new certificate may be used. The Key Usage options include Non Repudiation, Digital Signature, Data or Key Encipherment, Server/Client Authentication etc. You can choose the properties and mark them as critical by selecting the Critical checkbox.
  7. Click the Create button. You will be redirected to the certificate window where the certificate content is displayed.
  8. You can copy the certificate content, or export the certificate to required email or system.
    1. Email – Select this check box to send the certificate file via email to the specified mail id.
    2. Export – Select this check box to export the file to your system.
  9. Both the options take effect once you click the Save button.
  10. Click the Save button to save the certificate in the certificate repository, and export the certificate file, if opted in earlier step.

    (Applicable from build 11000 onwards)

    Note:

    Apart from having a wildcard certificate name in the Common Name field, you can add the wildcard name in the SAN field while creating a self-signed certificate. With wildcard certificates, one can secure an unlimited number of subdomains for a registered base-domain.

    For example, consider the base-domain zoho.com, a wildcard certificate for *.zoho.com can secure any-subdomain.zoho.com. The asterisk (*) is the wildcard that corresponds to any valid subdomain.

3. Generating CSRs

To generate a CSR using Java keytool from Password Manager Pro:

  1. Navigate to the Certificates >> CSR. You will see all the available CSRs in a list view along with their details such as Domain Name, Created By, Created Time, Key Size, Key Algorithm, etc.
  2. Click Create to generate a new CSR. In the form displayed, do the following:
    1. Choose between Create CSR manually or Create CSR from Keystore.You can also choose from a CSR template. Click the Manage CSR Templates link and choose one. 
    2. If you choose to Create CSR from Keystore:
      1. Select the Keystore file by clicking Browse.
      2. Enter the Private Key Password and click Create.
    3. If you choose to Create CSR manually:
      1. Specify the required details such as Common Name, SAN, Organization Unit, Organization, Location, and State.
      2. Select the Key Algorithm, Key Size, Signature Algorithm, and Keystore Type.
      3. Choose a Validity Type (Days, Hours or Minutes) and mention the Validity.
      4. Enter the Store Password.
      5. Select theSign Type and enter the required details.
      6. You can also sign your CSR later by not choosing the Sign Type now. To know more about signing the CSR later, click here.
      7. Click Create. You will be redirected to a CSR window where the CSR content is displayed.

You have successfully created a CSR and it has been added to the list view. 

      (Applicable from build 11000 onwards)

      Note:

      Apart from having a wildcard certificate name in the Common Name field, you can add the wildcard name in the SAN field while creating a self-signed certificate. With wildcard certificates, one can secure an unlimited number of subdomains for a registered base-domain.

      For example, consider the base-domain zoho.com, a wildcard certificate for *.zoho.com can secure any-subdomain.zoho.com. The asterisk (*) is the wildcard that corresponds to any valid subdomain.

Note: Self-signed certificates and CSRs can be generated using RSA / DSA / EC key algorithms and SHA signature algorithm as per the details below:

  • RSA – 1024, 2048, or 4096 bit keys; & SHA-2 (256, 384, or 512 bit) signature.
  • DSA – 512, or 1024 bit keys; & SHA-1 (160 bit) signature.
  • EC -128, or 256 bit keys; & SHA-2 (256, 384, or 512 bit) signature.

3.1 Managing CSRs

  1. Show Passphrase: The show passphrase icon () corresponding to every CSR allows administrators to view the keystore passwords of respective CSR files.
  2. Export: You can export and mail the CSR to a specified mail id by using the icons in the CSR displayed in the list view.
  3. Import: If you choose to import a CSR, click Import.A pop-up appears.
    1. Browse and Select a CSR file and Select a Key file.
    2. Enter the Private Key Password and click Import.
    3. Your CSR has been successfully imported and can be viewed in the list view.
    4. Password Manager Pro automatically pins the certificate file with its corresponding private key and adds it to its centralized repository.
  4. Delete: To Delete a CSR, select the CSR you wish to delete and click Delete.
    1. In the pop-up that appears, click Ok.
    2. You have successfully deleted the selected CSR.
  5. CSR Template: Click CSR Template to add, delete or manage the templates. These templates after generated can be used while generating CSR’s.

Besides generating CSRs from Password Manager Pro, you can also upload CSRs generated from outside the application and track their statuses from Password Manager Pro using the Import option in the top menu.

4. Certificate Signing

Password Manager Pro provides the option to sign and issue certificates to all clients in your network either from your Microsoft Certificate Authority or using a custom root CA certificate that is trusted within your environment.

To request and acquire certificates from Local CA from Password Manager Pro, you have to initially generate a certificate signing request, then get it signed from the local certificate authority using the steps mentioned below.

There are three ways to sign your certificates:

  1. MS Certificate Authority
  2. MS CA with Agent
  3. Sign with Root

Navigate to Certificates >> CSR.

4.1 Microsoft Certificate Authority

You can get the CSR signed from Microsoft Certificate Authority from Password Manager Pro.

  1. Select the required CSR and click Sign from the top menu. 
  2. Select the Sign Type as Microsoft Certificate Authority.
  3. Mention the Server Name that runs the internal CA and also the Certificate Authority name.
  4. Select the Certificate Template based on your requirement or select any of the pre-defined templates by clicking the Get Template link and click Sign.

The CSR is signed and the issued certificate can be viewed from Certificates >> Certificates.

Notes: 

  1. Start Password Manager Pro using your domain administrator account to begin management of certificates from Microsoft Certificate Store and those issued by your Local CA. If you use a domain service account to run Password Manager Pro, make sure that you have configured it in your local admin group beforehand.
  2. During MS Certificate Store discovery, Get Stores option will list all stores available in the local host if the Server Name field is left empty.
  3. For MS CA auto-renewal to take effect, the certificate(s) need to be of type Microsoft CA. For manually added certificates, the certificate type needs to be changed to Microsoft CA using Edit option from More top menu.

4.2 Microsoft CA with Agent

  1. Select the required CSR from the list view and click Sign from the top menu.
  2. In the pop-up that appears,
    1. Select the Sign Type as Microsoft CA with Agent.
    2. Select the Agent from the list available in the drop-down. You can also Manage the agent by clicking the link. To know more about managing the agent, click here.
    3. Specify the Certificate Template or click Get Template to get new templates. 
    4. Click Sign.

The CSR is signed and the issued certificate can be viewed from Certificates >> Certificates.

4.3 Sign with Root

Password Manager Pro provides the option to sign and issue certificates to all clients in your network either from your Microsoft Certificate Authority or using a custom root CA certificate that is trusted within your environment.

  1. Create a custom root CA
  2. Sign certificates with the custom root CA
  3. Deploy the signed certificates to target systems

4.3.1 Create a Custom Root CA

To sign locally generated certificate requests with the root CA certificate, you have to initially create a custom root CA.

  1. Navigate to Certificates >> Certificates tab.
  2. Select a certificate from the list view and click More >> Mark as Root.

The chosen certificate is successfully denominated as a root CA certificate and is listed under the Root Certificate tab. You can then use this certificate to sign locally generated certificate requests.

Note :  You can also generate new root CA certificates from Password Manager Pro by enabling Generate root certificate check-box while creating a certificate from Certificates >> Certificates >> Create option.

4.3.2 Signing Certificates with the Custom Root CA

To sign certificates with the custom root CA, generate a certificate signing request (CSR) and then sign it using the root certificate.

  1. Select the required CSR and click Sign from the top menu.
  2. Select the Sign Type as Sign with Root.
  3. Select the Root Certificate and mention the Validity in days and click Sign.

The certificate is signed based on the selected root certificate and is listed under Certificates >> Certificates tab.

Also, you can use the root CA certificate to simultaneously generate and sign certificates to user groups in bulk directly from Password Manager Pro.

  1. Navigate to Certificate and click Root Certificate on top-right corner of the window.
  2. Select the required root CA certificate and click Sign. In the pop-up that opens, choose the Sign Type, User / User Groups to which certificates have to be created and deployed, mention the SAN and Validity (in days).
  3. The sign type User Management allows you to generate and sign certificates for user accounts in Password Manager Pro.
    1. Select the user account for which you need to generate a certificate.
    2. By default, the user certificates inherit the same parameters as that of the root certificate. You can change it by unselecting the Use root certificate details option.
    3. After filling in the details, click Sign.

The certificate is signed and you can find listed in Password Manager Pro's certificate repository.

The sign type Active Directory Users allows you to generate and sign certificates to user accounts mapped to the Active Directory within your network environment.

  1. Select the Domain Name and provide the primary domain controller address, username and password.
  2. Choose import type Single and specify the user groups or use Groups/OU tree import type to choose the users or user groups for which certificates need to be created.
  3. After selecting the users, enter the certificate validity in days. By default, the user certificates inherit the same parameters as that of the root certificate. You can change it by unselecting the Use root certificate details option.
  4. After filling in the details click Sign.

This will generate certificates for the selected users which will be listed in Password Manager Pro' certificate repository.

4.3.3 Deploying the Signed Certificate to Target Systems

After signing the certificate requests and obtaining the certificate, you have to deploy them to the necessary end-servers. Refer to this section of help for step-by-step explanation on certificate deployment.

Note :  When signing certificates with custom root CA for web-applications, make sure all the browsers in your network are configured to trust the root CA certificate in order to avoid security error messages.

4.4 Auto Renewal

Certificates issued by Local CA can be renewed automatically from PMP. 

To enable auto-renewal of Local CA certificates,

  1. Navigate to Admin >> SSL Certificates >> Certificate Renewal.
  2. Enable Microsoft Certificate Authority, MSCA using Agent or Self Signed and specify the Recurrence Time. Certificates that have already expired and certificates due to expiry in 10 days or less are automatically renewed and updated in the certificate repository.

5. Importing Certificates

To import the certificates in your network:

  1. Navigate to the Certificates >> Certificates >> Add.
  2. Click the appropriate radio button in the Add certificate window.
    1. File Based – Browse and import the required certificate file directly from your system.
    2. Content based – Copy the content of the required certificate file and paste it in the text box.
    3. Keystore based – Import all individual certificates available in a keystore simultaneously. Upload the required Keystore file and enter its corresponding password (if any).
  3. Click Add.

6. Deleting Certificates

You can delete the certificates that are currently not in use. To delete a certificate from Password Manager Pro repository:

  1. Navigate to the Certificates >> Certificates.
  2. Select the certificates.
  3. Click Delete  from the More button.

7. Certificating Requests

The certificate request workflow is as follows:

  1. Add certificate request
  2. Close certificate request

7.1 Adding Certificate Request

To add requests for new certificates or addition of sub-domains to existing certificates, in Password Manager Pro:

  1. Navigate to the Certificates >> Certificate request >> Add Request.
  2. Select the type of request – New Certificate or domain addition.
    1. New Certificate – Attach a CSR to your request (optional) and a domain name for the new certificate.
    2. Domain Addition – Enter the name of the new domain and select a parent domain from the certificates added to the Password Manager Pro repository.
  3. Enter the Mail-id to which you would like to send the request and specify the certificate validity period. These mail addresses can be that of an administrator, an intermediary who handles certificate requests, or even your help desk software to raise the certificate request as a ticket.
  4. Click Additional fields to add additional information such as device name and IP address
  5. Click Add Request to add it to the list of request in the Certificate Request tab and to send the same to the specified email addresses.

7.2 Certificate Request Status

A certificate request is in either of the following statuses.

  • Open
  • Closed

When a certificate request is raised, it is automatically elevated to the Open state. The request details can be viewed from Certificates >> Certificate request, on clicking the domain name of the request.

7.3 Terminating the Certificate Request Life-cycle

  1. Navigate to the Certificates >> Certificate request.
  2. Click the Open status link in the right corner of the table against the required open request process.
  3. In the Close Request window, add an optional annotation, and attach the certificate issued (optional), specify the e-mail ids of users to whom the certificate is to be sent and click the Save & Close button. Once you click the button, the request is automatically moved to the Closed state.
  4. If a SSL certificate is attached while closing the request, the certificate is automatically imported to the Password Manager Pro repository.
  5. Also, the issued certificate is e-mailed to the user who raises the request, the user who closes the request and also to those e-mail ids specified at the time of closing the request.

8. Customizing Expiry Notification Schedule

You can customize the periodicity of notifications you receive when a certificate is about to expire. To customize the notifications:

  1. Navigate to the Admin >> SSH/SSL Config >>  Notifications.
  2. Select the Notify if SSL certificates are expiring within checkbox and the number of days before the expiry of certificate within which you should start receiving notifications.
  3. Select the Email or Syslog checkbox and enter appropriate details.
  4. Click Save.

Note: You will receive notifications every day after the selected date before the expiry of a certificate. For instance, if a certificate is about to expire in the last week of a month, and you select the Notify if SSL certificates are expiring within 7 days option, then, you will receive a notification that your certificate is about to expire every day of the week before the expiry of the certificate.


9. Tracking Domain Expiration through WHOIS Lookup

Apart from tracking certificate expiration, Password Manager Pro also helps administrators keep a tab on their expiring domain names through an automated WHOIS look up. The domain expiration details fetched through the lookup are displayed in Certificates >> Certificates tab against its corresponding SSL certificate. Also, administrators can choose to receive timely email notifications of their expiring domains by configuring it under Admin >> SSH/SSL Config >> Notification Settings.

How does the WHOIS lookup work?

Fetching domain expiration details requires a two-stage lookup to WHOIS servers from Password Manager Pro. The first lookup provides the details of the WHOIS server with which the domain was registered by its domain registrar. The second lookup provides information about the domain such as owner details, expiration date etc., All these operations are automated the from Password Manager Pro's interface.

Note:  Connection to WHOIS servers requires the use of Port 43. Ensure that port 43 is open in your environment, else the connection would fail and Domain Expiration will be marked Not Available (NA) in the Certificates tab.

10. SSL Certificate Group

Password Manager Pro allows you to organize SSL certificates into various logical groups and execute actions in bulk on the groups.

10.1 Creating Certificate Groups

To create a certificate group:

  1. Click the Certificate Group icon in the top-right corner of the Certificates tab.
  2. Click Add Group. You will be directed to the Add Certificate Group page. 
  3. Provide a name for the certificate group and an optional description. Exercise caution while providing the name since it cannot be changed later.
  4. You can choose certificates to be added to a group in either of the following ways:
    1. By Specific Certificate - Select the certificates to be added to the group individually and click Save.
    2. By Criteria - This serves as a dynamic method of grouping certificates. You will specify various criteria based on which the group will be created. Here, you can choose certificates based on various criteria such as issuer, common name, key algorithm, key size, key length etc. The additional fields that are added will also be displayed in the list. You can filter the search in a fine-grained manner based on conditions such as "equals" or "does not equal", "contains" or "does not contain", "starts with" or "ends with". Click the Matching Certificates button at the bottom-right corner to see the corresponding certificates. Click Save. The certificate group is created.

    Note: If you choose to group certificates based on criteria, the conditions will be applied to certificates discovered in the future and they will automatically be added to groups that match the criteria.


10.2 Editing Certificate Groups

To make changes to existing certificate groups:

  1. Click the Certificate Group icon on the top-right corner Certificates tab.
  2. Click the edit icon present in the right corner of the table view.
  3. You can change the certificate selection type, edit the certificates present in a group or add, modify or delete the filters applied to a group.
  4. Once you update the changes and save them, a pop up message will be displayed confirming the updates.

    Note: The certificate group name cannot be modified. However, you can add or modify the list of certificates in a group or the description.

10.3 Deleting Certificate Groups

To delete a certificate group:

  1. Click the Certificate Group icon on the top-right corner of the Certificates tab.
  2. Select the groups that you want to delete and click Delete. 
  3. A pop-up window will appear asking you to confirm the action. Click Ok and the selected certificate groups will be deleted.

©2014, ZOHO Corp. All Rights Reserved.

Top