The SSL Store™ integration with Password Manager Pro

Password Manager Pro (PMP) facilitates end-to-end life cycle management of certificates obtained from trusted certificate authorities (CAs) by enabling users to acquire, consolidate, deploy, renew and track certificates issued by commercial CAs from a single interface.
With Password Manager Pro's seamless API-based integration with The SSL Store™—one of the largest platinum partners of world's leading CAs—you will have the option to acquire and manage certificates from the following third-party CAs directly using PMP: Sectigo (formerly Comodo), Symantec, Thawte, Geotrust, and RapidSSL.

Before you proceed with the integration, complete the following step as a prerequisite:

Prerequisite

Add the following base URL and port as an exception in your firewall or proxy to ensure PMP is able to connect to the SSL Store's CA Services.
URL: https://api.thesslstore.com/rest/ 
Port: 443

Follow the steps below to place certificate orders, acquire, consolidate, deploy and manage trusted third-party CA certificates from PMP.

  1. Configure API authentication credentials
  2. Place a certificate order

    2.1 Configure DNS account

  3. Domain control validation, certificate issue and deployment
  4. Renew, reissue, and delete

1. Configure API Authentication Credentials

The first step to request and manage third-party CA certificates from PMP is to sign up for an exclusive enterprise account at The SSL Store™ portal and configure the API credentials generated subsequently in PMP's interface. To set up an Enterprise account with The SSL Store™,

  1. Navigate to this enterprise sign up link in The SSL Store™ website. Proceed through the sign up link for Key Manager Plus.
  2. Fill in your personal details and organization details as requested, and click Continue.
  3. You will then be taken to the Setup Payment section where you need to configure a payment method, and provide the payment details and billing information.
  4. After providing the details, click Continue.
  5. You will be redirected to the Confirmation/Token section where the API credentials (Partner ID and Token) are displayed. Copy and save the credentials in a secure location.
  6. Now, switch to the PMP server and navigate to Certificates >> The SSL Store™ tab. Click Manage in the top-right corner of the window.
  7. Under the Accounts tab, provide the generated partner code and token, and click Save.
  8. The details are stored in PMP. Configuring API authentication credentials is a one-time process. You do not need to provide the details every time you place a certificate order.

2. Place a Certificate Order

Once you have configured your API authentication credentials, you can leverage The SSL Store™'s API to generate certificate signing requests (CSRs), place orders, procure, and manage certificates from any of the following certificate authorities directly from PMP: Sectigo, Symantec, Thawte, GeoTrust, and RapidSSL.

To generate a CSR and place a certificate order,

  1. Navigate to the Certificates tab >> The SSL store™.
  2. Click Order Certificate.
  3. In the window that opens, choose the vendor, validation type, product name, domain validation type and validity.
  4. PMP supports all the three domain control validation methods: DNS-based, file-based and email validation.
  5. Then, provide the common name, algorithm length, keystore type, keystore password, number of servers in which the certificate will be deployed, server type and the approver's email IDs. Users also have the option to import and use an already existing CSR or private key.
  6. The approver email ID is the email ID to which Domain Control Validation (DCV) verification mail will be sent. The approver email ID should take either of the following formats:
    •   <admin@domain>, <administrator@domain>, <hostmaster@domain>, <webmaster@domain> or <postmaster@domain>
    •   Any administrator, registrant, tech or zone contact email address that appears on the domain’s WHOIS record and is visible to the CA system.
  7. Then, provide the organization details(applicable for organization validation and extended validation order types only), administrator contact details and contact details of the technician placing the certificate order.
  8. After filling in the details, click Create.
  9. You will be taken to a window where you can see the list of certificate orders placed along with their statuses displayed to the right of the table view.
  10. Note:
    • PMP allows you to import the already existing certificate orders placed within your account from The SSL Store™ and track their statuses. Click Import Existing Orders from the More top menu to import the existing open orders into PMP.
    • Also, you can preconfigure your organization details under Manage to refrain from providing it every time you place an OV / EV certificate order.

2.1 Configure DNS Account

If you are opting for DNS-based domain validation in the certificate order, you should configure the DNS account in PMP and specify it in the DNS field in the order to automate the challenge verification procedure. To configure your DNS account,

  1. Navigate to Certificates >> The SSL Store™ >> Manage
  2. Switch to the DNS tab. Click Add and in the pop-up that opens, choose the DNS provider.
  3. Here, you can add a maximum of one DNS account for each supported DNS provider. PMP currently supports automatic domain control validation for Azure, Cloudflare, Amazon Route 53 DNS, and RFC2136 DNS update.
    2.1.1 For Azure DNS
  1. Provide the Subscription ID, which is available in the Overview page of the Azure DNS zone.
  2. Provide the Directory ID, which is available in Azure Active Directory >> Properties.
  3. If you have an already existing Azure application, provide its Application ID and Key.
  4. If not, follow the steps mentioned below to create the Azure application and key, and give the application access to the DNS zones for making API calls.

