Difference between revisions of "DirectAdmin"

From WHMCS Documentation

(Adding a DirectAdmin Server)
Line 11: Line 11:
 
# Fill in the fields on the rest of the page details.  The username and password should be for a reseller user on your server to which your hosting packages belong.
 
# Fill in the fields on the rest of the page details.  The username and password should be for a reseller user on your server to which your hosting packages belong.
 
##A [https://https://docs.directadmin.com/directadmin/customizing-workflow/api-all-about.html#using-an-api-starting-point Login Key] can be used in place of the reseller password. Refer to [[#API_Token_Permissions|API Token Permissions]] to grant the required permissions.
 
##A [https://https://docs.directadmin.com/directadmin/customizing-workflow/api-all-about.html#using-an-api-starting-point Login Key] can be used in place of the reseller password. Refer to [[#API_Token_Permissions|API Token Permissions]] to grant the required permissions.
# The default port will be displayed. If your server is configured to communicate on a different port, tick the '''Override with Custom Port''' checkbox and enter it into the Port field. For more information refer to [[Server Port Overrides]].
+
# The default port will be displayed. If your server is configured to communicate on a different port, check '''Override with Custom Port''' and enter the correct port. For more information refer to [[Server Port Overrides]].
  
 
==Setting up your DirectAdmin Packages==
 
==Setting up your DirectAdmin Packages==
Line 67: Line 67:
  
 
===56 - Recv failure: Connection reset by peer===
 
===56 - Recv failure: Connection reset by peer===
Indicates the DirectAdmin server is requiring an SSL connection. Ticking the secure checkbox on the server configuration page will resolve this error ('''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Servers''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Servers'''.
+
Indicates the DirectAdmin server is requiring an SSL connection. Checking the secure checkbox on the server configuration page will resolve this error ('''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Servers''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Servers'''.
  
 
{{modules}}
 
{{modules}}

Revision as of 17:58, 17 December 2021

Supported Features

Create Suspend Unsuspend Terminate
Yes Yes Yes Yes
Change Package Change Password Usage Updates Client Area Link
Yes Yes Yes Yes

The following ports should be open for outbound connections from your WHMCS server: 2222

Adding a DirectAdmin Server

  1. Navigate to Configuration () > System Settings > Servers or, prior to WHMCS 8.0, Setup > Servers > Add New Server.
  2. Select Directadmin from the 'Type' dropdown menu
  3. Fill in the fields on the rest of the page details. The username and password should be for a reseller user on your server to which your hosting packages belong.
    1. A Login Key can be used in place of the reseller password. Refer to API Token Permissions to grant the required permissions.
  4. The default port will be displayed. If your server is configured to communicate on a different port, check Override with Custom Port and enter the correct port. For more information refer to Server Port Overrides.

Setting up your DirectAdmin Packages

For account creation to work successfully with DirectAdmin, you must have your packages setup in your DirectAdmin control panel. Here is how to setup hosting products in WHMCS to work with your DirectAdmin server.

  1. Setup the Hosting Package in WHMCS as normal (Configuration () > System Settings > Products/Services > Add New Product/Service or, prior to WHMCS 8.0, Setup > Products/Services > Add New Product/Service) entering a name, description, pricing and choosing the server type "Directadmin"
  2. Next, log into your Direct Admin Server. Once logged in, click Manage User Packages.
  3. You will then see a list of all your available packages. If you already have the package you are setting up in WHMCS setup in DirectAdmin then you can just copy the name from the list. If not, you will need to create it. Once the package is added, remember the package name shown in the Package column.
  4. Once you have this name, then go back to your WHMCS Admin Area and on the Module Settings tab of the Product Setup enter this Package Name exactly as it appears on the list in DirectAdmin above.

API Token Permissions

With API Tokens for DirectAdmin, it is possible to restrict what actions an API Token can perform. For WHMCS to be able to perform all the operations it supports, the following permissions are required:

CMD_API_PACKAGES_RESELLER CMD_API_PACKAGES_USER CMD_API_ADDITIONAL_DOMAINS
CMD_API_SHOW_ALL_USERS CMD_API_SHOW_USERS CMD_API_SHOW_RESELLERS
CMD_API_DNS_CONTROL CMD_API_DNS_MX CMD_API_FTP
CMD_API_SHOW_USER_CONFIG CMD_API_SYSTEM_INFO CMD_API_SHOW_RESELLER_IPS
CMD_API_ACCOUNT_USER CMD_SELECT_USERS CMD_API_USER_PASSWD
CMD_API_MODIFY_RESELLER CMD_API_MODIFY_USER CMD_API_SHOW_USER_USAGE
CMD_API_RESELLER_STATS

Common Problems

WHMCS Host Server IP is Blacklisted

The server on which WHMCS is installed is being blocked by DirectAdmin's security measures. Usually this is caused by invalid login credentials inside WHMCS at Configuration () > System Settings > Servers or, prior to WHMCS 8.0, Setup > Products/Services > Servers. Once the underlying cause has been resolved, remove the WHMCS server IP from /usr/local/directadmin/data/admin/ip_blacklist

56 - Recv failure: Connection reset by peer

Indicates the DirectAdmin server is requiring an SSL connection. Checking the secure checkbox on the server configuration page will resolve this error (Configuration () > System Settings > Servers or, prior to WHMCS 8.0, Setup > Products/Services > Servers.

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