Manage SSL Certificates

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.

To request and acquire certificates stored in Local CA from PAM360, 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 >> Create 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 >> Create CSR tab.

You can also get the CSR signed from Microsoft Certificate Authority directly from PAM360 itself.

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

From PAM360 build 5300 onwards, PAM360 allows you to rediscover SSL certificates from the same source using the server details entered during the previous discovery operation. Follow the below steps to perform certificate rediscovery:

1. Navigate to the Certificates tab.
2. Select the required certificates and click More >> Re Discover.

The rediscovery operation begins immediately. You can track the discovery status in the Discovery Audit page. Please note that for agent-based discovery to work properly, upgrade Key Manager Plus Agent to version 6000 before commencing the discovery operation.

1.7.3 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 PAM360. You can view these certificates under the Certificates >> Certificates option in the user interface.

i. Search SSL Certificates

PAM360 allows you to search certificates using Common Name, DNS Name, Issuer, Key Size, Signature Algorithm, Description, additional fields, etc.

1. Navigate to Certificates >> Certificates.
2. Click the search icon present on the right corner of the table header and mention the search phrase(s) in the text box(es) that appears.

1.7.4 Export Private Key/Keystore File

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

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.5 Track and Manage 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. PAM360 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 PAM360 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.6 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. PAM360 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 PAM360 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.
7. Click edit icon corresponding to the required server to modify the server details.
8. Click Add to add a new server. 
   1. In the pop-up that appears, mention the DNS Name, IP Address and Port.
   2. Click Save.

      

9. Click edit icon corresponding to the required server to modify the server details.
10. Select a certificate and click Check Status to check the sync status of the certificate. To know more about Certificate sync status, click here.

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

1.8 Discover SSL Certificates Hosted on AWS (ACM & IAM)

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

Navigate to Certificates >> Discovery >> AWS.

Step 1: Configure AWS credentials in PAM360

Follow the below steps if you have not added an AWS-IAM resource in PAM360:

To add your AWS credentials in PAM360,

1. Click 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 PAM360.
5. Now, navigate to Certificates >> Discovery >> AWS and choose the appropriate AWS Credentials from the drop-down or provide your Access Key and Secret Key manually.

   

If you have already added an AWS-IAM resource in PAM360,

1. Choose if you want to Specify the access key and secret key manually or Use an access key and secret key stored in PAM360.
2. If you have chosen Specify the access key and secret key manually, enter your Access Key and Secret Key.
3. If you have chosen Use an access key and secret key stored in PAM360, select the Resource Name, Access Key and Secret Key from the drop-down.

Step 2: Discovery and Import

1. Choose the required AWS Service from which certificates need to be imported: ACM or IAM.
2. To import certificates from ACM, select ACM under AWS service and choose the service Region.
3. Click Discover.
4. Certificates are discovered from resources in the selected region and imported into Key Manager Plus.
5. To import certificates from IAM, specify the required AWS User Name(s) or use the List AWSUser Names option to retrieve the usernames. Choose the required usernames and click Discover.
6. 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 PAM360.

1.9 Discover SSL Certificates using ManageEngine Mobile Device Manager Plus

PAM360 integrates with ManageEngine Mobile Device Manager Plus (MDM). Once the integration is done, you can discover and import SSL certificates from the devices managed through your MDM server and store the SSL certificates in the PAM360 repository. You can also deploy SSL certificates from PAM360 to the mobile devices listed in your MDM environment. Refer to this document for steps on how to discover certificates using ManageEngine MDM.

2. Create Self-Signed Certificates

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

To create a self-signed certificate using PAM360:

1. Navigate to the Certificates >> Certificates >> Create.
2. 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.
3. Click the Create button. You will be redirected to the certificate window where the certificate content is displayed.
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. Mention the email address to which the Expiry Notification Email should be sent.
6. You can denominate the certificate to be generated as a root certificate by enabling the Generate root certificate check-box. 
7. 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.
8. Click the Create button. You will be redirected to the certificate window where the certificate content is displayed.
9. 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.
10. Both the options take effect once you click Save.
11. Click the Save button to save the certificate in the PAM360 repository, and export the certificate file, if opted in the earlier step.

