Enom SSL Certificates

From WHMCS Documentation

Revision as of 19:56, 22 August 2020 by Lawrence (talk | contribs) (Multiple Years)

Supported Certificate Types

This module allows you to automate SSL Certificate sales with the Enom platform. This allows you to offer the following types of certificate:

  • GeoTrust QuickSSL
  • GeoTrust QuickSSL Premium
  • GeoTrust TrueBizID
  • GeoTrust TrueBizID Wildcard
  • GeoTrust TrueBizID EV
  • RapidSSL
  • Comodo Essential
  • Comodo Instant
  • Comodo Premium Wildcard
  • Comodo Essential Wildcard
  • Comodo EV
  • Comodo EV SGC
  • VeriSign Secure Site
  • VeriSign Secure Site Pro
  • VeriSign Secure Site EV
  • VeriSign Secure Site Pro EV

Setting up the Product

Watch the video tutorial for this feature  

To setup an SSL certificate product, follow the steps below.

  1. Create a product as normal - name, description, no domain options, etc...
  2. Set the billing cycle to One Time and price as the base price for this certificate
  3. Ensure the welcome email is set to "None" in the dropdown menu as the module sends it's own email
  4. On the module settings tab, choose "Enomssl"
  5. Now enter your enom login details and choose the certificate type and length being offered with this product in the fields displayed
  6. Additionally, you can let the client choose these options on the order form and alter the price accordingly using configurable options. The option names supported to override the default settings are "Certificate Type" and/or "Years" - you can use both, just the years option or even neither.

Register your IP with eNom
Access to eNom's API is restricted by IP address so you will need to register the IP address from which you will be connecting to your account with them. See the IP Registration section below for details of how to do this.

IP Registration (User not permitted from this IP address)

In order to use the Enom API, you must first contact them and let them know the server IP address where you will be connecting from (the server IP address where you have WHMCS installed). This is part of Enom's security measures to prevent unauthorised users being able to submit registration requests to your account.

  • Login to your account on the Enom website,
  • Navigate to Resellers > Manage > API
  • Enter your server's IP address into the "New" field,
  • Click "add".

The Order Process

The product will appear in the order process as a regular product which can be added to the cart. No configuration is performed before purchase. Once purchased, paid for, and activated, the user is sent an email containing a link which takes them to configure the certificate in the client area. Once all details have been provided, the configuration data is sent to the Certificate Authority for validation. Once the certificate is issued, it is emailed to the client to install on their hosting account. No manual intervention is required from you.

Renewal

Due to limitations in Enom's API, SSL certificates cannot be renewed. Therefore your clients will need to place a new order when the certificate period ends and it's due for renewal. This is why we recommend setting up as a one time product in WHMCS.

Reissuing

Should a customer need to reissue their SSL certificate due to a change of server IP address or security breach at the issuer, please refer to this page for instructions: Reissueing Enom SSL Certificates.

Errors

User not permitted from this IP address

In order to use the Enomssl API, you must first contact them and let them know the server IP address where you will be connecting from (the server IP address where you have WHMCS installed). This is part of Enom's security measures to prevent unauthorised users being able to submit registration requests to your account.

Bad User name or Password

Ensure the username and password on the Module Settings tab matches with your eNom login details. If the test mode checkbox is ticked ensure you have registered on the test server.

Note:
The module create function of this module does not generate a username and password by design. Therefore the username/password fields will be blank under the client's Products/services tab.