Difference between revisions of "HEXONET"

From WHMCS Documentation
Line 21: Line 21:
 
To activate and begin using the HEXONET registrar module, follow the steps below:
 
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'''.
−
# Enter your HEXONET account password
 
−
# Click Save Changes to complete the process
 
  
 
<div class="docs-alert-info">
 
<div class="docs-alert-info">
Line 34: Line 32:
 
</div>[[File:Hexonet renewal mode.png|thumb|Renewal Mode Setting]]
 
</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'''.
−
#Click Save
 
  
 
===IP Registration===
 
===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'''.
 +
# Enter your server's IP address.
 +
# Click '''Save Changes'''.
 +
 
 +
You can find the IP address to whitelist at '''Help > License Information''' in the WHMCS Admin Area.
  
 
===Test Mode===
 
===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:
−
#Tick the ''TestMode'' checkbox
 
−
#Click ''Save Changes''
 
  
−
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].
 +
# In WHMCS, enter your HEXONET test account username and password.
 +
# Check '''TestMode'''.
 +
# '''Save Changes'''.
 +
 
 +
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'''.
  
 
===ProxyServer===
 
===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===
 
===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===
 
===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===
 
===TRANSFERLOCK===
Line 71: Line 75:
  
 
==Automatic Registration==
 
==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==
 
==Automatic Domain Synchronization==
 
The HEXONET module supports automatic domain synchronization for syncing of expiry dates and status changes for incoming transfers.
 
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:
 +
* Enable '''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'''.
 +
