Manage SSL Certificates
SSL certificates can be created, discovered, and stored in the centralized repository of Key Manager Plus, and requests can be raised for new certificates or domain addition to an existing certificate. Moreover, you are notified when a certificate is about to expire to help you with their timely renewal.
Use Key Manager Plus to:
- Create, discover, or import self-signed or CA issued certificates in the network.
- Generate Certificate Signing Request (CSR).
- Add requests for new certificates or adding a sub domain to an existing certificate.
- Receive notifications when certificates are about to expire.
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
1.Discover certificates in your network
You can automatically discover all the certificates available in your network using Key Manager Plus, 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.
Discover SSL Certificates On Demand
To discover the certificates manually:
- Go to the Discovery tab in the GUI.
- Click the SSL tab.
- Select an option for the type of discovery.
- Hostname/IP address – Enter the name or IP address of the server from which the SSL certificates are to be discovered.
- IP address range – Specify an IP range and discover all the SSL certificates available in the servers falling under the range.
- 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.
Note : The file to be imported must be a text file containing the hostname or IP addresses of individual servers, entered on separate lines. Enter the ports to scan on each server separated by a space, entered on separate lines as illustrated below:
If you do not specify any port, SSL certificates using the default port 443 will be discovered.
Click the Discover button.When you click the Discover button, you will be redirected to the Discovery Status page where the status of the current discovery instance is updated.
Discover SSL Certificates Automatically Through Schedules
SSL Certificate discovery can also be scheduled to occur at periodic intervals.
- Click the Schedule tab in the GUI.
- Click the Add Schedule button.
- In the Add Schedule window, enter a name for the schedule and select the type of schedule as SSL Discovery.
- Specify the start and end IP addresses and the port on the end terminal to check for SSL certificates.
- Select the recurrence type – hourly, daily, weekly, monthly, or once only. Set the starting time, date, or day corresponding to the option chosen.
- Enter the email addresses of the users to be notified. The email settings can be configured from the Settings → Mail Server Settings tab.
- Click the Save button.
You will get a message confirming addition of a new schedule.
The result of the schedule execution will get updated in the Schedule audit and the Discovery audit tabs.
Discover certificates mapped to user accounts in Active Directory
Key Manager Plus helps you discover and manage the certificates mapped to user accounts in Active Directory.
To perform AD user certificate discovery,
- Navigate to Discovery → AD User Certificate
- Select the required Domain Name, which forms part of the AD from the drop-down.
- Specify the DNS name of the domain controller. This domain controller will be the primary domain controller.
- 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.
- 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.
- Key Manager Plus 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 Key Manager Plus for which the certificate discovery is done.
- The discovered certificates automatically get added to the certificate repository of Key Manager Plus.
Discover certificates from Microsoft Certificate Store
Key Manager Plus helps you discover and import certificates from Microsoft Certificate Store. To import certificates from Microsoft Certificate Store,
- Navigate to Discovery → MS Certificate Store
- To discover and import certificates issued by Microsoft CA alone, select Local 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.
- To discover all the certificates from MS certificates store, choose Certificate store.
- Specify the other details such as the name of the Windows domain controller machine and domain admin credentials.
- 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)
- 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.
- Click Discover.
- You can view the discovered certificates in SSL → Certificates tab.
Note : 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.
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 Key Manager Plus. You can view these certificates from the SSL → Certificates tab in the user interface.
Export private key / keystore file
Key Manager Plus allows you to identify and export the private keys / keystore files of SSL certificates stored in the certificate repository, provided you're managing their private keys / keystore files using Key Manager Plus. You can see the Keystore icon ( ) enabled beside the certificates for which the private keys are managed using Key Manager Plus. To export the private key / keystore file,
- Navigate to SSL → Certificates
- Click the Keystore icon ( ) beside the certificate for which you need to export the private key
- From the dropdown, choose Keystore / PFX or Private key as per your requirement.
- The keystore file / private key of the corresponding certificate is downloaded
Update 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. Key Manager Plus helps you ensure this.
- Navigate to SSL --> Certificates tab
- Click the Certificate History icon ( ) corresponding to the required certificate
- 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 Key Manager Plus repository.
- Then again, navigate to SSL --> Certificates tab and click multiple servers icon ( ) corresponding to the required certificate.
- A window opens listing the servers in which the certificate is deployed along with other information such as IP address, port and certificate validity.
- 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.Create Self-signed certificates
Key Manager Plus allows administrators to create their own self-signed certificates using Java keytool. These certificates are automatically imported into the Key Manager Plus repository on successful creation.
To create a self-signed certificate using Key manager plus:
- Navigate to the SSL → Certificate tab in the GUI.
- Click the Create button.
- Enter the details of the organization and certificate validity, and select the key algorithm and length, signature algorithm, and enter a keystore password in the Create certificate tab.
- Click the Create button. You will be redirected to the certificate window where the certificate content is displayed.
- You can copy the certificate content, or export the certificate to required email or system.
- Email – Select this check box to send the certificate file via email to the specified mail id.
- Export – Select this check box to export the file to your system.
- Both the options take effect once you click the Save button.
- Click the Save button to save the certificate in the Key Manager Plus repository, and export the certificate file, if opted in earlier step.
To generate a CSR using Java keytool from Key Manager Plus:
- Navigate to the SSL → Create CSR tab.
- Click the Create button.
- To create a new CSR, select the Create CSR button. To create a CSR from an already existing private key, select Create CSR from Private Key button.
- For new CSR creation, enter the details of the organization and certificate validity, and select the key algorithm and length, signature algorithm, and enter a keystore password in the Create CSR window.
- Click the Create button. You will be redirected to a window where the CSR content is displayed.
- For CSR creation from already existing private key, browse and attach the required private key file along with the keystore password and click Create.
- The CSR is created. You can then copy the CSR content, or export the CSR to required email or system.
- Email – Select this option to send the certificate file via email to the specified mail id.
- Export CSR / Private Key - You can choose to export the CSR or the corresponding private key alone based on your requirement.
- You can view the saved CSR from SSL → Create CSR tab.
- The 'show passphrase' icon ( ) corresponding to every CSR allows administrators to view the keystore passwords of respective CSR files.
To import the certificates in your network:
- Navigate to the SSL → Certificates tab in the GUI.
- Click the Add button.
- Click the appropriate radio button in the Add certificate window.
- File Based – Browse and import the required certificate file directly from your system.
- Certificate content based – Copy the content of the required certificate file and paste it in the text box.
- KeyStore based – Import all individual certificates available in a keystore simultaneously. Upload the required Keystore file and enter its corresponding password (if any).
- Click the Add button.
5. Delete certificates
You can delete the certificates that are currently not in use. To delete a certificate from Key Manager Plus repository:
- Navigate to the SSL → Certificate tab.
- Select the certificates.
- Click the Delete button.
6. Certificate Requests
The certificate request workflow is as follows:
- Add certificate request
- Close certificate request
Add Certificate Request
To add requests for new certificates or addition of sub-domains to existing certificates, in Key Manager Plus:
- Navigate to the SSL → Certificate request tab in the GUI.
- Click the Add Request button.
- Select the type of request – Certificate or domain addition.
- New Certificate – Attach a CSR to your request (optional) and a domain name for the new certificate.
- Add domain – Enter the name of the new domain and select a parent domain from the certificates added to the Key Manager Plus repository.
- Enter the mail addresses 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.
For eg., firstname.lastname@example.org, email@example.com.
- Click Additional fields to add additional information such as device name and IP address
- Click the Add Request button to add it to the list of request in the Certificate Request tab and to send the same to the specified email addresses.
Certificate request status
A certificate request is in either of the following statuses.
When a certificate request is raised, it is automatically elevated to the Open state. The request details can be viewed from the SSL → Certificate request tab, on clicking the domain name of the request.
Close Certificate Request
To terminate the certificate request life-cycle:
- Navigate to the SSL → Certificate request tab in the GUI.
- Click the Open status link in the right corner of the table against the required open request process.
- 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.
- If a SSL certificate is attached while closing the request, the certificate is automatically imported to the Key Manager Plus repository.
- 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.
7. Control expiry notification schedule
You can customize the periodicity of notifications you receive when a certificate is about to expire. To customize the notifications:
- Navigate to the Settings → Notifications tab in the GUI.
- Select the Certificate expires after checkbox and the number of days before the expiry of certificate within which you should start receiving notifications.
- Select the Email or Syslog checkbox and enter appropriate details.
- Click the Save button.
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.