Follow the below steps to create the Azure application and key from the Azure console:

  1.    Navigate to App registrations >> New application registration.
  2.    Provide the application name, select the application type Web app / API and provide the sign-on URL. Click Create.
  3.    After successful creation, you are directed to a window that displays the Application ID.
  4.    To get the application key, navigate to Keys and create a key.
  5.    Provide the key description, duration and click Save.
  6.    Once the key is saved, key value is displayed. Copy and save the key value for future references.

To give the application access to DNS zones, follow the below steps:

  1. Navigate to the resource group where all DNS zones are created or switch to a specific DNS zone.
  2. Switch to Access Control (IAM) and click Add.
  3. Choose the role as Contributor, assign access to Azure AD user, group or application, search and select the application created in Azure Directory and click Save.
  4. The created Azure application is now given access to DNS zones for making API calls.
  5. Now, enter the Resource Group Name, which is the group name in which you have created the DNS zone and click Save.
  6. Your DNS account details are saved and listed under Manage >> DNS.

    2.1.2 For Cloudflare DNS

    1. In the Email address field, specify the email address associated with the Cloudflare account.
    2. For Global API Key, use the 'Generate API' key option in the domain overview page of the Cloudflare DNS to generate the key and paste the value in this field.
    3. Click Save. Your DNS account details will be saved and listed under Manage >> DNS.
Note:
  • For DNS based domain validation type, if you are going to specify an already configured DNS account in the certificate order for domain control validation, make sure its status is marked Enabled under Manage >> DNS.

2.1.3 For AWS Route 53 DNS

  1. Generate and specify the Access Key ID and Secret associated with your AWS account.
  2. If you do not have an AWS account, create one and generate the Access Key ID and Secret by following the steps given below:

    2.1. Login to the AWS console and navigate to IAM Services >> Users.

    2.2. Click Add user.

    2.3. Provide the user name and select the access type as Programmatic access.

    2.4. Switch to the next tab, click Attach existing policies directly under Set Permissions and search for "AmazonRoute53FullAccess".

    2.5. Assign the policy that is listed and switch to the next tab.

    2.6. In the tags section, add appropriate tags (optional) and switch to the next tab.

    2.7. Review all the information entered and click Create user.

    2.8. The user account is created and subsequently, an access key ID and a secret is generated. Copy and save the key ID and secret in a secure location for it will not be displayed again.

  3. If you already have an AWS user account, you have to grant "AmazonRoute53FullAccess" permission to the user and generate the access key if the user doesn't have one. And if the user account has an access key associated already, it is just enough to ensure the required permission is granted.

To grant the required permissions, follow the below steps:

    1. Navigate to the Permissions tab, select the required user account and click Add Permission.
    2. Click Attach existing policies directly under Set Permissions and search for "AmazonRoute53FullAccess".
    3. Assign the listed policy and hit Save.
    4. To generate the access key,
    5. Select the particular user account and navigate to the Security Credentials tab.
    6. In the window that opens, click Create access key.
    7. An access key ID and a secret is generated. Copy and save the key ID and secret in a secure location for it will not be displayed again.

2.1.4 RFC2136 DNS Update

If you are using open source DNS servers such as Bind, PowerDNS etc., that support RFC2136 DNS update, follow the steps below to automate DNS-based domain control validation procedure using PMP. 

  1. The DNS Server IP / Hostname represents the server name / IP address in which the DNS server is installed or running. 
  2. The server details are found in the server installation directory. For instance, in the case of Bind9 DNS server, you can find these in the file named.local.conf in the server installation directory.
  3. Provide the Key Secret, which is the key content found in the server installation directory. 
  4. Provide a name for the key, choose the signature algorithm and click Save

3. Domain Validation, Certificate Issue and Deployment

Prerequisite

If the end server in which you're deploying the challenge file is a Windows machine, follow the below steps to install the Windows agent:

  1. Navigate to Admin >> PMP Agents and click Windows Agent under the required version: 32-bit or 64-bit.
  2. Execute the following commands:

    Installing PMP agent for Windows server:

    To install PMP agent as a Windows service

    1. Open the command prompt and navigate to the PMP agent installation directory.
    2. Execute the command 'AgentInstaller.exe start.'

    To stop the agent and uninstall the Windows service

    1. Open the command prompt and navigate to the PMP agent installation directory.
    2. Execute the command 'AgentInstaller.exe stop.'

Once the certificate authority receives your order, you will have to go through a process called Domain control validation (DCV) and prove your ownership over the domain upon the completion of which you will receive the certificate. PMP supports all the three DCV methods:

  1. E-mail based DCV
  2. File or HTTP-based DCV
  3. DNS-based DCV

3.1 E-mail-based Domain Control Validation

  1. In email based domain control validation, the certificate authority sends a verification email to the approver email ID specified when placing the certificate order.
  2. This email will guide you through the steps that need to be performed in order to complete the domain control validation procedure.
  3. After completing the steps, navigate to the PMP server, and switch to Certificates>>The SSL Store™ tab.
  4. Select the order and click check Order Status from the top menu.
  5. On successful verification, the certificate authority issues the certificate which is fetched and added to PMP's secure repository. To access the certificate, navigate to the Certificates tab.
  6. From here, deploy the certificate to necessary end-point servers such as a Certificate Store or an IIS server PMP.