* Configure [[Crons#Domain_Sync_Cron|Domain Sync Cron]] on your system.
  
 
==Troubleshooting==
 
==Troubleshooting==
Line 84: Line 90:
 
===Disconnected / Authorization Failed===
 
===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===
 
===Empty response from API===
 +
This can occur when the API endpoint is unreachable. You can test this by running the <tt>ping api.ispapi.net</tt> command from the WHMCS server's command line.
  
−
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.
−
 
 
−
The module uses ports 80 & 443 to connect to HEXONET over HTTP. You will want to ensure these ports are whitelisted in your server firewall.
 
  
 
{{modules}}
 
{{modules}}

Revision as of 15:59, 28 September 2021

Supported Features

Register Transfer Renew Registrar Lock
Yes Yes Yes Yes
Update Nameservers Update WHOIS Get EPP Code Register Nameservers
Yes Yes Yes Yes
DNS Record Management Email Forwarding Domain Release Domain Sync Script
Yes Yes Yes Yes
Premium Domains Transfer Out Automation TLD Pricing Sync
Yes Yes No
This page describes a feature available in version 7.7 and above

Activation

To activate and begin using the HEXONET registrar module, follow the steps below:

  1. Log in to the WHMCS Admin Area.
  2. Go to Configuration () > System Settings > Domain Registrars or, prior to WHMCS 8.0, Setup > Products/Services > Domain Registrars.
  3. Click Activate for HEXONET.
  4. Enter your HEXONET account username and password.
  5. Click Save Changes.

Auto Renewal
Configure the default domain renewal mode to AUTOEXPIRE in your HEXONET Control Panel, otherwise domains might be renewed without being paid by the customer in WHMCS

Renewal Mode Setting
  1. Log in to the HEXONET control panel.
  2. Go to Products > Domain Name Settings. Click + More and search for it if you do not see it in the list.
  3. For Renewal Mode For New Domains, select Expire Domain.
  4. 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.

To do this:

  1. Log in to HEXONET.
  2. Click on your username in the upper-right corner.
  3. Navigate to Settings > Security > IP Restrictions.
  4. Enter your server's IP address.
  5. Click Save Changes.

You can find the IP address to whitelist at Help > License Information in the WHMCS Admin Area.

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:

  1. Create an test account here.
  2. In WHMCS, enter your HEXONET test account username and password.
  3. Check TestMode.
  4. Save Changes.

To return to live mode, enter your live HEXONET username and password at Configuration () > System Settings > Domain Registrars or, prior to WHMCS 8.0, Setup > Products/Services > Domain Registrars. Then, uncheck TestMode.

ProxyServer

Optionally, you can enter the URL of your proxy server. For more information, [see HEXONET's documentation.

IDN Configuration

By default, the HEXONET API converts domains to IDN format (recommended). Change this to PHP to make use of the idn_to_ascii function (deprecated). This function [must be compiled] in your php.ini file.

DNSSEC

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 maxSigLife setting.

TRANSFERLOCK

Enable to automatically apply the transfer lock to new domain registrations.

Automatic Registration

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, see 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:

  • Enable Domain Sync Enabled in Configuration () > System Settings > General Settings > Domains or, prior to WHMCS 8.0, Setup > General Settings > Domains.
  • Configure Domain Sync Cron on your system.

Troubleshooting

Disconnected / Authorization Failed

Common causes for a Disconnected or Authorization Failed error are:

  • An incorrect password or username in the registrar module settings at Configuration () > 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.
  • 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 than the production environment.

Empty response from API

This can occur when the API endpoint is unreachable. You can test this by running the ping api.ispapi.net command from the WHMCS server's command line.

The module uses ports 80 and 443 to connect to HEXONET over HTTP. Make sure that these ports are whitelisted in your server firewall.

Server Modules
cPanel/WHM - DirectAdmin - Plesk - Helm 3 - Helm 4 - Ensim - InterWorx - WebsitePanel - Cloudmin
Lxadmin - Virtualmin Pro - XPanel - HyperVM - SolusVM - Cloudmin - WHMSonic - VPS.Net
CentovaCast - SCPanel - MediaCP - GameCP - TCAdmin - Reseller Central - Auto Release - Heart Internet

Registrar Modules
Enom - ResellerClub - Nominet - OpenSRS - ResellOne - OnlineNIC - PlanetDomain - Affordable Domains
TPP Wholesale - TPPInternet - Stargate - Namecheap - NetEarthOne - Bizcn - InternetBS - GMO Internet
12Register - Registercom - DotDNS - WebNIC - Dot.TK - HexoNet - Realtime Register - Registereu
RRPProxy - ResellerCamp - TransIP - Heart Internet - IPMirror - NetRegistry - OVH - VentraIP Wholesale
Email - 101Domain

Fraud Modules
MaxMind - VariLogiX FraudCall - Telesign

Gateway Modules
2CheckOut - AsiaPay - Auth.net Echeck - Authorize.net - Authorize.net CIM - Bank Transfer - BidPay
BluePay - BluePay Echeck - BluePay Remote - Boleto - CashU - CC Avenue - ChronoPay - Direct Debit
EMatters - E-Path - eProcessingNetwork - eWAY Tokens - F2B - Finansbank - GarantiBank - Gate2Shop
Inpay - InternetSecure - IP.Pay - Kuveytturk - Modulo Moip - Mail In Payment - Merchant Partners
Merchant Warrior - IDEALMollie - Moneris - Moneris Vault - Skrill 1-Tap - NaviGate - NETbilling
Netregistry Pay - NoChex - Offline Credit Card - Optimal Payments - PagSeguro - Payflow Pro - Pay Junction
Paymate AU and NZ - Payment Express - PayPal - PayPal Card Payments - PayPal Express Checkout
PayPal Payments - PayPal Payments Pro - PayPoint.net (SecPay) - Payson - Planet Authorize - ProtX VSP Form
PSIGate - Quantum Gateway - Quantum Vault - SagePay - SagePay Tokens v2 - SecurePay
SecurePay AU - Secure Trading - TrustCommerce - USA ePay - WorldPay - WorldPay Invisible


Retrieved from "http://3.17.75.209/index.php?title=HEXONET&oldid=30773"