Revision as of 20:48, 27 October 2011

FreeRADIUS is the popular open source RADIUS server solution and is the most widely deployed RADIUS server in the world. It supports all common authentication protocols, and the server comes with a PHP-based web user administration tool, called dialupadmin. It is the basis for many commercial RADIUS products and services, like embedded systems, RADIUS appliances that support Network Access Control and WiMAX. (Description taken from http://en.wikipedia.org/wiki/FreeRADIUS)

Typically we find users of WHMCS utilising FreeRadius to offer Dial Up Internet & Broadband Services. And so an addon module has been created to integrate with FreeRadius that supports automatic account creations, suspensions, unsuspension, terminations, password resets and upgrading/downgrading of accounts on the FreeRadius Server. Usage stats for the current billing period are also displayed within the WHMCS client area.

Buying the Addon

The FreeRadius Addon Module is available for $150 and can be purchased via the link below.

https://www.whmcs.com/members/cart.php?a=add&pid=160

Installing & Using FreeRadius with WHMCS

Once you've purchased the FreeRadius addon, you will receive an email once activated directing you where to download the addon from. Once downloaded, the freeradius module folder simply needs to be uploaded to the /modules/servers/ folder of your WHMCS installation.

This FreeRadius module interfacts directly with the Radius database system and so once installed, you then need to go to Setup > Servers and create a server for the FreeRadius accounts entering the details as follows:

• Name - Anything you choose
• IP Address - SQL Hostname
• Server Type - Freeradius
• Username - SQL Username
• Password - SQL Password
• Access Hash - SQL Database Name

Next it's time to create a product, this is done under Setup > Products & Services as with any product in WHMCS. From there select the Add New Product option, specify a name, description & pricing, etc... all as desired, and then on the Module Settings tab, select the Freeradius module option and enter the Group Name defined in Radius to control the permissions/limitations of the account this product should setup.

That's all there is to it. You can then begin using the module in WHMCS as with any module, either manually invoking via the Module Command buttons displayed on a clients instance of the product, using the automated setup options of instantly upon order, after first payment or after manual admin review, and with the automated actions of overdue suspension, reactivations, late terminations, etc...