WHMCS - SSLCert Provisioning Addon

Introduction

WHMCS Provisioning Module for CentralNic Reseller SSL certificates, allowing you to register and maintain SSL certificates over CentralNic Reseller.

Supported Features

The CNIC SSL Module supports the following functions and features:

• Support for CentralNic Reseller
• SSL Provisioning Module
  • Support for both productive and test (OT&E) environments
  • Create, renew and revoke certificates
  • Support for Email, DNS and File based domain validation methods

Requirements

In our system requirements, we recommend avoiding PHP versions that have reached their End of Life (EOL), as indicated in red on the PHP Supported Versions page.

To ensure compatibility with WHMCS, please follow these steps:

• Check the supported PHP versions for your desired WHMCS version using our WHMCS/PHP Matrix.
• Determine the required IonCube Loader version for your WHMCS version from the WHMCS/IonCube Loader Matrix.
• Identify the compatible MySQL version for your chosen WHMCS version using the WHMCS/MySQL Matrix.

Ensure to have the below packages installed on your WHMCS Server:

• curl
• php-curl
• Latest CentralNic Reseller Registrar Module. This module can be downloaded here. Our SSL Cert Module does not support the WHMCS built-in CentralNic Reseller provider module!
• CentralNic Reseller Live or Test Account must be configured in the CentralNic Reseller Registrar Module. Account creation is always free: Register

Please note: We ensure compatibility with the latest WHMCS version and the maximum versions of the listed software dependencies. While our modules may still function with older PHP versions like PHP 7.4, we don’t provide support for them and cannot guarantee their continued compatibility. If you have questions or need assistance, please reach out to us.

Grant User Permissions

• Log in to the CentralNic Reseller Control Panel (OT&E, LIVE).
• Click on your username located at the top right corner.
• Choose 'User management' from the dropdown menu.
• Click on the user associated with your WHMCS system to configure their permissions.
• Assign the following read, write and delete permissions:
  • Certificate (for CNIC SSL Addon)

Please ensure that the specified permissions are granted to the user linked with your WHMCS system.

Installation / Upgrade

Read the article "WHMCS - Module Installation & Upgrade". We are shipping all Modules as part of our Software Bundle.

Managing SSL Products

Product management can be handled automatically by using the Products & Pricing Import Addon. However it is possible to do so manually, if desired.

Manually create Products

Within the WHMCS Admin area, navigate to Setup > System Settings > Products/Services

1. Create a new product group. In this example, we will name the new group as “SSL Certificates”.
2. Create a new product.
   • Set Product Type to “Other”.
   • Set Product Group as desired.
   • Define a product name.

Select CNIC SSL Certificate as Module.

1. Open the Details tab.
   • Set a Product Description (optional).
   • Ensure the Welcome Email field is set to “None” as the module sends its own email.

Ensure the Required Domain field is unchecked.

1. Open the Pricing tab.
   • Set the Payment Type field to Recurring.

Set an annual price.

1. Open the Module Settings tab.
   • Enter Certificate Class.
     1. Log into your Web Interface
     2. In the Menu, open SSL > Certificate Prices
     3. The value shown in the Type column would be the certificate class you need to specify

Set “Automatically setup the product as soon as the first payment is received” to ensure the certificate is paid for before registration.

1. Click Save changes.

Manage imported Prices

Managing imported certificates can be done at Setup > System Settings > Products/Services

Customer Experience

Client Area

You can check the product groups in the store in your WHMCS Client Area. If you used our Addon to import Product Groups and Products, you will see those pages already configured with a comparison cart, product features, certificate provider logos and so on. You are basically ready to go!

Certificate Ordering Process

This is how a client would proceed to order an SSL certificate.

1. Go to the created certificate group on your WHMCS Client Area and “Order Now” the desired certificate.
2. Follow the steps in the buying process.
3. Once the invoice is paid, you will receive an SSL certificate Configuration email, which contains a link to configure the new certificate.

Click this link or to go to the bought SSL certificate product page and click the “Configure SSL Certificate” button.

On this configuration page, the module will prefill the contact information and auto generate a CSR based on the domain provided and your client information. At this point, you are free to alter any information and replace the proposed CSR with your own if you wish.

On the subsequent configuration page, you will be asked for a Certificate Approver Email. Alternatively, you can choose the DNS or HTTP File validation methods, if available (not all certificates support all validation methods).

The configuration is now completed

1. Follow the instructions you will get via e-mail from the Certificate Authority to validate your purchase. If you chose DNS or HTTP File validation, just follow the instructions that are presented to you in the confirmation screen.
2. It might take some minutes after validation until the certificate shows up in the client area

Automatic SSL Configuration & Installation

1. Attempt Automatic Config
   For certificates requiring DNS or FILE validation, the addon will attempt to automatically create the necessary DNS records or validation files. It checks for existing hosting packages on Plesk, cPanel, or DirectAdmin for the relevant domains. This feature simplifies the validation process.

2. Attempt Automatic Install
   After the SSL certificate is issued, you can install it with one click. The addon searches for existing hosting packages on Plesk, cPanel, or DirectAdmin. The certificate will be installed on these servers automatically.

   Note: Automatic uploading of the CA certificate is not currently supported.

Key Features:

• DNS & File-Based Validation Automation: The addon handles validation setups seamlessly on supported servers, reducing manual configuration.
• One-Click Certificate Installation: Once the certificate is ready, installation can be done easily across supported hosting environments.

Certificate Management

Reissuing a certificate

To reissue a certificate, simply select the "Reissue certificate" from the side bar. You will then be prompted to provide a new CSR, after which the reissue will be triggered.

Please note that it might take a few minutes until the new certificate appears.

Revoking a certificate

To revoke a certificate, simply select the "Revoke certificate" from the side bar. The certificate will then be revoked.

Please remember to uninstall the certificate from wherever it is being used, as it will lose its validity.