Personal tools
Namespaces

Variants
Actions

Servertastic SSL For cPanel

From ModulesGarden Wiki
Revision as of 12:30, 9 June 2017 by Gregor (Talk | contribs)

Jump to: navigation, search


Contents

About Servertastic SSL For cPanel

Servertastic For cPanel will allow your clients to automatically install free SSL certificates on their websites.

You will easily trace the progress on SSL configuration, toggle automatic renewals and handle other essential HTTPS features.
Your clients, at once, will be given the opportunity to supervise owned certificates straight in your cPanel area.

  • WHM Area:
✔ View List Of Domains With Installed Certificates
✔ Renew/Remove Installed Certificates
✔ View Task Status Of Cron Executions
✔ View Detailed Logs Of API Errors
✔ Set Email For Notifications On Certificates Approvals
✔ Define Limit Of Cron Retries
✔ Toggle Auto Renewals Of Certificates
✔ Choose File Or DNS Method Of SSL Authentication
  • cPanel Area:
✔ Install Free Certificate For Main And Addon Domains
✔ View Basic Certificate Details
✔ Renew/Remove Installed Certificates
  • General Info
✔ Supports Free HTTPS Certificates
✔ Renewal Support - Automatically Creates New Certificate For Recurring Products After Expiration Date
✔ Multi-Language Support
✔ Supports cPanel & WHM 56 And Later

Installation and Configuration

This tutorial will show you how to successfully install and configure Servertastic SSL For cPanel.

We will guide you step by step through the whole installation and configuration process.

Installation

1. Log in to our client area and download the module.
STCP 1.png
2. Upload and extract the module into the /root cPanel directory.

Files in your cPanel /root/ServertasticSSL directory should look like on the following screen.

STCP 2.png
3. Once the module is uploaded, run the following command from the console:
sudo sh /root/ServertasticSSL/install

Next, follow the instruction displayed on the console. Type the yes command to confirm. After a brief moment you should see a confirmation that the plugin is installed successfully.

STCP 3.png

Configuration

4. In order to configure the plugin, go to 'WHM' 'Plugins' 'Servertastic SSL' .
STCP 4.png
5. Click the 'Configuration' and fill in the following records:
  • API Key – provide the key to successfully connect with your API. To obtain that key log in to your 'Reseller Panel' and click 'View your API Key' :

STCP 10 1.png

  • Test Mode - select to connect with the test API.
  • API Logs – if selected, all requests and API responses will be recorded in the Logs section.
  • Cron Retry Limit – define the number of maximum allowed retries of a single request.
  • Notifications Email – provide e-mail address where notifications of issued certificates will be delivered.
  • Verification Method – choose File or DNS verification method to validate domain ownership automatically.
  • Auto Renew – if selected, certificate will be automatically renewed 30 days before its expiration date.

When ready, test the connection and save the configuration.

STCP 5.png
Congratulations! Your module is ready for use.

Management

Servertastic SSL For cPanel allows you to offer free SSL certificates to your clients.

Additionally, you have the ability to view details and manage each provisioned certificate.

WHM Area

In the WHM area you can view key details of each certificate and monitor the status of SSL configuration.

In addition, you can explore Cron and API logs.

Domains

In this section you will find all domains available in WHM as well as essential information about installed certificates.

You can view the current status and type of each certificate along with its expiration date, as well as use the options to Renew or Remove certificate. Click 'Error' button to see detailed logs of any API errors.

STCP 6.png

Cron

In the Cron section, you will find all existing cron tasks. Tasks are added in case any error occurs when a request for certificate installation is verified.

As you can see, the administrator can either manually trigger the action again or wait for the next cron run (the cron runs every 5 minutes by default).

STCP 7.png

Logs

The Logs section includes the list of all failed cron executions. You can clear the logs if necessary.

Please remember that you may always turn the logs off in the configuration tab or by switching button On to Off.

STCP 8.png
Clicking on the token number will move you to the more detailed error log with API requests and responses.
STCP 9.png

cPanel Area

Servertastic SSL For cPanel allows your customers to set up and configure free SSL certificate for main or addon domains.

Log into your cPanel account. Then proceed to the 'Security' 'HTTPS Installer' .

STCP 13.png

Request

You can see the list of your domains with their current status. Press Install New Certificate for a given domain to submit the request for a free certificate.
STCP 14.png
Before you can continue, you need to fill in the Admin and Tech contact details.

Please note that Technical contact details are automatically filled out with the same details as the Admin contact.
If you want to use different details, simply change them. Press Add Certificate when ready.

STCP 16.png

Management

In case any issues occur while verifying the request, a cron task is automatically added to the line.

The administrator may then trigger the action manually or wait until the system runs cron to process the request again.

STCP 17.png
If the verification is successful and domain certificate is installed, the relevant information appears on the list.
STCP 18.png
Finally, there are three actions available to perform on the certificate:
STCP 18 2.png
  • View certificate details
  • Renew the certificate manually
  • Remove the certificate
STCP 19.png

Tips

1. When you want to update or uninstall plugin simply run the 'install' file again:
sudo sh /root/ServertasticSSL/install

Then follow the instructions on the screen by choosing the first or second option:

STCP 20.png

Common Problems

1. When you have problems with connection, check whether your SELinux or firewall does not block ports.
Navigation
WHMCS Modules
WHMCS Widgets
Translations
cPanel Modules
General
FAQ
Community
Servertastic SSL For cPanel