Click here for more details on certificate deployment.

3.2 File/HTTP-based Domain Control Validation

  1. If you have opted file / HTTP based domain control validation, a challenge file is displayed on creating the order.
  2. Navigate to the domain server, create the path specified and deploy the challenge file in that path.

This entire process of deploying the challenge file in the end-point server can be automated from PMP. This can be achieved by configuring the server details in  Manage >> Deploy. To automate domain control validation, follow the below steps:

  1. Navigate to Certificates>>The SSL Store™ >> Manage.
  2. Switch to the Deploy tab and click Add.
  3. In the pop-up that opens, choose the challenge type as 'http-01' , specify the domain name, choose the server type (Windows or Linux) and enter the server details. Click Save.
  4. The challenge file is automatically deployed to the corresponding end-server in the specified path.
  1. Once you have deployed the challenge file, navigate to the PMP server, switch to The SSL Store™ tab, choose the order and click Check Order Status from the top menu.
  2. On successful domain validation, the certificate authority issues the certificate which is fetched, added to the Certificates tab in PMP and is also deployed in the specified path of the server configured earlier under Manage >> Deploy.

3.3 DNS-based Domain Control Validation

  1. If you have opted for DNS based domain control validation, a DNS challenge value and text record are displayed on creating the order.
  2. Copy and paste the text records manually in the domain server.

Similar to the HTTP challenge, the entire challenge verification process can be automated from PMP. This can be achieved by configuring the server details in the Deploy tab under Manage. To automate domain control validation,

    1. Navigate to Certificates >> The SSL Store™ >> Manage.
    2. If the end-server is a Windows machine, initially download and install the Password Manger Pro agent for Windows server from the Windows Agents tab using the steps mentioned in the previous section.
    3. Switch to the Deploy tab and click Add.
    4. In the pop-up that opens, choose the challenge type as 'dns-01', specify the domain name, choose the DNS provider (Azure, Cloudflare or Amazon Route 53 DNS) and enter the server details.
    5. Check 'Certificate' option to deploy the certificate to the end-server after procurement. Click Save.
    6. The DNS challenge values and text records are automatically created in the corresponding DNS servers.

    1. Once the challenges have been filled, navigate to the PMP server, switch to Certificates >> The SSL Store™ tab, choose the order and click Order Status from the top menu.
    2. On successful domain validation, the certificate authority issues the certificate which is fetched and automatically added to PMP's certificate repository. To access the certificate, navigate to the Certificates tab.
    3. From here, deploy the certificate to the necessary end-point servers such as a Certificate Store or an IIS server directly from PMP. Click here for more details on certificate deployment.
    4. Also, the certificate is automatically deployed to its corresponding end-server after issue, if you have enabled the Deploy Certificate option at the time of configuring server details under Manage >> Deploy.

    Notes:

    i. For DNS-based domain control validation, if you had chosen a DNS account configured under Manage >> DNS when placing the order, PMP automates challenge verification using that account. Instead, if you have already configured the domain and server details under Manage >> Deploy, the challenge verification, and subsequently the deployment of certificates is carried out for that specific domain and server alone.

    ii. For RFC2136 DNS update, if you have chosen Global DNS configuration, the domain name itself acts as the zone name (Global DNS configuration is possible only if you are using the same Key Secret for all zones). Whereas, if you have chosen domain-agent mapping, you have to provide the Zone name, Key Name, and Key Secret for each domain separately.

4. Renew, Reissue, and Delete

You can renew, request reissue or delete certificate orders placed to third-party certificate authorities from PMP.

To renew a certificate,

  1. Navigate to Certificate >> The SSL Store™
  2. Select the required order and click Renew Certificate from the top menu.
  3. Complete the domain control validation (DCV) procedure if necessary.
  4. On successful validation, the certificate is issued and the new version is automatically updated in the Certificates tab.

Note: You can request a reissue only for those certificates requested from PMP and not for the imported orders.

    To delete a certificate request, follow the below steps

    1. Navigate to Certificates >> The SSL Store™.
    2. Select the required certificate and click Delete from the More menu.
    3. The certificate request is deleted from PMP.

Note: When a certificate request is deleted, it is removed only from PMP. You can find the order in The SSL Store™ website for your account and import it into PMP if needed using The SSL Store™ >> More >> Import option.

Disclaimer: The procurement of public CA certificates from PMP can be successfully completed only if the user has signed up for an exclusive enterprise account with The SSL Store™. PMP imports certificates after issue using The SSL Store™'s API for providing better PKI management functionality. All personal information (including payment details) is collected and processed by The SSL Store™ and ManageEngine is not responsible for any payment related issues. Please contact The SSL Store™ technical support team if you face any difficulties with payment and procurement of certificates from public CAs affiliated with The SSL Store™ using PMP.

©2014, ZOHO Corp. All Rights Reserved.

Top