RADIUS
(New page: Starting with release v2.3 of Toolpack, explicit support for the accounting function of [http://en.wikipedia.org/wiki/RADIUS RADIUS] is now offered. Previously, Toolpack stored [[call ...) |
(cleaned up to new format) |
||
Line 1: | Line 1: | ||
− | + | Remote Authentication Dial In User Service, more popularly known as RADIUS, is used by telecom service providers for the purpose of authenticating, authorizing, and accounting for the use of services by subscribers. A RADIUS server is an application server that provides this functionality. It can take as input as well as output [[call detail record]] (CDR) data. | |
− | == Prerequisites == | + | |
+ | == TelcoBridges and RADIUS== | ||
+ | Starting with release [[Version 2.3|v2.3]] of [[Toolpack]], explicit support for the accounting function of RADIUS is now offered. Previously, Toolpack stored [[call detail record]] (CDR) data in a local database. Starting with Toolpack v2.3, CDR data is stored on a dedicated, external server running an implementation of the RADIUS standard. Configuration of the location of the RADIUS server is performed through the Toolpack web portal. For this initial release, Toolpack only supports the Accounting functionality of RADIUS; it does not support the Administration or Authentication options. That type of functionality can be performed outside of RADIUS using Toolpack.' | ||
+ | |||
+ | === Prerequisites === | ||
In order to enable this function in Toolpack v2.3, you must have a RADIUS server already up and running. It is highly recommended that the RADIUS server software being running on a separate machine from the one running the Toolpack software. Before configuring Toolpack, you will need the names and IP address of the RADIUS server. You will need to specify a ‘secret key’ which will authenticate the Toolpack server so that it can send CDR data to the RADIUS server and the RADIUS server will accept it. | In order to enable this function in Toolpack v2.3, you must have a RADIUS server already up and running. It is highly recommended that the RADIUS server software being running on a separate machine from the one running the Toolpack software. Before configuring Toolpack, you will need the names and IP address of the RADIUS server. You will need to specify a ‘secret key’ which will authenticate the Toolpack server so that it can send CDR data to the RADIUS server and the RADIUS server will accept it. | ||
− | == Steps == | + | === Steps === |
Assuming that you have already set up and configured a RADIUS server, you will now need to configure Toolpack. | Assuming that you have already set up and configured a RADIUS server, you will now need to configure Toolpack. | ||
Line 12: | Line 16: | ||
*Next, fill in the information in the '''RADIUS server parameters''' section. Please note that the '''port''' for the RADIUS Server must be set to 1813 (i.e., hostname:1813);. For the '''Server secret''' field, set it to the same authentication key that is configured on the RADIUS server. | *Next, fill in the information in the '''RADIUS server parameters''' section. Please note that the '''port''' for the RADIUS Server must be set to 1813 (i.e., hostname:1813);. For the '''Server secret''' field, set it to the same authentication key that is configured on the RADIUS server. | ||
− | == Testing this feature == | + | === Testing this feature === |
Testing this feature is as simple as activating the functionality in Toolpack and validating that CDR data is being properly received by the RADIUS server. If you have the ability to simulate calling data, you might find it worthwhile to gradually increase call volumes over time to identify and understand any limitations experienced with your RADIUS application server (see Known issues below for more on this.) | Testing this feature is as simple as activating the functionality in Toolpack and validating that CDR data is being properly received by the RADIUS server. If you have the ability to simulate calling data, you might find it worthwhile to gradually increase call volumes over time to identify and understand any limitations experienced with your RADIUS application server (see Known issues below for more on this.) | ||
− | == Known issues == | + | === Known issues === |
*There appears to be a limit to the rate and quantity at which RADIUS accepts CDRs. Using a copy of FreeRADIUS on Windows XP Server, we are currently working to determine the maximum rate that RADIUS accepts CDRs for that specific configuration. While it may not be broadly representative—it is an open source solution compared to commercial software solutions—it should provide us with a benchmark or order of magnitude. | *There appears to be a limit to the rate and quantity at which RADIUS accepts CDRs. Using a copy of FreeRADIUS on Windows XP Server, we are currently working to determine the maximum rate that RADIUS accepts CDRs for that specific configuration. While it may not be broadly representative—it is an open source solution compared to commercial software solutions—it should provide us with a benchmark or order of magnitude. | ||
*Our experience with FreeRADIUS to date has shown that by the time you attain 110 calls/second for a duration of 3 seconds, the buffer in Toolpack is soon overflowed. | *Our experience with FreeRADIUS to date has shown that by the time you attain 110 calls/second for a duration of 3 seconds, the buffer in Toolpack is soon overflowed. | ||
*Should RADIUS stop accepting CDRs (i.e., after a certain number per second (quantity / frequency)), Toolpack will then begin buffering to a maximum of 250 CDRs; over and above that buffer, Toolpack will drop CDR information | *Should RADIUS stop accepting CDRs (i.e., after a certain number per second (quantity / frequency)), Toolpack will then begin buffering to a maximum of 250 CDRs; over and above that buffer, Toolpack will drop CDR information | ||
+ | |||
+ | |||
+ | == References == | ||
+ | [http://en.wikipedia.org/wiki/RADIUS Wikipedia article] | ||
+ | |||
+ | |||
+ | [[category:Glossary]] |
Revision as of 12:23, 17 July 2009
Remote Authentication Dial In User Service, more popularly known as RADIUS, is used by telecom service providers for the purpose of authenticating, authorizing, and accounting for the use of services by subscribers. A RADIUS server is an application server that provides this functionality. It can take as input as well as output call detail record (CDR) data.
Contents |
TelcoBridges and RADIUS
Starting with release v2.3 of Toolpack, explicit support for the accounting function of RADIUS is now offered. Previously, Toolpack stored call detail record (CDR) data in a local database. Starting with Toolpack v2.3, CDR data is stored on a dedicated, external server running an implementation of the RADIUS standard. Configuration of the location of the RADIUS server is performed through the Toolpack web portal. For this initial release, Toolpack only supports the Accounting functionality of RADIUS; it does not support the Administration or Authentication options. That type of functionality can be performed outside of RADIUS using Toolpack.'
Prerequisites
In order to enable this function in Toolpack v2.3, you must have a RADIUS server already up and running. It is highly recommended that the RADIUS server software being running on a separate machine from the one running the Toolpack software. Before configuring Toolpack, you will need the names and IP address of the RADIUS server. You will need to specify a ‘secret key’ which will authenticate the Toolpack server so that it can send CDR data to the RADIUS server and the RADIUS server will accept it.
Steps
Assuming that you have already set up and configured a RADIUS server, you will now need to configure Toolpack.
- To configure RADIUS support in Toolpack, first go to Global > Gateway > Configurations. In the Configuration List, click on Create New Configuration. This is where you will create a RADIUS configuration.
- In the new configuration, click on Use CDR Behaviour. Up until now, this is the same approach you would use where CDRs are written to the Toolpack database.
- Now click on the CDR options section header, then click on Use RADIUS checkbox.
- Next, fill in the information in the RADIUS server parameters section. Please note that the port for the RADIUS Server must be set to 1813 (i.e., hostname:1813);. For the Server secret field, set it to the same authentication key that is configured on the RADIUS server.
Testing this feature
Testing this feature is as simple as activating the functionality in Toolpack and validating that CDR data is being properly received by the RADIUS server. If you have the ability to simulate calling data, you might find it worthwhile to gradually increase call volumes over time to identify and understand any limitations experienced with your RADIUS application server (see Known issues below for more on this.)
Known issues
- There appears to be a limit to the rate and quantity at which RADIUS accepts CDRs. Using a copy of FreeRADIUS on Windows XP Server, we are currently working to determine the maximum rate that RADIUS accepts CDRs for that specific configuration. While it may not be broadly representative—it is an open source solution compared to commercial software solutions—it should provide us with a benchmark or order of magnitude.
- Our experience with FreeRADIUS to date has shown that by the time you attain 110 calls/second for a duration of 3 seconds, the buffer in Toolpack is soon overflowed.
- Should RADIUS stop accepting CDRs (i.e., after a certain number per second (quantity / frequency)), Toolpack will then begin buffering to a maximum of 250 CDRs; over and above that buffer, Toolpack will drop CDR information