RADIUS
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 Authorization or Authentication options. That type of functionality can be performed outside of RADIUS using Toolpack.
Starting with release v2.6 of Toolpack, multiple RADIUS servers can now be configured for backup purposes.
Prerequisites
In order to enable RADIUS functionality in Toolpack, 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 IP address of the RADIUS server(s). 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.
Configuration
Assuming that you have already set up and configured a RADIUS server, you also need to configure Toolpack.
Toolpack to Radius CDR attributes remapping
| AVP Id | Radius IETF param name | Type | Toolpack param | Description |
|---|---|---|---|---|
| 4 |
NAS-Identifier | string |
Application Name | Application name of the CDR provider |
| 2 |
Acct-Session-Id | integer |
Leg Id | Call Leg Identifier |
| 21 | Telcob-Other-Leg-Id | integer |
Other Leg Id | Call Leg Identifier of the other call leg joined with current call leg |
| 9 | Telcob-ChargeIndicator | string |
Charge indicator | Represent the charge indicator value |
| 5 |
Cisco-NAS-Port | string |
NAP name | Network Access Point name for the call leg |
| 7 |
Called-Sation-Id | string |
Called Number | Called party number |
| 6 |
Calling-Station-Id | string |
Calling Number | Calling party number |
| 10 |
h323-call-type | string |
Protocol Type | If protocol is SIP the value is "VOIP", otherwise it is "Telephony" |
| 17 |
h323-setup-time | string |
Start Time | Represent the call leg setup time - Coordinated Universal Time (UTC) |
| 8 |
h323-call-origin | string |
Originator Name | "answer" for an outgoing leg - "originate" for an incoming leg |
| 18 |
h323-connect-time | string |
Connected Time | Represent the call leg answer time (connect time) - Coordinated Universal Time (UTC) |
| 19 |
h323-disconnect-time | string |
EndTime | Represent the call leg disconnect time - Coordinated Universal Time (UTC) |
| 3 |
h323-conf-id | string |
Unique Id | Unique call identifier for the two initial legs (incoming and outgoing) - 128 bits integer formated as xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx |
| |
h323-incoming-conf-id | string |
Unique Id | Contains the original h323-conf-id in case of call transfer for subsequent outgoing legs - 128 bits integer formated as xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx |
| 1 |
User-Name | string |
- | For now this value is hardcoded to "100" |
| 30 |
h323-disconnect-cause | string |
Termination Reason | Q.931 disconnect (1 to 160) cause, TB Toolpack system cause (200 to 300) and SIP cause (400 to 600) |
| 115 | release-source | string |
Termination Source | "localLeg" if this leg terminate the call or "connectedLeg" if its the connected leg - We use a Cisco string field with our own value definition |
| 40 |
Acct-Status-Type | integer |
- | Start or Stop |
