Skip to content

cPanel AutoSSL

Vladislavs Dovoreckis edited this page Feb 12, 2024 · 3 revisions

About

This module is used for ordering, configuring, and automatically installing SSL certificates in cPanel via GoGetSSL WHMCS SSL addon. For automatic certificate validation and installation to work correctly, you must use cPanel services in WHMCS.

Configuration & Installation

  • Login to the server where your WHMCS is located

  • Copy all files from the package to the server (in the WHMCS directory)

  • Log in to the WHMCS admin panel

  • Go to System Settings → Addon Modules

  • Activate the SSLCENTER WHMCS module; if you already had it installed, you do not need to do this

  • Select appropriate permissions for this module to make it available in the Addons tab

  • Now go to Addons → SSLCENTER WHMCS

  • Full documentation for the standard SSLCENTER WHMCS module can be found here

  • The new cron has been added to the module; add it to crontab for the certificate installation to work properly; cron runs once a day 0 0 * * * php -q /home/dev24/public_html/dev/modules/addons/SSLCENTERWHMCS/cron/installCertificates.php

  • Check these options for proper work of the plugin

git_cpanel_auto_02

  • Two new tabs, Orders and Logs, have been added to the module
  • In the Orders tab, you will find all SSL orders that have been placed since the installation of the current version of the module.

git_cpanel_auto_03

  • In the Logs tab you will find logs regarding the validation and installation of certificates in cPanel.

git_cpanel_auto_04

  • Please remember that to use certificate installation in cPanel, a given client account in WHMCS must have an active cPanel service

Flow

  • Log in as a client to WHMCS
  • You can check to be sure whether the client account has active cPanel services

git_cpanel_auto_05

  • Now you can proceed to ordering an SSL certificate

git_cpanel_auto_06b

  • After ordering and paying for the certificate, proceed to the certificate configuration

git_cpanel_auto_07b

git_cpanel_auto_08b

  • In this tab, you can select the appropriate domain from cPanel; if you do not have any cPanel service, this step will be skipped

git_cpanel_auto_09

  • After selecting the domain, complete the data and click "Continue"

git_cpanel_auto_10a

  • If you choose the Custom domain option, you will be able to generate a CSR with any domain, but you must remember that in such a situation, automatic validation and certificate installation will not work correctly

  • Now select your verification method and click "Continue"

git_cpanel_auto_11

  • Remember that for automatic certificate validation to work properly, you must select the HTTP, HTTPS, or DNS verification method; if you choose the EMAIL method, you will have to validate the certificate manually

  • Once the configuration is complete, you should receive a success message

git_cpanel_auto_12

  • Sometimes, after completing the configuration, it may happen that the certificate will not be validated immediately; in such a situation, we recommend waiting a few minutes and clicking the Revalidate button; then everything should be fine

git_cpanel_auto_13

  • Now all you have to do is wait for the certificate installation cron to install the certificate in cPanel

  • If you don't want to wait, you can use the Install Certificate button; this button is only available when the certificate status is Active

git_cpanel_auto_14

  • You can check all operations on the certificate in the admin panel in WHMCS in the Orders and Logs tabs, which we described earlier
  • In the Orders tab, you can also see the "Set as installed" and "Set as verified" buttons - these buttons are only used to change the status in WHMCS; if you press the "Set as installed" button, it does not mean that the certificate will actually be installed in cPanel. This button was added just in case you install certificates outside of cPanel
  • Also, please remember that Cron will try to install certificates only for orders with the PENDING INSTALLATION status. If a certificate has already been validated and does not have the PENDING INSTALLATION status, click the Set as verified button