FreeRadius Addon Module - Revision history

SarahK: /* Activating FreeRadius Addon Module */

2022-04-22T19:01:57Z

‎Activating FreeRadius Addon Module

SarahK at 21:12, 16 March 2022

2022-03-16T21:12:11Z

SarahK at 20:37, 5 August 2020

2020-08-05T20:37:05Z

NickH: /* FAQ's */

2018-09-07T18:09:12Z

‎FAQ's

John: /* Installing & Using FreeRadius within WHMCS */

2016-10-06T10:03:28Z

‎Installing & Using FreeRadius within WHMCS

John: /* Installing & Using FreeRadius within WHMCS */

2016-10-06T10:02:56Z

‎Installing & Using FreeRadius within WHMCS

John: /* Installing & Using FreeRadius within WHMCS */

2016-10-06T10:02:20Z

‎Installing & Using FreeRadius within WHMCS

Chance at 18:28, 17 June 2015

2015-06-17T18:28:09Z

Chance at 18:27, 17 June 2015

2015-06-17T18:27:12Z

Chance at 18:02, 17 June 2015

2015-06-17T18:02:28Z

@@ Line 47: / Line 47: @@
 # In your WHMCS installation, create the '''/modules/servers/freeradius/''' directory.
 # Upload the addon files to the directory.
-# Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Servers''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Servers'''.
+# Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Servers]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Servers'''.
 # Create a server for the FreeRadius accounts using the following details:
 #*'''Name''' — A name for the server.

@@ Line 1: / Line 1: @@
-__TOC__
+== About this Addon Module ==
 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. Source: [http://en.wikipedia.org/wiki/FreeRADIUS Wikipedia:FreeRADIUS]
-Typically we find users of WHMCS utilizing FreeRadius to offer Dial Up Internet & Broadband Services. We have created an addon module to integrate with FreeRadius that supports the following:
+Typically, we find users of WHMCS utilizing FreeRadius to offer Dial Up Internet & Broadband Services. We have created an addon module to integrate with FreeRadius that supports the following:
 *account creation
@@ Line 15: / Line 16: @@
 The module will provision a new account to a specific group, but is not capable of provisioning an account with specific resources. You must define the resources for a given account on the FreeRADIUS system itself.
-==Buying the Addon==
+== Activating FreeRadius Addon Module ==
-The FreeRadius Addon Module is available for $150 and can be purchased via the link below.
+<div class="docs-alert-info"><i class="fa fa-info-circle"></i>
+This addon does not require activation at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Addon Modules]]''' or, prior to WHMCS 8.0, '''Setup > Addon Modules'''.
-  https://www.whmcs.com/members/cart.php?a=add&pid=160
+</div>
-−
+To do this:
-==Installing & Using FreeRadius within WHMCS==
+# [https://www.whmcs.com/members/cart.php?a=add&pid=160 Purchase the addon from WHMCS]. You will receive an email with a download link.
-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/freeradius/''' folder of your WHMCS installation (you will need to create this).
+# Download the files.
-This FreeRadius module interacts directly with the Radius database system and so once installed, you then need to go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Servers''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Servers'''. Create a server for the FreeRadius accounts entering the details as follows:
+==FAQs==
 #'''Does this module work with PostgreSQL?'''
@@ Line 99: / Line 117: @@
   */
 </source>

@@ Line 27: / Line 27: @@
 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/freeradius/''' folder of your WHMCS installation (you will need to create this).
-This FreeRadius module interacts directly with the Radius database system and so once installed, you then need to go to '''Setup > Products/Services > Servers''' and create a server for the FreeRadius accounts entering the details as follows:
+This FreeRadius module interacts directly with the Radius database system and so once installed, you then need to go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Servers''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Servers'''. Create a server for the FreeRadius accounts entering the details as follows:
 *'''Name''' - Anything you choose
@@ Line 36: / Line 36: @@
 *'''Access Hash''' - SQL Database Name
-Next it's time to create a product, this is done under '''Setup > Products/Services > Product/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.
+Next it's time to create a product, this is done under '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Products/Services''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Product/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...

@@ Line 55: / Line 55: @@
 #*The module will provision accounts and setup usernames based on the email address of the client. It will attempt to use the full email address as the username though if the username is already in use it will use the email address plus some numbers so each username is unique.
 #'''How can I sync the name and contact information between WHMCS and FreeRADIUS?'''
-#*This information can be synced between WHMCS and FreeRADIUS by uncommenting line 167 through line 173 of the module. This will allow the name and contact details of the client in WHMCS to sync over to the users FreeRADIUS account.
+#*This information can be synced between WHMCS and FreeRADIUS by locating and uncommenting the following code in the freeradius.php file. This will allow the name and contact details of the client in WHMCS to sync over to the users FreeRADIUS account.
 #'''How do I specify additional radius configuration parameters for new accounts?'''
-#*To apply additional radius parameters to new accounts, simply duplicate lines 153 to 159 in the freeradius.php file within the freeradius_CreateAccount function, adjusting the values given for the attribute, value and op in the MySQL query on the first of those lines as required for your additional configuration parameter.
+#*To apply additional radius parameters to new accounts, simply locate and uncomment the following code in the freeradius.php file, adjusting the values given for the attribute, value and op in the MySQL query on the first of those lines as required for your additional configuration parameter.

@@ Line 36: / Line 36: @@
 *'''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.
+Next it's time to create a product, this is done under '''Setup > Products/Services > Product/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...

@@ Line 25: / Line 25: @@
 ==Installing & Using FreeRadius within 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.
+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/freeradius/''' folder of your WHMCS installation (you will need to create this).
 This FreeRadius module interacts 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:
@@ Line 39: / Line 39: @@
 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...
 ==FAQ's==

@@ Line 1: / Line 1: @@
-__FORCETOC__
+__TOC__
-'''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.
+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. Source: [http://en.wikipedia.org/wiki/FreeRADIUS FreeRADIUS]
-(Description taken from http://en.wikipedia.org/wiki/FreeRADIUS)
 ==Buying the Addon==
@@ Line 12: / Line 23: @@
-==Installing & Using FreeRadius with WHMCS==
+==Installing & Using FreeRadius within 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.

← Older revision		Revision as of 18:02, 17 June 2015
Line 1:		Line 1:
		+	__FORCETOC__
	'''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.		'''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)		(Description taken from http://en.wikipedia.org/wiki/FreeRADIUS)