---
title: "SetupGuide WHMCS SSL plugin"
url: "https://help.internetx.com/en/integrations/setupguide-whmcs-ssl-plugin/"
lang: "en"
section: "Integrations"
---

# SetupGuide WHMCS SSL plugin

<img src="/images/7669957-1debf90c.png" data-htmlarea-file-uid="1012" data-htmlarea-file-table="sys_file" width="250" height="63" title="" alt="SetupGuide WHMCS SSL plugin" data-title-override="true" data-alt-override="true" loading="lazy" decoding="async" />

InterNetX SSL For WHMCS is a plugin which allows you to offer TLS/SSL certificates provided by InterNetX SSL Manager.

# Features and compatibility

## Admin area

-   Create certificate
-   Renew certificate
-   Delete certificate

### Client area 

-   Prepare certificate creation request
-   View certificate details
-   View administrative & technical contacts

### Compatibility

Supports WHMCS V7 and later

### Certificates provided by InterNetX

Geo Trust Basic SSL

## Installation and configuration

In this section we will show you how to properly install and configure your InterNetX SSL for WHMCS. For general information see WHMCS documentation home: [http://docs.whmcs.com/Main\_Page](http://docs.whmcs.com/Main_Page)

-   Upload plugin files to your server into your **root WHMCS directory**.
-   Set up your product in the **Admin Area**.   
    Go to the **Setup** → **Products/Services** → **Products/Services** and create a new group for TLS/SSL through pressing **Create a New Group**.
-   Afterwards, fill **Product Group Name** field and press **Save Changes**.
-   The next step is to create your products. To do so, go to **Products/Services** and press **Create a New Product**.
-   Now choose previously created Product Group, type your **Product Name** and press **Continue**.
-   At the **Details** tab deselect **Require Domain**. The **Domain** field will be created later.

<img src="/images/b1-654bc024.png" data-htmlarea-file-uid="1048" data-htmlarea-file-table="sys_file" width="700" height="358" title="" alt="Installation and configuration" data-title-override="true" data-alt-override="true" data-htmlarea-zoom="true" loading="lazy" decoding="async" />

-   In the **Pricing** tab select **One Time** or **Recurring** according to your needs, enter your prices and check **Enable**.

<img src="/images/b2-57feff45.png" data-htmlarea-file-uid="1047" data-htmlarea-file-table="sys_file" width="600" height="186" title="" alt="Installation and configuration (2)" data-title-override="true" data-alt-override="true" data-htmlarea-zoom="true" loading="lazy" decoding="async" />

-   In addition you can use **Configurable Options** to let the client select the lifetime and the respective price. For the client it looks like this:

<img src="/images/b3-ae4792d8.png" data-htmlarea-file-uid="1046" data-htmlarea-file-table="sys_file" width="600" height="253" title="" alt="Installation and configuration (3)" data-title-override="true" data-alt-override="true" data-htmlarea-zoom="true" loading="lazy" decoding="async" />

-   To enable the **Configurable Options**, create a **New Group** by selecting **Setup** → **Product/Services** → **Configurable Options** and clicking **Create a New Group**.
-   Select an assigned certificate and click **Save Changes**.

<img src="/images/b4-f5a780d3.png" data-htmlarea-file-uid="1045" data-htmlarea-file-table="sys_file" width="750" height="297" title="" alt="Installation and configuration (4)" data-title-override="true" data-alt-override="true" data-htmlarea-zoom="true" loading="lazy" decoding="async" />

-   Then click **Add New Configurable Option.** This will open a new window with the **Configurable Options**.
-   Enter the **Option Name** L**ifetime|Lifetime (months)** and select the **Option Type** radio.
-   Add an **Option** e.g. **12** for 12 months. Repeat this step for e.g. **24** and **36** months.
-   Define prices for the assigned certificate and click **Save Changes.**

<img src="/images/b5-f5ebaed0.png" data-htmlarea-file-uid="1044" data-htmlarea-file-table="sys_file" width="700" height="435" title="" alt="Installation and configuration (5)" data-title-override="true" data-alt-override="true" data-htmlarea-zoom="true" loading="lazy" decoding="async" />

-   Repeat these steps for each certificate and its pricing/lifetime.

If you switched from standard pricing to **Configurable Option Pricing**, you need to set the product pricing back to zero to avoid doubled prices!

<img src="/images/b6-b42bcd54.png" data-htmlarea-file-uid="1043" data-htmlarea-file-table="sys_file" width="700" height="235" title="" alt="Installation and configuration (6)" data-title-override="true" data-alt-override="true" data-htmlarea-zoom="true" loading="lazy" decoding="async" />

-   You may need to check the settings for **Currencies**, e.g. dot or comma separated prices.

<img src="/images/b7-a2e109f9.png" data-htmlarea-file-uid="1042" data-htmlarea-file-table="sys_file" width="700" height="152" title="" alt="Installation and configuration (7)" data-title-override="true" data-alt-override="true" data-htmlarea-zoom="true" loading="lazy" decoding="async" />

For further information on **Configurable Options** see: [http://docs.whmcs.com/Addons\_and\_Configurable\_Options](http://docs.whmcs.com/Addons_and_Configurable_Options)

-   In the **Module Settings** tab select **InterNetX\_SSL** from the **Module Name** dropdown menu and click **Save Changes**.
-   Now you can configure your product and its connection to the API. Fill in the **Host**, **Username**  **Password** and **Context** fields with your API connection details.
    -   The regular InterNetX API URL is: [gateway.autodns.com/](https://gateway.autodns.com/).
    -   The **SSL Context** usually is “9”. The client can change the **Software** later on himself during the order process in the client area.
-   Click **Custom Fields** in order to generate a custom field for the domain name, which allows the input of the TLS/SSL domain name during the order process in the client area.

<img src="/images/b8-b84e0ce9.png" data-htmlarea-file-uid="1041" data-htmlarea-file-table="sys_file" width="700" height="331" title="" alt="Installation and configuration (8)" data-title-override="true" data-alt-override="true" loading="lazy" decoding="async" />

For access to our demo system (sandbox) please contact [sales@internetx.com](mailto:sales@internetx.com).

## Certificate request

-   To order a new certificate go to **Client Area** →  **Services** → **Order New Services** and select the desired certificate.

<img src="/images/b9-0227db0d.png" data-htmlarea-file-uid="1049" data-htmlarea-file-table="sys_file" width="750" height="451" title="" alt="Certificate request" data-title-override="true" data-alt-override="true" data-htmlarea-zoom="true" loading="lazy" decoding="async" />

-   Select the desired lifetime in the **Choose Billing Cycle** drop-down to and enter the domain for which the certificate should be issued.
-   Click on **Continue** and proceed with checkout.

<img src="/images/b10-141fa14c.png" data-htmlarea-file-uid="1050" data-htmlarea-file-table="sys_file" width="700" height="229" title="" alt="Certificate request (2)" data-title-override="true" data-alt-override="true" data-htmlarea-zoom="true" loading="lazy" decoding="async" />

After successful checkout, payment and after activation of the order by the Admin, the Client is able to do the final configuration for the Certificate request in the Client Area. In order to send correct TLS/SSL certificate creation requests, your client has to provide the Certificate Signing Request (CSR). The certificate request will be used along with your client's details in order to send the TLS/SSL certificate creation request.

-   To start the certificate issuing process go to **Client Area** → **Services** → **My Services** and select the previously ordered certificate.
-   Then go to **Click to configure certificate.**

<img src="/images/b11-0fc73e56.png" data-htmlarea-file-uid="1054" data-htmlarea-file-table="sys_file" width="700" height="382" title="" alt="Certificate request (3)" data-title-override="true" data-alt-override="true" loading="lazy" decoding="async" />

### Configuration of S/MIME certificates

Please enter the desired S/MIME enduser password and the details of the **Administrative Contact.**

<img src="/images/b12-80701b64.png" data-htmlarea-file-uid="1051" data-htmlarea-file-table="sys_file" width="500" height="424" title="" alt="Configuration of S/MIME certificates" data-title-override="true" data-alt-override="true" loading="lazy" decoding="async" />

### Certificate configuration

### Configuration of TLS/SSL certificates

-   Select the desired value from the **Web Server Type** drop-down menu and paste the previously generated certificate request into the field **CSR** on the following screen.

<img src="/images/b13-a83b633d.png" data-htmlarea-file-uid="1055" data-htmlarea-file-table="sys_file" width="700" height="462" title="" alt="Configuration of TLS/SSL certificates" data-title-override="true" data-alt-override="true" loading="lazy" decoding="async" />

-   Afterwards, fill the official administrative and technical contact fields. Complete this step by selecting **Click to Continue.**

<img src="/images/b14-abbbc8df.png" data-htmlarea-file-uid="1056" data-htmlarea-file-table="sys_file" width="300" height="515" title="" alt="Configuration of TLS/SSL certificates (2)" data-title-override="true" data-alt-override="true" data-htmlarea-zoom="true" loading="lazy" decoding="async" />

-   Now select the desired **Certificate Approver Email** and send the TLS/SSL certificate request by selecting **Click to Continue**.
    
    -   <img src="/images/b15-39f50100.png" data-htmlarea-file-uid="1052" data-htmlarea-file-table="sys_file" width="650" height="380" title="" alt="Configuration of TLS/SSL certificates (3)" data-title-override="true" data-alt-override="true" data-htmlarea-zoom="true" loading="lazy" decoding="async" />
    
    You will be informed about the progress of ordering the TLS/SSL certificate through emails sent to the chosen email address.
    

### Viewing your newly created TLS/SSL certificate in the client area

As soon as your certificate is issued, you will find basic information about it in your client area on the product details page.

Clicking the respective buttons shows the Contact details and the issued **Certificate**.

<img src="/images/b16-72e2e2db.png" data-htmlarea-file-uid="1053" data-htmlarea-file-table="sys_file" width="600" height="455" title="" alt="Viewing your newly created TLS/SSL certificate in the client area" data-title-override="true" data-alt-override="true" loading="lazy" decoding="async" />

## Viewing a newly created TLS/SSL certificate in the client area

As soon as your certificate is issued, you will find basic information about it in your client area on the product details page.

Clicking the respective buttons shows the contact details and the issued certificate.

<img src="/images/b16-72e2e2db.png" data-htmlarea-file-uid="1053" data-htmlarea-file-table="sys_file" width="700" height="531" title="" alt="Viewing a newly created TLS/SSL certificate in the client area" data-title-override="true" data-alt-override="true" data-htmlarea-zoom="true" loading="lazy" decoding="async" />

## Managing TLS/SSL certificates in the admin area

In the admin area you can easily manage the product status using **Create**, **Renew** and **Terminate** buttons. In addition, resending of the configuration and the approver emails is possible.

<img src="/images/b17-b3763cae.png" data-htmlarea-file-uid="1057" data-htmlarea-file-table="sys_file" width="750" height="470" title="" alt="Managing TLS/SSL certificates in the admin area" data-title-override="true" data-alt-override="true" data-htmlarea-zoom="true" loading="lazy" decoding="async" />