(Applicable from build 5000 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. Generate CSRs

To generate a CSR using Java keytool from PAM360:

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, State and Country.
      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 and Expiry Notification Email address. Click the Generate Password icon to generate a key store password.
      5. Select the Sign 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 5000 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.1 Managing CSR

1. You can view the saved CSR from Certificates >> Create CSR tab.
2. Show Passphrase: The show passphrase icon () corresponding to every CSR allows administrators to view the keystore passwords of respective CSR files.
3. Export: You can export and mail the CSR to a specified mail id by using the icon () in the CSR displayed in the list view.
4. 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. PAM360 automatically pins the certificate file with its corresponding private key and adds it to its centralized repository.
5. 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.
6. CSR Template: Click CSR Template to add, delete or manage the templates. These templates after generated can be used while generating CSR’s.

   
   

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.

4. Certificate Signing

PAM360 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 PAM360, you have to initially generate a CSR, 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 PAM360.

1. Select the required CSR and click Sign from the top menu. 
2. In the pop-up that opens, 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 predefined 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 PAM360 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 PAM360, 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 agents, click here.
   3. Specify the Certificate Template or click Get Template 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. Click Sign.

      

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

4.3 Sign with Root

PAM360 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 and click More >> Mark as Root from the top menu.

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 PAM360 by enabling Generate root certificate check-box while creating a certificate from Certificates >> Certificates >> Create.

4.3.2 Sign 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 CSR and click Sign from the top menu.
2. Select the Sign Type as Sign with Root.
3. Select the Root Certificate and specify the Validity in days. Click Sign.
4. Select checkbox to Sign intermediate certificate. This allows users to sign the certificate on behalf of Root CA.
5. 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.
6. 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 PAM360.

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 PAM360.
   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 PAM360'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.
5. This will generate certificates for the selected users which will be listed in PAM360' certificate repository.

   

4.3.3 Deploy 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.

5. Import and Export Certificates

5.1 Allowed Certificate Types

PAM360 allows you to import and export the following certificate types:

• .cer
• .crt
• .pem
• .der
• .p7b
• .pfx
• .p12
• .pkcs12
• .jks
• .keystore

5.2 Steps to Import the Certificates in your Network

In addition to certificate discovery, PAM360 provides a few other ways in which you can manually add SSL certificates into the repository. To do so, follow the below steps:

1. Navigate to the SSL >> Certificates tab and click the Add button.
2. The Add Certificate window displays the following options:
   1. Certificates – Browse and import the required certificate file directly from your system.
   2. Certificate Content – 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).
   4. Certificate Details – Browse and import the .csv file with the required certificate details.
3. Click Add. The certificates or certificate details will be imported to the PAM360 repository.

5.3 Steps to Import Issuer Certificates

PAM360 allows you to import issuer certificates into the repository and build a complete certificate chain in the product.

1. Navigate to Certificates >> Certificates. Select the required end certificate.
2. Under the More dropdown, select Import Issuer.
3. In the pop-up that appears, Browse and add the issuer certificate andh click Import.
4. The additional issuer certificates you add will be appended to the existing SSL certificate in the repository based on the issuer name. To download the complete chain with the private key, export the certificate in JKS, PKCS, or PEM formats.

5.4 Steps to Export the Certificates in your Network

1. Navigate to Certificates >> Certificates.
2. In the list view, click the certificate you want to export.
3. In the certificate details window, click Export on the top right corner and select the required format in the which you want to export the certificate.
4. The certificate will be downloaded to your machine in the selected format.

6. Certificate Renewal

The Certificates tab in PAM360 is a centralized console where all types of SSL certificates such as Self Signed, Root Signed, Microsoft CA Signed, certificates issued by third-party CAs etc., are consolidated and displayed. Through the Renew option, these certificate types can be renewed in the Certificates tab directly. These renewed certificates will automatically inherit the deployed servers and their credentials. For certificates issued by third-party CAs, the renewal will be initiated and redirected to the respective CA's tab. To proceed further, follow the below steps:

1. Navigate to Certificates >> Certificates.
2. There are three types of certificate renewal:
   1. Self Signed certificate renewal
   2. Root Signed certificate renewal
   3. Microsoft CA Signed/Signed with Agent certificate renewal

i. Self Signed Certificate Renewal

To renew a Self Signed certificate, follow the below steps:

1. Select a Self Signed certificate and click Renew at the top.
2. The renewal type will be Self Signed by default.
3. Specify the number of days for which the certificate shall be valid in the Validity field. Click Renew.

The certificate will be renewed successfully and the Valid To date will change according to the new validity period specified.

ii. Root Signed Certificate Renewal

To renew a Root Signed certificate, follow the below steps:

1. Select a Root Signed certificate and click Renew at the top.
2. The renewal type will be Renew with Root by default and the Issuer name will be auto populated in the Root Name field.
3. Specify the number of days for which the certificate shall be valid in the Validity field. Click Renew.

The certificate will be renewed successfully and the Valid To date will change according to the new validity period specified.

iii. Microsoft CA Signed/Signed with Agent Certificate Renewal

To renew a Microsoft CA signed certificate, follow the below steps:

1. Select a Microsoft CA Signed certificate and click Renew at the top.
2. If the certificate does not have a private key, PAM360 allows you to create a new private key. Click OK in the pop-up that appears.
3. Attributes such as Renewal Type, Server Name, Template Name / OID, Certificate Authority will be auto populated from the certificate details. The Server Name is the name of the Microsoft CA server which signed the certificate. Certificate Authority is the CA service that runs in the specified Microsoft CA server.
4. For certificates signed by Microsoft CA directly or using the KMP agent, validity days will be taken from the Microsoft CA server and therefore it cannot be entered manually during renewal. These type of certificates will be renewed only till the date specified in the the Microsoft CA server.

