Revision as of 17:10, 11 June 2020

Supported Features

Activation

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

1. Login to your WHMCS Admin Area
2. Navigate to Setup > Products/Services > Domain Registrars
3. Locate HEXONET in the list
4. Click the Activate button
5. Enter your HEXONET account username
6. Enter your HEXONET account password
7. Click Save Changes to complete the process

Renewal Mode Setting

1. Login to the HEXONET Control Panel
2. Navigate to Products > Domain Name Settings
   • Use + More if that menu entry is not available and search for it in that list
3. In the Renewal Mode For New Domains setting, select the Expire Domain option
4. 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.

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

You can find the IP you need to whitelist by navigating to Help > License Information within your 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. Tick the TestMode checkbox
4. 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.

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

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

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.

TRANSFERLOCK

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

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.

To enable automatic registration, please refer to 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 Setup > General Settings > Domains and ensure you have the Domain Sync Cron configured on your system.

Troubleshooting

=Disconnected / Authorization Failed

Common causes for a 'Disconnected' or 'Authorization Failed' error are :

1. Incorrect password and/or username in the Registrar module settings (Setup > Products/Services > Domain Registrars > "Configure")
2. 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.
3. IP Restriction Settings in your HEXONET account do not allow connections from your WHMCS Server to the HEXONET API
4. Your server firewall is blocking the connection
5. 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.

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 80 & 443 to connect to HEXONET over HTTP. You will want to ensure these ports are whitelisted in your server firewall.