HEXONET - Revision history

JuanR: /* Automatic Domain Synchronization */

2023-06-07T12:18:21Z

‎Automatic Domain Synchronization

SarahK: /* Disconnected / Authorization Failed */

2022-04-22T20:26:30Z

‎Disconnected / Authorization Failed

SarahK: /* IP Registration */

2022-04-22T20:26:04Z

‎IP Registration

SarahK: /* Activation */

2022-04-11T22:18:15Z

‎Activation

SarahK: /* Activation */

2022-04-11T22:17:50Z

‎Activation

SarahK at 22:16, 11 April 2022

2022-04-11T22:16:51Z

SarahK at 15:59, 28 September 2021

2021-09-28T15:59:10Z

SarahK at 19:05, 4 August 2020

2020-08-04T19:05:06Z

DanR: /* =Disconnected / Authorization Failed */

2020-06-11T17:10:53Z

‎=Disconnected / Authorization Failed

DanR: /* Troubleshooting */

2020-06-11T17:10:40Z

‎Troubleshooting

@@ Line 68: / Line 68: @@
 == Automatic Domain Synchronization ==
-−
 This module supports automatic domain synchronization for syncing expiry dates and status changes for incoming transfers.
-−
-To use this, enable '''Domain Sync Enabled''' in the '''[[Domains_Tab|Domains]]''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' or, prior to WHMCS 8.0, '''Setup > General Settings'''. You must also make certain to configure the '''[[Crons#Domain_Sync_Cron|Domain Sync Cron]]'''.
+To use this, enable '''Domain Sync Enabled''' and [[Domain_Synchronisation#Configuration|configure the domain sync task]] at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Automation Settings]]''' or, prior to WHMCS 8.0, '''Setup > Automation Settings'''.
 == Troubleshooting ==

@@ Line 78: / Line 78: @@
 Common causes for a ''Disconnected'' or ''Authorization Failed'' error are:
-* An incorrect password or username in the registrar module settings at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Domain Registrars''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Domain Registrars'''.
+* An incorrect password or username in the registrar module settings at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Domain Registrars]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Domain Registrars'''.
 * Two-Factor authentication is enabled for the user in your HEXONET account. This can be resolved by deactivating it for your HEXONET user or creating a restricted user role and new user that WHMCS will use to connect to HEXONET's API.
 * IP address restriction settings in your HEXONET account do not allow your WHMCS server to connect to the HEXONET API.

@@ Line 53: / Line 53: @@
 # Click '''Save Changes'''.
-You can find the IP address to whitelist at '''Help > License Information''' in the WHMCS Admin Area.
+You can find the IP address to whitelist at '''Help > [[License Information]]''' in the WHMCS Admin Area.
 ===Test Mode===

@@ Line 32: / Line 32: @@
 # Enter your HEXONET credentials and configuration.
 #* For help with using a proxy server, see [https://wiki.hexonet.net/wiki/HighPerformanceProxySetup HEXONET's documentation].
-#* By default, the HEXONET API converts domains to IDN format (recommended). Change this to PHP to make use of the <tt>idn_to_ascii</tt> function (deprecated). This function [[http://php.net/manual/en/function.idn-to-ascii.php must be compiled]] in your <tt>php.ini</tt> file.
+#* By default, the HEXONET API converts domains to IDN format (recommended). Change this to PHP to make use of the <tt>idn_to_ascii</tt> function (deprecated). This function [http://php.net/manual/en/function.idn-to-ascii.php must be compiled] in your <tt>php.ini</tt> file.
 #* Check '''DNSSEC''' to display the DNSSEC configuration interface in the Client Area domain details page. This feature allows your customer to add DS and KEY records and set the <tt>maxSigLife</tt> setting.
 #* Check '''TRANSFERLOCK''' to automatically apply the transfer lock to new domain registrations.

@@ Line 30: / Line 30: @@
 # Find '''HEXONET''' in the list.
 # Click '''Activate'''.
-# Enter your HEXONET credentials.
+# Enter your HEXONET credentials and configuration.
 #* For help with using a proxy server, see [https://wiki.hexonet.net/wiki/HighPerformanceProxySetup HEXONET's documentation].
 #* By default, the HEXONET API converts domains to IDN format (recommended). Change this to PHP to make use of the <tt>idn_to_ascii</tt> function (deprecated). This function [[http://php.net/manual/en/function.idn-to-ascii.php must be compiled]] in your <tt>php.ini</tt> file.

@@ Line 1: / Line 1: @@
 {{registrar
 | register = yes
@@ Line 15: / Line 22: @@
 | transferout = yes
 }}
-<div class="docs-alert-info"><i class="fa fa-question-circle"></i> This page describes a feature available in version 7.7 and above</div>
+To activate and begin using the HEXONET registrar module:
 # Log in to the WHMCS Admin Area.
-# Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Domain Registrars''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Domain Registrars'''.
+# Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Domain Registrars]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Domain Registrars'''.
-# Click '''Activate''' for '''HEXONET'''.
+# Find '''HEXONET''' in the list.
-# Enter your HEXONET account username and password.
+# Click '''Activate'''.
 # Click '''Save Changes'''.
+# Log in to the HEXONET control panel. [[File:Hexonet renewal mode.png|thumb|Renewal Mode Setting]]
 # Go to '''Products > Domain Name Settings'''. Click '''+ More''' and search for it if you do not see it in the list.
-# For '''Renewal Mode For New Domains''', select '''Expire Domain'''.
+# For '''Renewal Mode For New Domains''', select '''Expire Domain'''. If you do not do this, domains might be renewed without payment from the client.
 # Click '''Save'''.
 ===IP Registration===
 HEXONET's API is '''not''' IP address-restricted by default. However, you can configure this restriction in the control panel to improve security.
@@ Line 51: / Line 56: @@
 ===Test Mode===
-To use it:
+You can use test mode to simulate domain registration and management function without registering a domain or incurring charges. This can be useful to test WHMCS configurations.
-# [https://www.hexonet.net/signup-ote Create an test account here].
+To use Test Mode, you must create a [https://www.hexonet.net/signup-ote HEXONET test account].
-To return to live mode, enter your live HEXONET username and password at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Domain Registrars''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Domain Registrars'''. Then, uncheck '''TestMode'''.
+== Automatic Registration ==
-===ProxyServer===
+WHMCS allows you to set up automatic domain registration on a per-extension basis, enabling you to use different registrars for different TLDs.
-===TRANSFERLOCK===
+To enable automatic registration, see [[Domain Pricing]].
-To enable automatic registration, see [[Domain Pricing|Configuring Automatic Registration]]
+== Automatic Domain Synchronization ==
-==Automatic Domain Synchronization==
+This module supports automatic domain synchronization for syncing expiry dates and status changes for incoming transfers.
-To enable this functionality:
+To use this, enable '''Domain Sync Enabled''' in the '''[[Domains_Tab|Domains]]''' tab at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' or, prior to WHMCS 8.0, '''Setup > General Settings'''. You must also make certain to configure the '''[[Crons#Domain_Sync_Cron|Domain Sync Cron]]'''.
-==Troubleshooting==
+== Troubleshooting ==
 ===Disconnected / Authorization Failed===

@@ Line 21: / Line 21: @@
 To activate and begin using the HEXONET registrar module, follow the steps below:
-# Login to your WHMCS Admin Area
+# Log in to the WHMCS Admin Area.
-# Navigate to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Domain Registrars''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Domain Registrars'''.
+# Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Domain Registrars''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Domain Registrars'''.
-# Locate HEXONET in the list
+# Click '''Activate''' for '''HEXONET'''.
-# Click the '''Activate''' button
+# Enter your HEXONET account username and password.
-# Enter your HEXONET account username
+# Click '''Save Changes'''.
 <div class="docs-alert-info">
@@ Line 34: / Line 32: @@
 </div>[[File:Hexonet renewal mode.png|thumb|Renewal Mode Setting]]
-#Login to the HEXONET Control Panel
+# Log in to the HEXONET control panel.
-#Navigate to '''Products > Domain Name Settings'''
+# Go to '''Products > Domain Name Settings'''. Click '''+ More''' and search for it if you do not see it in the list.
-#* Use ''+ More'' if that menu entry is not available and search for it in that list
+# For '''Renewal Mode For New Domains''', select '''Expire Domain'''.
-#In the ''Renewal Mode For New Domains'' setting, select the ''Expire Domain'' option
+# Click '''Save'''.
 ===IP Registration===
-HEXONET's API is '''not''' IP restricted by default, but can be configured in that direction to improve security. This can be done in the HEXONET control panel.
+HEXONET's API is '''not''' IP address-restricted by default. However, you can configure this restriction in the control panel to improve security.
-# Login to the HEXONET control panel
-# Click on your username in the upper right
+To do this:
 # Navigate to '''Settings > Security > IP Restrictions'''
-# Enter your server's IP address
+# Log in to HEXONET.
-# Save Changes
+# Click on your username in the upper-right corner.
-You can find the IP you need to whitelist by navigating to '''Help > License Information''' within your WHMCS admin area
+# Navigate to '''Settings > Security > IP Restrictions'''.
 ===Test Mode===
-The HEXONET's OT&E (Operational Test & Evaluation) system permits testing of domain registration and management actions without actually registering domains so no charges are incurred. To use it:
+The HEXONET's OT&E (Operational Test & Evaluation) system permits testing of domain registration and management actions without actually registering domains so no charges are incurred.
-#[https://www.hexonet.net/signup-ote Create an test account here]<br/>
-#In WHMCS enter your HEXONET test account username and password
+To use it:
-To return to live mode, enter your live HEXONET username and password into the WHMCS Domain Registrars page and untick the TestMode option.
+# [https://www.hexonet.net/signup-ote Create an test account here].
 ===ProxyServer===
-Whilst optional, you can enter the URL of your proxy server, instructions for configuring a proxy server are located at https://wiki.hexonet.net/wiki/HighPerformanceProxySetup
+Optionally, you can enter the URL of your proxy server. For more information, [[https://wiki.hexonet.net/wiki/HighPerformanceProxySetup see HEXONET's documentation].
 ===IDN Configuration===
-By default the HEXONET API is used to convert domains to IDN format (recommended).  Change to PHP to make use of the idn_to_ascii function can be made to handle conversion instead (deprecated). This function must be compiled in your php.ini to operate: http://php.net/manual/en/function.idn-to-ascii.php
+By default, the HEXONET API converts domains to IDN format (recommended). Change this to PHP to make use of the <tt>idn_to_ascii</tt> function (deprecated). This function [[http://php.net/manual/en/function.idn-to-ascii.php must be compiled]] in your <tt>php.ini</tt> file.
 ===DNSSEC===
-This can be enabled to display the DNSSEC configuration interface in the client area domain details page. This feature allows your customer to add DS and KEY records and set the maxSigLife.
+Enable this to display the DNSSEC configuration interface in the Client Area domain details page. This feature allows your customer to add DS and KEY records and set the <tt>maxSigLife</tt> setting.
 ===TRANSFERLOCK===
@@ Line 71: / Line 75: @@
 ==Automatic Registration==
-WHMCS allows you to setup automatic domain registration on a per extension basis enabling you to use different registrars for different TLDs to give you the flexibility to offer more extensions and always get the best value.
+WHMCS allows you to set up automatic domain registration on a per-extension basis, enabling you to use different registrars for different TLDs.
-To enable automatic registration, please refer to [[Domain Pricing|Configuring Automatic Registration]]
+To enable automatic registration, see [[Domain Pricing|Configuring Automatic Registration]]
 ==Automatic Domain Synchronization==
 The HEXONET module supports automatic domain synchronization for syncing of expiry dates and status changes for incoming transfers.
-To enable this functionality, you need to ensure you have the '''Domain Sync Enabled''' in '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings > Domains''' or, prior to WHMCS 8.0, '''Setup > General Settings > Domains''' and ensure you have the [[Crons#Domain_Sync_Cron|Domain Sync Cron]] configured on your system.
+To enable this functionality:
 ==Troubleshooting==
@@ Line 84: / Line 90: @@
 ===Disconnected / Authorization Failed===
-Common causes for a 'Disconnected' or 'Authorization Failed' error are :
+Common causes for a ''Disconnected'' or ''Authorization Failed'' error are:
-# Incorrect password and/or username in the Registrar module settings (Setup > Products/Services > Domain Registrars > "Configure")
+* An incorrect password or username in the registrar module settings at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Domain Registrars''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Domain Registrars'''.
-# Two-Factor authentication is enabled for the user in your HEXONET account. This can be resolved by deactivating Two-Factor for your HEXONET user, or creating a restricted user role and new user which WHMCS will use to connect to HEXONET's API.
+* Two-Factor authentication is enabled for the user in your HEXONET account. This can be resolved by deactivating it for your HEXONET user or creating a restricted user role and new user that WHMCS will use to connect to HEXONET's API.
-# IP Restriction Settings in your HEXONET account do not allow connections from your WHMCS Server to the HEXONET API
+* IP address restriction settings in your HEXONET account do not allow your WHMCS server to connect to the HEXONET API.
-# Your server firewall is blocking the connection
+* Your server firewall is blocking the connection.
-# You are connecting to the Test Environment using your HEXONET production account or vice versa. The HEXONET OTE API uses a different set of login credentials to the production environment.
+* You are connecting to the test environment using your HEXONET production account or vice versa. The HEXONET OTE API uses a different set of login credentials than the production environment.
 ===Empty response from API===
-This can occur in case the API endpoint is unreachable. You can test this by trying to ping `api.ispapi.net` from your WHMCS server command line.
+The module uses ports <tt>80</tt> and <tt>443</tt> to connect to HEXONET over HTTP. Make sure that these ports are whitelisted in your server firewall.
 {{modules}}