In addition to the above types, third-party CA signed certificates can also be renewed using this renewal option. Follow the same procedure to initiate renewal and PAM360 will redirect the renewal request to the respective third-party CA. Follow the steps detailed in the next section to learn how to set up auto-renewal for certificates in PAM360.

6.1 Auto Renewal

Certificates issued by Local CA can be renewed automatically from the Admin page in PAM360. 

To enable auto-renewal of Local CA certificates, follow the below steps:

1. Navigate to Admin >> SSL Certificates >> Certificate Renewal.
2. Enable Microsoft Certificate Authority, MSCA using Agent or Self Signed and specify the Recurrence Time.
3. Certificates that have already expired and certificates due to expiry in 10 days or less are automatically renewed and updated in the certificate repository.
4. The certificates that are due to expire in the number of days mentioned in the Days to Expire field will also be auto-renewed.
5. Select the checkbox to Exclude auto-renewal certificates from email notifications. This allows the certificates marked for auto-renewal to be excluded from the email notifications even if they fall under the expiry notification configuration.
6. Select the checkbox to Send Expiry Notification for the Previous version after successful Renewal.
7. Click Save.
8. After successful auto-renewal, the previous version of the certificate will be listed under Certificate History.
   

   

Notes:

1. During the renewal process, a CSR will be generated from the available values, along with a new Private Key.
2. SHA1 certificates will be renewed using the SHA256 algorithm.

7. Certificate History

PAM360 allows you to group the certificates under a common name. To enable this,

1. Navigate to Admin >> SSL Certificates >> Certificate History.
2. Choose Enable or Disable the Group Certificates by CommonName option.
3. Enabling the option will group the certificates under one Common Name.
4. Disabling this option will create new certificates based on the unique Serial Numbers assigned to the certificates.
5. To view these certificates, navigate to Certificates >> Certificates and enable Certificate History from column chooser.
6. Now, click the certificate history icon corresponding to the required certificate to view the certificates.

Notes: On certificate renewal, the older version of the renewed certificate will be moved to Certificate History.

8. Certificates Sync Status

PAM360 allows users to perform periodic and automatic checks on the synchronization status on the SSL certificates deployed to multiple servers.
When enabled, PAM360 gives you options to check for out-of-sync servers and delete the servers in which there is a certificate mismatch. Follow the below steps to enable certificate sync status check:

1. Navigate to Admin >> SSL Certificates >> Certificates Sync Status.
2. Click Enable and enter a recurrence time interval in hours or minutes.
   1. Check only the Non-Sync servers - select this option to check and consolidate only the out-of-sync servers.
   2. Delete the server if Non-Sync - select this option to delete the servers that are found to have a certificate mismatch after the synchronization check.
3. Click Disable to stop the synchronization check.

9. Edit and Delete Certificates

9.1 Steps to Edit a Certificate from PAM360 Repository

To edit a certificate from PAM360 repository:

1. Navigate to the Certificates >> Certificates.
2. Select the certificate to be edited, click More and select Edit from the drop-down.
3. In the Edit Certificate pop-up that appears, edit the DNS Name, Port, Description, Expiry Notification Email, and Type.
4. You can choose to Deploy Certificate on Auto Renewal. 
5. Click Save.
   
   

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

9.2 Steps to Delete a Certificate from PAM360 Repository

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

1. Navigate to the Certificates >> Certificates.
2. Select the certificates.
3. Click More and select Delete from the drop-down.
4. In the pop-up that appears, select the checkbox to Add selected certificates to 'Excluded certificates' and mention the Reason.
5. Click OK in the pop-up that appears.

10. Certificate Requests

The certificate request workflow is as follows:

1. Add certificate request
2. Close certificate request

10.1 Add Certificate Request

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

1. Navigate to the Certificates >> Certificate request.
2. Click the Add Request button.
3. 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. Add Domain – Enter the name of the new domain and select a parent domain from the certificates added to the PAM360 repository.
4. 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.
5. Click Additional fields to add additional information such as device name and IP address
6. 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.

   

10.2 Certificate Request Status

A certificate request is in either of the following statuses.

1. Open
2. 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.

10.3 Terminate 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 PAM360 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.

   

11. Control 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 >>  Notification Settings.
2. Select the Notify about 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. To know more about configuring notifications, click here.
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.

12. Track Domain Expiration through WHOIS Lookup

Apart from tracking certificate expiration, PAM360 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.

12.1 How does the WHOIS lookup work?

Fetching domain expiration details requires a two-stage lookup to WHOIS servers from PAM360. 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 PAM360'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.

13. SSL Certificate Group

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

13.1 Create 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.
5. Mention the Group Email address to send expiry notifications and click Save. 
6. The certificate group is created. To know more about additional fields, click here. 

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.

13.2 Edit 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.

13.3 Delete 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.