Install and use the OpenSRS Domains Pro module for WHMCS

Follow these steps to install the OpenSRS Domains Pro module for WHMCS:

Download the latest version of Opensrspro WHMCS module

Download latest version from:  https://opensrs.com/integration/tools/whmcs/

Extract and upload to your WHMCS application

Extract and upload to your WHMCS application, maintaining the folder structure (the WHMCS folder in our module is your base WHMCS directory on your server).

If you have modified your english.php file

If you have modified your english.php file, modify it to include the content of our "append_to_lang.txt" file in WHMCS/lang/

If you have modified your additionaldomainfields.php file

If you have modified your additionaldomainfields.php file, copy the additional lines from /includes/append_to_additionaldomainfields.php file to it.

Log into WHMCS Admin interface to Setup

Log into your WHMCS admin interface and visit Setup >> Product/Services >> Domain Registrars and activate OpenSRS Pro.

 

Generate an API Key

You will need to get/generate an API key for your reseller account, as well as whitelist your server's OUTBOUND IP address to access your account.

Log into your reseller account,

You can get there by clicking here: https://manage.opensrs.com

Go to Account Settings

Access your account settings by mousing over the gear in the top-right corner, and choosing "Account Settings"

Click the "API Settings" tab

Copy your API Key from the "API Settings" tab

Under "IP Access Rules"

Click the "Edit" link to configure your accounts rules.

Server's OUTBOUND IP Address

Enter your server's OUTBOUND IP Address, and Submit.

Whitelist a range of IP's

If you need to whitelist a range of IP's, you can use CIDR notation by assigned the appropriate prefix from the drop-down menu.

NOTES:

Please allow up to 60 minutes for your IP address to be fully whitelisted by our systems

Shared hosting providers typically use a different IP address (or range/pool) for outbound traffic.  You will want to speak with your server administrator to determine the correct address/range that needs to be whitelisted.

Server/Firewall Configuration

Your server/firewall will also need to be configured to allow for Outbound connections over TCP on ports 55000 and 55443 to our API server:

Production:  rr-n1-tor.opensrs.net

Test:  horizon.opensrs.net

Verify you server connection

You can verify your server is able to connect by running the following command from your server's command line:

telnet rr-n1-tor.opensrs.net 55000

You may receive one of 3 responses:

1) Connection timed out

This indicates that port 55000 has NOT been opened on your server/firewall.

2) <?xml version='1.0' encoding="UTF-8" standalone="no" ?><!DOCTYPE OPS_envelope SYSTEM "ops.dtd"><OPS_envelope> <header>  <version>0.9</version>  </header> <body>  <data_block>   <dt_assoc>    <item key="protocol">XCP</item>    <item key="response_text">Connection refused: invalid ip address [XXX.XXX.XXX.XXX]</item>    <item key="action">REPLY</item>    <item key="response_code">555</item>   </dt_assoc>  </data_block> </body></OPS_envelope>

This indicates that your IP address (listed in the response) is not whitelisted yet.  Please add this IP to your reseller account's access list, and wait 1 hour before trying again.

3) <?xml version='1.0' encoding="UTF-8" standalone="no" ?><!DOCTYPE OPS_envelope SYSTEM "ops.dtd"><OPS_envelope> <header>  <version>0.9</version>  </header> <body>  <data_block>   <dt_assoc>    <item key="protocol">XCP</item>    <item key="object">VERSION</item>    <item key="action">CHECK</item>    <item key="attributes">     <dt_assoc>      <item key="version">XML:0.1</item>      <item key="sender">OpenSRS SERVER</item>      <item key="state">ready</item>     </dt_assoc>    </item>   </dt_assoc>  </data_block> </body></OPS_envelope>

This response indicates that your connection was successful, and your server is correctly configured to access our API service.

Configuring the Opensrspro WHMCS Module

From the Domain Registrars section, click the "Configure" button beside Opensrspro.

TestUsername: <Your test environment username>

TestAPIKey: <Your test environment API Key> (different from your live key)

ProdUsername: <Your live environment username>

ProdAPIKey: <Your live environment API Key>

Hashkey: <enter a random string of characters. This is used to create strong passwords when provisioning domains and should never be changed once it is set as it is used to access previously registered domains.> *This field is optional

TestMode: <If checked, your test environment login details will be used>

The rest of the options are optional and can be activated as needed:

ForceForwardingIP: <Leave Unchecked>

ChangeLockedDomains: <Allow WHMCS to make changes to a domain automatically by unlocking and then locking the domain again>

LockTechContact: <Use the tech contact provided in RWI instead of what is entered into WHMCS>

GeneralError: <Enter a general error message users will see when there is an error.>

DisableTemplateChanges: <Enabling this will turn off changes to the template files>

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk